Skills Guide
Defines required structure, frontmatter format, and best practices for SKILL.md files. Use BEFORE creating or editing any skill - this is the spec to follow, not optional reference.
Security Assessment
About Skills Guide
The Skills Guide is designed to package expertise into reusable, discoverable capabilities that extend Claude’s functionality. It provides a streamlined process for creating, sharing, and organizing modular instructions that Claude can activate autonomously based on context, without requiring any user interaction like slash commands. By incorporating a skill-building approach, users can automate repetitive tasks, streamline workflows, and ensure consistency across various projects. This skill-centric structure allows users to encapsulate their knowledge into easily sharable and accessible capabilities, maximizing productivity and reducing the need for repeated manual inputs.
The main features of the Skills Guide include the ability to define personal, project-based, and plugin skills. Personal skills can be used across all projects, making them ideal for individual tasks and personal productivity tools. Project skills, on the other hand, are designed for team collaboration and can be shared via git, enabling teams to access and contribute to shared workflows. Plugin skills, bundled with Claude Code plugins, are automatically available to users when the plugin is installed, adding an extra layer of extensibility. Skills are composed using markdown with YAML frontmatter, making them easily customizable and adaptable to different use cases. The inclusion of clear instructions and examples helps users implement the skills effectively.
This guide is perfect for anyone looking to automate tasks, create reusable workflows, or share expertise in a modular format. It is especially useful for teams collaborating on shared projects, individuals aiming to improve their productivity, or anyone looking to integrate advanced automation into their processes.
FAQ
What is the difference between personal, project, and plugin skills?
Personal skills are used across all projects and are ideal for individual workflows and personal tools. Project skills are shared with teams through git and are useful for team-specific workflows and shared expertise. Plugin skills come bundled with Claude Code plugins and are automatically available when the plugin is installed.
Can Skills be shared across different teams or projects?
Yes, project skills can be shared with your team through git. When team members pull the repository, they automatically get access to the shared skills.
What are the key requirements for writing a SKILL.md file?
Each SKILL.md file must include YAML frontmatter with the 'name' and 'description' fields. The description should clearly define what the skill does and when to use it. The file can also include optional fields like 'allowed-tools' to restrict which tools Claude can use.
How do I structure a complex Skill with supporting files?
For a complex skill, you can organize it with a main SKILL.md file and additional supporting files like FORMS.md, REFERENCE.md, EXAMPLES.md, and scripts. This keeps the SKILL.md file under 500 lines for performance while providing detailed instructions and references in the supporting files.
Are there any specific naming conventions I should follow when naming my skills?
Yes, it’s recommended to use the gerund form (verb + '-ing') when naming skills, such as 'Processing PDFs', 'Analyzing spreadsheets', or 'Writing documentation'. This helps clarify the skill’s function and makes it easily understandable.
Install Skills Guide
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
CaptainCrouton89/.claude