$ lexprog.com

// notes from an old coder -- php, databases, and the occasional rant

[October 26, 2026] Skills

Keep SKILL.md short: for Cursor Agent

Put the command and the footguns in the body. Move long references into references/. Put the skill where Cursor loads SKILL.md and keep the description searchable.

────────────────────────────────────────────────────────

Keep SKILL.md short: for Cursor Agent

Tip: Progressive disclosure

Put the command and the footguns in the body. Move long references into references/. Put the skill where Cursor loads SKILL.md and keep the description searchable.

Run `python3 scripts/generate_ai_posts.py | cargo run --bin import_expanded`.

Gotcha: A 30-page SKILL.md (for cursor agent)

The agent will miss the one command. Split files. A description that says helper will never be selected for a concrete task.

# Complete history of the importer

Source: https://docs.anthropic.com/en/docs/agents-and-tools/agent-skills

────────────────────────────────────────────────────────
<-- back to posts