Add agent skill for skills.sh, clean up AGENTS.md

- Add skills/markpdf/SKILL.md following the agentskills.io spec
  (name, description, license, compatibility, allowed-tools)
- CLAUDE.md symlinked to AGENTS.md (no duplication)
- README leads with npx skills add for agent users
- Trim AGENTS.md to essentials only

Made-with: Cursor

Author: araa47

Agents.md

@@ -1,30 +1,19 @@
-# Agent Development Guidelines
+# markpdf
 
-## Quick Start
+Markdown to PDF converter. `uv tool install git+https://github.com/araa47/markpdf`
 
-```bash
-uv sync --all-extras --dev    # Install deps
-uv run pytest                 # Run tests
-uv run markpdf input.md       # Run locally
-```
-
-## Project Structure
+## Dev
 
-```
-src/markpdf/
-  __init__.py    # Version
-  cli.py         # CLI entry point + async orchestration
-  parser.py      # Markdown tokenizer
-  renderer.py    # reportlab PDF builder
-  themes.py      # Light/dark theme tokens
-tests/
-  fixtures/      # Test markdown files + images
-  test_markpdf.py
+```bash
+uv sync --all-extras --dev
+uv run pytest
+uv run markpdf input.md
 ```
 
-## Conventions
+## Layout
 
-- **Use `uv` for all dependency management** (`uv add`, not `pip install`)
-- **Type annotations** on all functions
-- **Run `uv run pytest`** before committing
-- **Run pre-commit hooks**: `prek run --all-files`
+- `src/markpdf/cli.py` — typer CLI
+- `src/markpdf/parser.py` — markdown tokenizer
+- `src/markpdf/renderer.py` — reportlab PDF builder
+- `src/markpdf/themes.py` — light/dark tokens
+- `skills/markpdf/SKILL.md` — agent skill

CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md

README.md

@@ -2,47 +2,39 @@
 
 Agent-friendly markdown to PDF. Beautiful documents from the terminal.
 
-Perfect for AI agents that need to send humans formatted documents in chat where markdown rendering isn't supported (most messaging apps, email, Slack threads, etc).
+## Install as Agent Skill
 
-## Install
+```bash
+npx skills add araa47/markpdf
+```
+
+Or install the CLI directly:
 
 ```bash
-# Install from GitHub
 uv tool install git+https://github.com/araa47/markpdf
-
-# With uvloop for faster async (Linux/macOS)
-uv tool install "markpdf[fast]" --from git+https://github.com/araa47/markpdf
 ```
 
 ## Usage
 
 ```bash
-markpdf report.md                        # Light mode, creates report.pdf
-markpdf report.md --dark                  # Dark mode
-markpdf report.md -o final.pdf            # Custom output path
-markpdf report.md --keep-together         # Keep sections on same page
-markpdf report.md --dark -k -o out.pdf    # All options combined
-markpdf --help                            # Full docs
+markpdf report.md                        # creates report.pdf
+markpdf report.md --dark                  # dark mode
+markpdf report.md -o final.pdf            # custom output path
+markpdf report.md --keep-together         # keep sections on same page
+markpdf --help                            # full docs
 ```
 
+## Why
+
+Most messaging apps (Slack, Discord, Teams, WhatsApp, email) don't render markdown. When an AI agent needs to send a human a formatted document, it can convert markdown to a polished PDF and attach it instead.
+
 ## Features
 
-- **Beautiful output** — shadcn/ui-inspired zinc palette, clean typography
-- **Dark mode** — `--dark` flag for dark-themed PDFs
-- **Keep-together** — `--keep-together` tries to keep each section on one page
-- **Images** — local + remote (fetched concurrently via aiohttp)
+- **Beautiful output** — shadcn/ui zinc palette, clean typography
+- **Dark mode** — `--dark` for dark-themed PDFs
+- **Keep-together** — `-k` tries to keep each section on one page
+- **Images** — local + remote (fetched concurrently)
 - **Full markdown** — headers, bold, italic, code blocks, tables, lists, blockquotes, links, images, task lists, horizontal rules
 - **Extended syntax** — `==highlight==`, `^superscript^`, `~subscript~`, `~~strikethrough~~`
-- **Fast** — async I/O with optional uvloop acceleration
-- **Zero config** — just point at a `.md` file
-- **Rich CLI** — typer-powered `--help` with usage examples
-
-## For AI Agents
-
-Add to your agent's toolbox. One command, no config:
-
-```bash
-markpdf report.md -o report.pdf
-```
-
-Then attach `report.pdf` to the chat.
+- **Fast** — async I/O with optional uvloop
+- **Rich CLI** — typer-powered `--help`

skills/markpdf/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: markpdf
+description: Convert markdown to beautiful, styled PDFs with light/dark themes. Use when the user needs to send a formatted document in chat, email, or messaging where markdown rendering isn't supported. Converts .md files to .pdf with headers, code blocks, tables, images, and more.
+license: MIT
+compatibility:
+  - Claude Code
+  - Cursor
+  - Codex
+  - Gemini CLI
+allowed-tools: Bash(markpdf:*) Read Write
+---
+
+# markpdf
+
+Convert markdown files to styled PDFs.
+
+## Setup
+
+```bash
+uv tool install git+https://github.com/araa47/markpdf
+```
+
+## Usage
+
+```bash
+markpdf input.md                   # creates input.pdf
+markpdf input.md -o report.pdf     # custom output
+markpdf input.md --dark            # dark mode
+markpdf input.md -k                # keep sections on same page
+```