home/roleplay/claude-skill-md-format-complete-specification-guide

Claude Skill md Format Complete Specification Guide

GPTClaudeGemini··▲ 1,353 copies·updated 2026-07-14

claude-skill-md-format-complete-specification-guide.prompt

# From The Claude Code Playbook — claudecodeguides.com/playbook/


# Claude Skill .md Format: Complete Specification Guide

[Every Claude skill is a Markdown file](/best-claude-code-skills-to-install-first-2026/) The format is straightforward, but getting it wrong means your skill either fails silently or never fires. This guide covers every field and edge case.

What Is a Skill File?

A skill file is a plain Markdown document placed in `.claude/skills/` in your project (or `~/.claude/skills/` globally). Claude Code scans these directories and registers each `.md` file as a callable skill.

The format has two parts: [YAML front matter](/claude-skill-yaml-front-matter-parsing-error-fix/) between `---` delimiters, and a Markdown body that serves as the system prompt.

when to use it

Community prompt sourced from the open-source GitHub repo theluckystrike/claude-code-playbook (MIT). A "Claude Skill md Format Complete Specification Guide" style prompt — adapt the placeholders and specifics to your task. Imported as-is and not independently retested here, so check the output before relying on it.