| name | authoring-skills |
| description | Guides the creation of high-quality, effective skills for agentic workflows. Use when creating or modifying skills in the .agents/skills/ directory. |
Authoring Skills
When creating or modifying skills in this repository, follow these 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 the README.md in .agents/skills/ for instructions on how to run the linter locally.
- Progressive Disclosure: Use the patterns below to organize instructions effectively: