Skills
Skills are step-by-step procedural guides that live in .github/skills/. Each one teaches the agent (or a developer) how to perform a specific task correctly, following the progressive disclosure pattern: a concise SKILL.md under 200 lines plus detailed reference files.
How They Work Together
The agent and skills form a layered system:
- copilot-instructions.md — The routing document. Points the agent to the right skill or doc for any task.
- Skills — The procedural layer. Each skill is a step-by-step recipe for a specific task, with references for detailed field lists and examples.
- Docs — The deep-dive layer. Architecture, build system, content model, and API reference.
add-content
Create or edit content pages — Markdown files with YAML frontmatter for pages, blog posts, section indexes, and products.
add-template
Create or edit page templates — HTML files with tag placeholders that define page structure and layout.
add-component
Create or edit reusable UI components — TypeScript classes extending Component<T> invoked via template tags.
add-documentation
Create or edit developer documentation — internal reference docs in docs/ that explain how the system works.
add-product
Add or update a shop product — edit products.yaml, run build:sync to sync with Stripe, then customise the generated scaffold page.
build-and-test
Build the site, run tests, type-check, and lint. The core development loop for compiling Markdown to HTML.
create-skill
Meta-skill for creating new skills. Covers the progressive disclosure pattern, the 200-line SKILL.md rule, and bundled references.