dart-expert-skills: Instructions file for GitHub Copilot

Flutter Skills Repository - Copilot Instructions

Repository Overview

This is a comprehensive library of modular AI Skills for Flutter & Dart development. Each skill provides structured knowledge and expert-level guidance optimized for both LLM consumption and human readability.

Core Philosophy: Minimalist approach focusing on user experience over engineering abstractions. All code snippets are production-ready with zero placeholders. Latest stable package versions with explicit version documentation.

Architecture

Directory Structure

skills/
└── <skill-name>/
    ├── SKILL.md        # Entry point: Goals, Process, Constraints
    └── references/     # Detailed implementation guides (optional)

.agents/
└── skills/
    └── skill-creator/  # Meta-skill for creating and optimizing skills

Skill Structure

All skills follow a standardized format:

• YAML frontmatter: name, description (required), metadata.last_modified
• Description field: Acts as primary triggering mechanism for AI agents - includes both what the skill does AND specific contexts for when to use it
• Body sections: Goal, Process, Reference Documentation, Constraints
• Progressive disclosure: Keep SKILL.md under 500 lines; split larger content into references/ directory
• One-level-deep references only: All reference files must link directly from SKILL.md. Avoid SKILL.md → A.md → B.md chains — Claude may only partially read nested files
• Table of contents for long references: Any reference file exceeding 100 lines must include a ToC at the top so Claude can navigate without reading the entire file

Key Design Principles

1. Single Responsibility: Each skill focuses on one technology/framework
2. LLM-Optimized: Semantic headings, structured for AI context windows
3. Production-Ready: Working code snippets with latest stable versions
4. Version-Aware: All packages use latest stable versions (last updated 2026-03-31)
5. Concise is Key: The context window is shared. Every token in SKILL.md competes with conversation history and other skills. Default assumption: Claude is already very smart — only add context Claude doesn't already have. Challenge each paragraph: "Does Claude need this, or does it already know it?"