Document and standardize Claude Skill design with YAML frontmatter rules.
npx skills add https://github.com/tarrragon/ccsession --skill skill-design-guide
Please help me install this Agent Skill. Skill: skill-design-guide Source: https://github.com/tarrragon/ccsession/tree/main/.claude/skills/skill-design-guide Command: npx skills add https://github.com/tarrragon/ccsession --skill skill-design-guide
This guide standardizes the creation, review, and upkeep of Claude Skills by codifying official specifications, YAML frontmatter rules, and description-writing best practices to reduce ambiguity and risk.
Create a new skill directory named skill-name, add SKILL.md with the required frontmatter, and consult the references for deeper guidance on design patterns and pitfalls.
High-intent search queries and answers about installing and using this skill.
Required YAML frontmatter for Claude skills includes the name and description fields, with additional optional metadata for compatibility and licensing to ensure proper skill validation.
To standardize Claude skill creation, apply official design guidelines that prescribe consistent directory structures, YAML frontmatter validation rules, and progressive disclosure architecture to reduce ambiguity across projects.
Progressive disclosure architecture in skill design balances detail with token efficiency by structuring SKILL.md files to reveal deeper guidance and references only when needed during skill execution.
The Claude skill guide includes best-practice guidance for writing clear descriptions, troubleshooting common issues, and outlining safety considerations for both skill authors and reviewers.
You can use this guide to review skill quality by checking existing skills against the official frontmatter specifications, naming conventions, and safety guidelines outlined in the reference documentation.
When updating YAML frontmatter in older skills, limitations may arise if existing structures lack the required name and description fields or fail to align with current progressive disclosure and safety standards.
masa-codehubGenerate Gemini CLI agent skill scaffolds with SKILL.md templates.
huangcdScaffold Agent Skills with frontmatter templates and automated validation.
auldsyababuaValidate Markdown files for syntax, links, and formatting standards.
bketelsenCreate AI agent skills with SKILL.md files and index updates.
