Skills
Reusable instruction files for recurring tasks in this repo. Each skill is a single markdown file with YAML front matter that names it and describes when an AI agent should invoke it.
Available skills
| Skill | When to use |
|---|---|
| update-docs | Update or add a page under docs/content/ |
| package-extension | Build the .vsix via npm run package |
Layout
Skills live here as the canonical source. Symlinks in harness-specific directories make them auto-discoverable by popular AI coding harnesses without duplicating content:
| Harness | Path | Notes |
|---|---|---|
| Claude Code | .claude/skills/ | Symlinks to files in this directory |
| GitHub Copilot / awesome-copilot | .github/instructions/ | Symlinks to files in this directory |
When you add a skill, create the symlinks too:
bash
ln -s ../../skills/<skill>.md .claude/skills/<skill>.md
ln -s ../../skills/<skill>.md .github/instructions/<skill>.mdAuthoring
Front matter:
yaml
---
name: kebab-case-id
description: One-line summary an agent reads to decide whether the skill applies.
when_to_use: Concrete trigger phrases or situations.
---Body sections we use consistently:
- A short overview of what the skill produces or changes.
- Prerequisites, then the Steps as commands the agent can run.
- Troubleshooting for common failure modes.
- An Anti-patterns section describing what not to do — these prevent regressions when agents pattern-match from training data instead of from this repo.
Keep skills repo-specific. Generic agentic-engineering tips belong in AGENTS.md, not here.