Authoring Skills for Claude
Guides the creation of high-quality, effective skills for agentic workflows. Use when creating or modifying skills in the .agents/skills/ directory.
Install
one command, takes just this skill from the repositorynpx skills add https://github.com/flutter/devtools --skill authoring-skillsWhat comes with it
2 509 bytes besides the instructionThe instruction itself
2 sections, as written by the authorAuthoring Skills
When creating or modifying skills in this repository, follow these best practices:
- Antigravity Guidelines: Skill authoring best practices
- Anthropic Guidelines: Skill authoring best practices
Repository-Specific Guidelines
- Location: All skills must be placed in the
.agents/skills/directory. - Avoid Duplication: Before creating a skill, check if one already exists in the flutter/skills repository. If it does, do not create a local skill; instead, instruct the user to install it via
npx. - Naming: Use the gerund form (verb-ing-noun) or noun-phrase (e.g.,
authoring-skills,adding-release-notes). Use only lowercase letters, numbers, and hyphens. - Conciseness: Prioritize brevity in
SKILL.md. Agents are already highly capable; only provide context they don't already have. - Automation: Any utility scripts placed in the
scripts/directory MUST be written in Dart. - Validation: Skills are automatically validated using
dart_skills_lint. Ensure your skills pass the linter before submitting. See theREADME.mdin.agents/skills/for instructions on how to run the linter locally. - Progressive Disclosure: Use the patterns below to organize instructions effectively:
- CHECKLIST.md: Template for tracking skill development progress.
- EXAMPLES.md: Local examples and anti-patterns.
Other skills for the same job
different authors, same section of the catalogue
Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.
Replace with description of the skill and when Claude should use it.
Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies
This skill should be used when the user wants to "create a skill", "add a skill to plugin", "write a new skill", "improve skill description", "organize skill content", or needs guidance on skill structure, progressive disclosure, or skill development best practices for Claude Code plugins.
Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.
Use when creating new skills, editing existing skills, or verifying skills work before deployment
How to use it
Take flutter/authoring-skills from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.