Create production skill

Skill m00kk/agent-skills-playbook/skills/create-production-skill

Authors production-grade Agent Skills (SKILL.md) per agentskills.io: frontmatter, progressive disclosure, triggers, and validation. Use when creating a new agent skill, writing SKILL.md, or improving skill discovery in Cursor or Claude Code.From its SKILL.md

Install

npx -y skills add m00kk/agent-skills-playbook --skill create-production-skill

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

2.0 KB, 426 tokens by cl100k_base, as published. Nobody here has run it

Create Production Skill

Directory layout

skill-name/
├── SKILL.md          # Required (<500 lines)
├── references/       # Deep docs, loaded on demand
├── scripts/          # Optional CLIs
└── assets/           # Templates

Folder name must match name in frontmatter (lowercase, hyphens).

Frontmatter template

---
name: skill-name
description: >-
  [WHAT in third person]. Use when [triggers: files, verbs, products user mentions].
---

Description rules (discovery)

Third person: "Builds MCP servers…" not "I can build…"
Include trigger terms users and search engines use
Max ~1024 chars; specific beats broad

Body rules

Start with Workflow checklist agents can copy
Prefer commands and templates over prose
Link references/foo.md for anything >100 lines
One decision per section; default + escape hatch
No dates like "before 2025 use old API"

Progressive disclosure

## Additional resources
- Checklist: [references/checklist.md](references/checklist.md)

Instruct: "Read X only when Y" to save context tokens.

Optional scripts

Scripts must be safe, non-interactive, documented argv
Agent executes scripts; library code stays in project deps

Validation checklist

- [ ] name matches folder
- [ ] description has WHAT + WHEN + keywords
- [ ] SKILL.md < 500 lines
- [ ] No absolute paths or secrets
- [ ] Test: agent invokes /skill-name on realistic prompt

Anti-patterns

Vague name: helper, utils
Wiki dump in SKILL.md
Conflicting instructions with other installed skills

Install path: .cursor/skills/ (project) or ~/.cursor/skills/ (global).

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.