write-a-skill
Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.
Security Assessment
About write-a-skill
The 'write-a-skill' capability helps users create new agent skills by providing a clear and structured process. It focuses on ensuring skills are designed with proper structure, progressive disclosure, and bundled resources, making it easier for developers to build comprehensive and functional skills. This skill streamlines the creation of new functionalities, enabling users to add complex features in a consistent and organized manner.
FAQ
How do I begin using this skill?
Start by gathering requirements from the user, including the task/domain, use cases, and any reference materials. Then, draft the skill, ensuring it follows the correct structure.
What files are required for a new skill?
A basic skill requires a SKILL.md file for instructions, but you may also need REFERENCE.md, EXAMPLES.md, or utility scripts depending on the complexity of the skill.
When should I add utility scripts?
Add utility scripts when operations are deterministic, such as validation or formatting tasks, or when the same code is repeatedly generated.
How do I know when to split files for a skill?
Split the files if the SKILL.md exceeds 100 lines, or when the content is split across distinct domains, like different industries or contexts.
What should I include in the skill description?
The skill description should explain the capability provided by the skill, with a second sentence that specifies when or why the skill should be triggered.
Install write-a-skill
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
mattpocock/skills