Flutter Agent Skills

Welcome to the .agent/skills directory. This directory contains agent skills designed for consumption by Flutter contributors.

Requirements for New Skill Adoption

Before landing an initial skill in this shared codebase, the following requirements must be met:

1. Prior Usage: The skill must have been used by the author.
2. Target Audience: The skill must be explicitly designed for use by Flutter contributors.
3. Provide Examples: The pull request adding the skill must include examples of the prompts used with the skill, as well as the output generated by the agent/skill/bot.
4. Naming Conventions: The skill name must follow the established Claude naming conventions.
5. Standard Compliance: The skill must follow the open standard specification outlined at https://agentskills.io/specification.

Ownership and Responsibilities

• Ownership: The author of the skill holds ownership. This means the author is responsible for approving any modifications to the skill and mitigating any negative side effects.
• Succession: If the author can no longer maintain the skill, the author or their manager is responsible for finding a new owner.

Recommended Practices

We encourage contributors to follow these practices when authoring skills, though they are not strictly required:

• Provide Novel Information: Tell the agent what it needs to know, not what it already knows.
• One Skill Per CLI Tool: Create a dedicated skill for each CLI tool. This helps effectively steer the agent on how you want to use it.
• Structure and Rules: Be extremely strict about your style. The more structured and rule-based your instructions are (with a limited number of exceptions), the better. Agents have an exponential reward function for structure.
• Read-Only Mode: When appropriate, tell agents how to access real data strictly in read-only mode to prevent unintended changes.
• Dart Scripts: Scripts should be written in Dart.