skill-anatomy

About skill-anatomy

Comprehensive guide for understanding and fixing skill structure issues. Use this skill when skills aren't loading, when creating new skills, when organizing skills for open-source vs personal use, or when troubleshooting Claude Code skill discovery. Covers flat hierarchy requirement (each skill must be a direct child of .claude/skills/), required SKILL.md with YAML frontmatter containing name and description, and that the description is the primary trigger mechanism used to decide invocation. Provides concrete commands to create a new skill, reminder to restart Claude Code because skills load at startup, limits for the Markdown body, optional bundled resource folders, gitignore patterns, and the personal- prefix convention for local-only skills.

用于理解和修复技能结构问题的全面指南。当技能无法加载、创建新技能、为开源与个人使用组织技能，或排查 Claude Code 技能发现问题时使用。涵盖扁平层级要求（每个技能必须是 .claude/skills/ 的直接子目录）、必须包含 name 和 description 的 YAML frontmatter 的 SKILL.md、以及描述（description）是决定调用的主要触发机制。还提供创建新技能的具体命令、提醒因技能在启动时加载需重启 Claude Code、Markdown 正文长度限制、可选的打包资源文件夹、gitignore 模式，以及仅限本地使用技能的 personal- 前缀约定。