apply-anthropic-skill-best-practices — Claude Code skill for authoring skills
A skill that walks you through Anthropic's official skill-authoring rules while you build your own. Useful once a skill file grows past a few screens.
npx skills add NeoLabHQ/context-engineering-kit --skill apply-anthropic-skill-best-practices -a claude-codeWhat apply-anthropic-skill-best-practices does
This skill takes Anthropic's authoring guidance and applies it to whatever skill you are writing. It covers the two frontmatter fields, name (up to 64 characters) and description (up to 1024), and insists the description states both the action and the trigger. Write it in third person — the text is injected into the system prompt, and the wrong point of view breaks discovery.
Structure comes next. Keep the SKILL.md body under 500 lines and move material into separate files as you approach that. Name skills with a gerund: “Processing PDFs”, not “Helper”. At startup only the metadata loads; the body is read when the skill becomes relevant, so every extra token in it competes with the conversation.
Test on each model you expect to use. Guidance that is enough for a strong reasoning model may leave a smaller one without enough to go on. Install with npx skills add NeoLabHQ/context-engineering-kit --skill apply-anthropic-skill-best-practices -a claude-code; the file lands at ~/.claude/skills/apply-anthropic-skill-best-practices/SKILL.md. If that path is empty afterwards, the skill will not fire — check it.
What it helps with
- write a
descriptionthat gets the right skill selected - split an oversized
SKILL.mdinto linked files - pick consistent names across a skill collection
- check a skill against both small and large models
Example prompts for the agent
- Review my
SKILL.mdagainst Anthropic's authoring rules and fix the description - This skill body is over 500 lines — propose which parts to move into separate files
- Suggest a name and
descriptionfor a skill that cleans up log files
How to install apply-anthropic-skill-best-practices
1Skills CLI (Vercel)
npx skills add NeoLabHQ/context-engineering-kit --skill apply-anthropic-skill-best-practices -a claude-code2Manually: put the files in place
~/.claude/skills/apply-anthropic-skill-best-practices/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/apply-anthropic-skill-best-practices/
1Skills CLI (Vercel)
npx skills add NeoLabHQ/context-engineering-kit --skill apply-anthropic-skill-best-practices -a codex2Manually: put the files in place
.agents/skills/apply-anthropic-skill-best-practices/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add NeoLabHQ/context-engineering-kit --skill apply-anthropic-skill-best-practices -a cursor2Manually: put the files in place
.cursor/skills/apply-anthropic-skill-best-practices/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install NeoLabHQ/context-engineering-kit apply-anthropic-skill-best-practices2Manually: put the files in place
.github/skills/apply-anthropic-skill-best-practices/SKILL.md1Skills CLI (Vercel)
npx skills add NeoLabHQ/context-engineering-kit --skill apply-anthropic-skill-best-practices -a gemini-cli2Platform CLI
gemini skills install https://github.com/NeoLabHQ/context-engineering-kit --path skills/apply-anthropic-skill-best-practicesManually: put the files in place
.devin/skills/apply-anthropic-skill-best-practices/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add NeoLabHQ/context-engineering-kit --skill apply-anthropic-skill-best-practices -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about apply-anthropic-skill-best-practices
How do I install apply-anthropic-skill-best-practices in Claude Code?
Run npx skills add NeoLabHQ/context-engineering-kit --skill apply-anthropic-skill-best-practices -a claude-code, then confirm the skill file exists at ~/.claude/skills/apply-anthropic-skill-best-practices/SKILL.md.
What does apply-anthropic-skill-best-practices do?
It applies Anthropic's official skill-authoring practices to the skill you are writing: metadata, SKILL.md layout, naming, and model testing.
How long should a SKILL.md be?
The skill advises keeping the body below 500 lines and splitting content into separate files when you near that, since those files load only when needed.