claude-code-skills

To create a Claude Code agent skill, you start by creating a SKILL.md file with required frontmatter metadata, specifically a concise name and description, and optionally add reference files or scripts as needed.

The required YAML metadata for a SKILL.md file includes a name and description in the frontmatter. This ensures the Claude Code agent can properly identify and apply the skill across different scenarios.

If your Claude Code skill is not working, troubleshoot by checking the SKILL.md frontmatter for required name and description fields, verifying file structure, and ensuring safe tool restrictions are properly configured.

Best practices for distributing Claude Code skills involve maintaining a clear file structure with optional references and scripts, enforcing safe tool restrictions, and following recommended design and maintenance guidelines for organizational use.

Yes, you can add optional reference files, scripts, and assets to a Claude Code skill. The SKILL.md file serves as the core, while these additional files support the skill's functionality and documentation.

The best way to structure a Claude Code skill for an organization is to enforce required SKILL.md frontmatter, utilize optional references and scripts, and apply safe tool restrictions to ensure secure and maintainable skill distribution.