sample-skill
A minimal, spec-compliant example skill used as a starting template. Use when someone needs a clean skeleton for authoring a new skill, or when demonstrating the SKILL.md format and its optional resources.
Install
npx skills add https://github.com/Xwh630/ai-agent-handbook/tree/main/examples/10-agent-skill/sample-skill
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install xwh630-ai-agent-handbook@llmmart
git clone https://github.com/Xwh630/ai-agent-handbook.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole xwh630/ai-agent-handbook collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
Sample Skill
A deliberately minimal template. Copy this directory, rename it, and replace
every field — then run the validator from examples/10-agent-skill/ before
publishing.
What this template demonstrates
- Required frontmatter fields (
name,description) - Optional fields (
license,metadata) - All three optional resource directories (
scripts/,references/,assets/) - A description that states both what it does and when to use it
Workflow
- Read
assets/template.mdfor the output skeleton. - If the request involves counting or formatting, run
scripts/count_words.pyrather than doing it in your head — it is exact and costs no context. - Only consult
references/rules.mdwhen you hit an edge case.
Edge cases
- Empty input → return an empty result, do not invent content.
- Input larger than the task needs → summarize rather than echoing it back.
Files (ai-agent-handbook)
-
assets
-
template.md 205 B
Loading…
-
-
references
-
rules.md 817 B
Loading…
-
-
scripts
-
count_words.py 1.2 KB
Loading…
-
-
SKILL.md 1.2 KB
--- name: sample-skill description: > A minimal, spec-compliant example skill used as a starting template. Use when someone needs a clean skeleton for authoring a new skill, or when demonstrating the SKILL.md format and its optional resources. license: MIT metadata: author: Xwh630 version: "1.0" --- # Sample Skill A deliberately minimal template. Copy this directory, rename it, and replace every field — then run the validator from `examples/10-agent-skill/` before publishing. ## What this template demonstrates - Required frontmatter fields (`name`, `description`) - Optional fields (`license`, `metadata`) - All three optional resource directories (`scripts/`, `references/`, `assets/`) - A description that states **both** what it does and when to use it ## Workflow 1. Read `assets/template.md` for the output skeleton. 2. If the request involves counting or formatting, **run `scripts/count_words.py`** rather than doing it in your head — it is exact and costs no context. 3. Only consult `references/rules.md` when you hit an edge case. ## Edge cases - Empty input → return an empty result, do not invent content. - Input larger than the task needs → summarize rather than echoing it back.
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.