authoring-skills

# Authoring Skills When creating or modifying skills in this repository, follow these best practices: - **Antigravity Guidelines**: [Skill authoring best practices](https://antigravity.google/docs/skills) - **Anthropic Guidelines**: [Skill authoring best practices](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/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](https://github.com/flutter/skills/tree/main/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: - [CHECKLIST.md](CHECKLIST.md): Template for tracking skill development progress. - [EXAMPLES.md](EXAMPLES.md): Local examples and anti-patterns.