Define canonical SKILL.md frontmatter and structure for skill repositories.
npx skills add https://github.com/otto-assistant/bridge --skill new-skill-otto-assistant
Please help me install this Agent Skill. Skill: new-skill Source: https://github.com/otto-assistant/bridge/tree/main/cli/skills/new-skill Command: npx skills add https://github.com/otto-assistant/bridge --skill new-skill-otto-assistant
This guide codifies how to write a SKILL.md so AI agents can discover, load, and execute skills reliably by enforcing a consistent frontmatter and structure across repositories.
Create a new SKILL.md following this structure and place it at skills/<skill-name>/SKILL.md.
High-intent search queries and answers about installing and using this skill.
The required SKILL.md frontmatter structure includes a name and description field to enable agent discoverability and correct loading. The Markdown body provides implementation guidance, usage patterns, and best practices.
To organize skills for discoverability, place each skill in a dedicated directory at skills/<skill-name>/SKILL.md under the repository root. This canonical structure ensures agents can reliably discover and load the skill.
The SKILL.md markdown body should describe usage patterns, best practices, and any required or optional resources. It provides actionable implementation guidance that complements the required name and description frontmatter.
Yes, a skill can declare optional companion directories including scripts/, references/, and assets/ if present. These directories store supplementary resources that the Markdown body can link to for implementation guidance.
An agent fails to load a repository skill when the SKILL.md lacks the canonical frontmatter schema or is misplaced outside the skills/<skill-name>/SKILL.md path, preventing reliable discovery and execution.
Yes, if a repository stores skills under a top-level skills/ folder, each skill must use a dedicated SKILL.md file at skills/<skill-name>/SKILL.md to ensure correct discovery and loading by the agent.
RyanJarvGenerate Claude Code Skill directories with YAML frontmatter validation.
nicholasgriffintnCreate and validate SKILL.md files with YAML frontmatter for OpenCode or Claude.
ruiming2aiInitialize and customize AI skill templates with frontmatter and Markdown instructions.
LiorCohenMaintain SDD plugin documentation with frontmatter-driven metadata and markdown structure.
