Reusable Task Prompts

Standalone, copy-paste task recipes the agent (or a human) can run for common, repeatable jobs in this repo. Each prompt is a self-contained .md file with step-by-step instructions.

Structure

prompts/
├── <category>/
│   ├── <prompt-name>.md

SKILL.md VS Prompts

While both provide instructions for AI agents, they differ in purpose and how they are triggered:

• Skills (SKILL.md): Active capabilities loaded automatically by the agent on-demand when user intent matches the skill's description. They provide technical patterns, guidelines, and domain expertise. The skill description from frontmatter is always attached within the context of the agent. (e.g., react-aria, api-integration).
• Prompts (.md): Passive recipes invoked manually by the user or agent for specific jobs. They are linear, step-by-step task briefs. Prompt gets loaded into the context whenever explicitly invoked. (e.g., add-page, change-branding).

When to Use

• The user names a common task (e.g. "add a new page", "change branding").
• You want a consistent, repeatable workflow instead of improvising.
• The change is mechanical enough to be scripted but still needs judgement.
• Won't worth adding into skills (e.g. too specific, too simple, etc).

Categories

Authoring a New Prompt

1. Drop a <task-name>.md into the right category folder.
2. Open with a clear # Task: <verb + object> heading.
3. Force input gathering first (Step 0) - never assume.
4. Number steps in order; keep them imperative and verifiable.
5. End with a verification step the user can confirm.