authoring-skills

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:

• 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 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: Template for tracking skill development progress.
  • EXAMPLES.md: Local examples and anti-patterns.