podlite-skills

<div align="center">

[![Podlite](https://github.com/podlite/podlite-skills/raw/main/assets/podlite_logo_ai_256x256.png)](https://podlite.org)

</div>

# Podlite Skills

> Your AI writes Markdown. Teach it something better.

[![GitHub Stars](https://img.shields.io/github/stars/podlite/podlite-skills?style=social)](https://github.com/podlite/podlite-skills)

One command. Works with [Claude Code](https://claude.ai/code), [Codex CLI](https://github.com/openai/codex), [Cursor](https://cursor.sh), [GitHub Copilot](https://github.com/features/cursor), and [35+ AI agents](https://skills.sh):

```bash
npx skills add podlite/podlite-skills
```

**Why?** Markdown loses structure when AI generates it — mismatched indentation, broken nesting, no typed attributes. Podlite gives your AI explicit block boundaries and machine-readable attributes that survive copy-paste and context loss.

⭐ **Found this useful? [Star the repo](https://github.com/podlite/podlite-skills)** — it helps others discover it.

## Skills

| Skill | Description |
|-------|-------------|
| [podlite-markup](skills/podlite-markup/SKILL.md) | Create and edit Podlite markup — docs, specs, ideas, structured content |

## Installation

### skills.sh (recommended)

One command, [35+ agents](https://skills.sh):

```bash
npx skills add podlite/podlite-skills
```

### Claude Code (manual)

```bash
cp -r skills/ /path/to/your/project/.cursor/skills/
```

### Codex CLI

```bash
cp -r skills/ ~/.codex/skills/
```

### Other tools

Drop `SKILL.md` where your agent looks for skills. See [agentskills.io/specification](https://agentskills.io/specification).

## What is Podlite?

Podlite is a markup language that reads like Markdown but has real structure — block boundaries, typed attributes, inline formatting. Think Markdown that machines can actually parse.

```raku
=begin pod :type('page') :tags<tutorial>
=TITLE My Document

=head1 Introduction

Podlite is B<readable> like Markdown but I<structured> like YAML.

=item Human-