agent-skills-guide

To create Claude Code Agent Skills, you draft a structured SKILL.md file with required YAML frontmatter, outline field requirements, and place supporting files like scripts and references in the correct directories for reliable discovery and safe operation.

The best way to structure a SKILL.md file is to follow standard naming conventions and field requirements, ensuring you include clear step-by-step instructions and best practices for reliable activation within Claude Code.

Supporting files like scripts, references, and assets should be placed in designated directories alongside your SKILL.md file to ensure proper discovery and safe operation of your Claude Code Agent Skills.

Managing YAML frontmatter in agent skills requires basic familiarity with key-value configuration formats, but the guide provides step-by-step instructions and validation tips suitable for onboarding new teammates.

Claude Code discovers and activates custom skills by applying documented discovery rules and validation checks against your SKILL.md file structure, ensuring the required YAML frontmatter and field requirements are correctly met.

Yes, you can use this guide to onboard teammates by providing a practical workflow for adding, managing, and maintaining both personal and project-level Claude Code Agent Skills.