chore: rename skills and add optimisation of agent

Author: AhmedAmineZr

.github/copilot-instructions.md

@@ -9,11 +9,11 @@ Load the appropriate skill before acting on the related task:
 
 | Task | Skill to load |
 |------|---------------|
-| Ask about or explain OUDS-specific terms (Tokenator, token, raw token, semantic token, component token, theme, …) | `ouds-vocabulary` |
-| Write or review Dart / Flutter code that uses OUDS components, themes or tokens | `ouds-framework-usage` |
-| Translate a Figma token name or token family into its Dart equivalent | `ouds-figma-to-flutter` |
-| Migrate code between OUDS Flutter versions, adopt OUDS from native or custom Flutter components, or remove deprecated APIs | `ouds-migration-guide` |
-| Implement or review accessibility (Semantics, screen readers, text scale, high-contrast, orientation) | `ouds-accessibility` |
+| Ask about or explain OUDS-specific terms (Tokenator, token, raw token, semantic token, component token, theme, …) | `ouds-flutter-vocabulary` |
+| Write or review Dart / Flutter code that uses OUDS components, themes or tokens | `ouds-flutter-framework-usage` |
+| Translate a Figma token name or token family into its Dart equivalent | `ouds-flutter-figma-to-dart` |
+| Migrate code between OUDS Flutter versions, adopt OUDS from native or custom Flutter components, or remove deprecated APIs | `ouds-flutter-migration-guide` |
+| Implement or review accessibility (Semantics, screen readers, text scale, high-contrast, orientation) | `ouds-flutter-accessibility` |
 
 Skills are located in `skills/<name>/SKILL.md` (treat this folder as the source of truth; keep the copies under `.claude/skills/` and `.opencode/skills/` in sync).
 ## 1. Code formatting
@@ -119,7 +119,7 @@ Demo application "Design System Toolbox" showcasing all components and tokens in
 - If a third-party dependency is added or updated, document it in `THIRD_PARTY.md`
 - Use `OudsTheme.of(context)` to read all colors, spacing, typography and component tokens
 - Use `OudsLocalizations.of(context)` or app localizations for user-facing strings
-  - When introducing breaking changes or API modifications, update `MIGRATION.md` at the root of the repository and `skills/ouds-migration-guide/SKILL.md` accordingly
+  - When introducing breaking changes or API modifications, update `MIGRATION.md` at the root of the repository and `skills/ouds-flutter-migration-guide/SKILL.md` accordingly
 
 ### 4.2 DON'T
 
@@ -137,7 +137,7 @@ Demo application "Design System Toolbox" showcasing all components and tokens in
 
 Everything is available on [Orange accessibility guidelines](https://a11y-guidelines.orange.com/fr/mobile/).
 
-> Load the **`ouds-accessibility`** skill for the full reference with code examples, Semantics patterns, high-contrast, TalkBack/VoiceOver and the complete testing checklist.
+> Load the **`ouds-flutter-accessibility`** skill for the full reference with code examples, Semantics patterns, high-contrast, TalkBack/VoiceOver and the complete testing checklist.
 
 ### 5.1 Components
 
@@ -233,4 +233,38 @@ cd ouds_core && dart doc
 - [ ] Demo screen registered in `app/lib/ui/components/components.dart`
 - [ ] Commit message follows [Conventional Commits](https://www.conventionalcommits.org/) (`feat:`, `fix:`, `doc:`, `chore:`, `test:`)
 - [ ] `MIGRATION.md` updated if any public API has changed or been deprecated
-- [ ] `skills/ouds-migration-guide/SKILL.md` updated to reflect any new migration steps
+- [ ] `skills/ouds-flutter-migration-guide/SKILL.md` updated to reflect any new migration steps
+
+## 9. Agent response optimization 🚀
+
+When using GitHub Copilot for code reviews, refactoring, or documentation updates, minimize token consumption:
+
+### Key principles
+
+- **Batch operations**: Combine multiple file edits into single calls; parallelize `grep_search` and `file_search`
+- **Skip verbose narrative**: Avoid acknowledgments and filler ("Sounds good!", "Let me now..."); use single-line summaries
+- **Compress output**: Use tables/checklists instead of prose; reference line numbers instead of repeating content
+- **Front-load context**: Gather all research upfront before proposing changes; use `run_subagent` for large searches
+- **Minimize reads**: Read files once with adequate ranges; use search filters to avoid irrelevant files
+
+### Response template (optimized)
+
+```
+**[Action summary — 1 line]**
+
+### Changes
+[Table or checklist of modifications]
+
+### Verification
+[Brief grep/status check results]
+```
+
+**Target**: 150–300 tokens per response (50–60% reduction vs. standard approach).
+
+### When to delegate to subagent
+
+Use `run_subagent` when:
+- Search scope involves 50+ files
+- Result set would exceed 500 tokens
+- Task requires multiple sequential searches
+

AGENTS.md

@@ -18,11 +18,11 @@ Target platforms: Android API 21+, iOS 13+. Language: Dart 3.9+ / Flutter 3.35+.
 
 Load skills on demand for detailed guidance:
 
-- **`ouds-vocabulary`** — glossary of OUDS-specific terms (Tokenator, token types, theme, …)
-- **`ouds-framework-usage`** — full usage reference: imports, themes, tokens, localizations, all components with code examples
-- **`ouds-figma-to-flutter`** — how to derive a Dart token name from a Figma token path (raw, semantic and component tokens)
-- **`ouds-migration-guide`** — adopt OUDS from native Flutter or custom components, migrate between OUDS versions, before/after mappings
-- **`ouds-accessibility`** — Semantics patterns, text scale, high-contrast, TalkBack / VoiceOver, orientation and full testing checklist
+- **`ouds-flutter-vocabulary`** — glossary of OUDS Flutter-specific terms (Tokenator, token types, theme, …)
+- **`ouds-flutter-framework-usage`** — full OUDS Flutter usage reference: imports, themes, tokens, localizations, all components with code examples
+- **`ouds-flutter-figma-to-dart`** — how to derive Dart naming and token layer from Figma token families for the OUDS Flutter project (raw, semantic and component tokens)
+- **`ouds-flutter-migration-guide`** — adopt OUDS Flutter from native Flutter or custom components, migrate between OUDS Flutter versions, before/after mappings
+- **`ouds-flutter-accessibility`** — OUDS Flutter Semantics patterns, text scale, high-contrast, TalkBack / VoiceOver, orientation and full testing checklist
 
 ## Key files
 
@@ -37,15 +37,15 @@ Load skills on demand for detailed guidance:
 
 ## Critical rules
 
-- Always load the **`ouds-vocabulary`** skill before discussing tokens or themes.
-- Always load the **`ouds-framework-usage`** skill before writing or reviewing code that uses OUDS components or tokens.
-- Always load the **`ouds-figma-to-flutter`** skill when asked to find or map a Figma token name to its Dart equivalent.
-- Always load the **`ouds-migration-guide`** skill when asked to migrate code, adopt OUDS in an existing app, replace native/custom Flutter components with OUDS equivalents, or remove deprecated APIs.
-- Always load the **`ouds-accessibility`** skill when asked about Semantics, screen readers, TalkBack, VoiceOver, text scale, high-contrast or orientation.
+- Always load the **`ouds-flutter-vocabulary`** skill before discussing tokens or themes.
+- Always load the **`ouds-flutter-framework-usage`** skill before writing or reviewing code that uses OUDS components or tokens.
+- Always load the **`ouds-flutter-figma-to-dart`** skill when asked to find or map a Figma token name to its Dart equivalent.
+- Always load the **`ouds-flutter-migration-guide`** skill when asked to migrate code, adopt OUDS in an existing app, replace native/custom Flutter components with OUDS equivalents, or remove deprecated APIs.
+- Always load the **`ouds-flutter-accessibility`** skill when asked about Semantics, screen readers, TalkBack, VoiceOver, text scale, high-contrast or orientation.
 - Before committing: `dart format .` → `flutter analyze --no-pub` → fix all errors → `flutter test` in every modified package (see `.github/copilot-instructions.md §7`).
 - **Never** create or edit token files in `ouds_global_raw_tokens`, `ouds_theme_contract`, `ouds_theme_orange`, `ouds_theme_orange_compact`, `ouds_theme_sosh`, or `ouds_theme_wireframe` — all content is generated by Tokenator.
 - **Never** create a root barrel file for `ouds_core` — import components directly (e.g. `package:ouds_core/components/button/ouds_button.dart`).
-- When introducing a breaking change or deprecation: update **both** `MIGRATION.md` **and** `skills/ouds-migration-guide/SKILL.md`.
+- When introducing a breaking change or deprecation: update **both** `MIGRATION.md` **and** `skills/ouds-flutter-migration-guide/SKILL.md`.
 - Use `OudsTheme.of(context)` for all colors, spacing, typography and component tokens — never hardcode values.
 - Use `OudsLocalizations.of(context)` for all user-facing and accessibility strings — never hardcode them.
 - Prefix all OUDS widgets with `Ouds` (e.g. `OudsButton`, `OudsTag`).

skills/ouds-accessibility/SKILL.md …ills/ouds-flutter-accessibility/SKILL.mdskills/ouds-accessibility/SKILL.md renamed to skills/ouds-flutter-accessibility/SKILL.md skills/ouds-accessibility/SKILL.md renamed to skills/ouds-flutter-accessibility/SKILL.md

@@ -1,10 +1,14 @@
 ---
-name: ouds-accessibility
-description: Accessibility (a11y) rules and patterns for OUDS Flutter components — Semantics, MergeSemantics, ExcludeSemantics, text scale, high-contrast, screen readers (TalkBack / VoiceOver), orientation, bug diagnosis and enhancement patterns
+name: ouds-flutter-accessibility
+description: Reference guide for OUDS Flutter accessibility rules and patterns — Semantics, MergeSemantics, ExcludeSemantics, text scale, high-contrast, screen readers (TalkBack / VoiceOver), orientation, bug diagnosis and enhancement
 license: MIT
 ---
 
-# OUDS Accessibility Guide
+# OUDS Flutter Accessibility Guide
+
+> **Agent optimization**: See [copilot-instructions.md §9](../../.github/copilot-instructions.md#9-agent-response-optimization-) for token-efficient response guidelines.
+
+This skill applies to accessibility work in the OUDS Flutter repository. Use it for Flutter widgets and semantics patterns, not for OUDS web, Android native, or iOS native platforms.
 
 Use this skill when a user asks about:
 
@@ -700,3 +704,4 @@ Semantics(
 ```
 
 ---
+

skills/ouds-figma-to-flutter/SKILL.md …ills/ouds-flutter-figma-to-dart/SKILL.mdskills/ouds-figma-to-flutter/SKILL.md renamed to skills/ouds-flutter-figma-to-dart/SKILL.md skills/ouds-figma-to-flutter/SKILL.md renamed to skills/ouds-flutter-figma-to-dart/SKILL.md

@@ -1,10 +1,14 @@
 ---
-name: ouds-figma-to-flutter
-description: How to derive the Flutter token layer and likely Dart naming from a Figma token family in the OUDS Flutter project (raw, semantic and component tokens)
+name: ouds-flutter-figma-to-dart
+description: Reference guide for deriving Dart naming and token layer from Figma token families in the OUDS Flutter project (raw, semantic and component tokens)
 license: MIT
 ---
 
-# Skill: ouds-figma-to-flutter
+# OUDS Flutter Figma-to-Dart Mapping
+
+> **Agent optimization**: See [copilot-instructions.md §9](../../.github/copilot-instructions.md#9-agent-response-optimization-) for token-efficient response guidelines.
+
+This skill applies to token mapping in the OUDS Flutter repository. Use it when translating Figma tokens to Flutter/Dart naming, not for OUDS web, Android native, or iOS native platforms.
 
 ## 1. Quick-reference cheat sheet
 

skills/ouds-framework-usage/SKILL.md …ls/ouds-flutter-framework-usage/SKILL.mdskills/ouds-framework-usage/SKILL.md renamed to skills/ouds-flutter-framework-usage/SKILL.md skills/ouds-framework-usage/SKILL.md renamed to skills/ouds-flutter-framework-usage/SKILL.md

@@ -1,10 +1,14 @@
 ---
-name: ouds-framework-usage
+name: ouds-flutter-framework-usage
 description: How to set up and use the OUDS Flutter framework with imports, themes, tokens, localizations, theme tweaks, and available components with code examples
 license: MIT
 ---
 
-# OUDS Framework Usage
+# OUDS Flutter Framework Usage
+
+> **Agent optimization**: See [copilot-instructions.md §9](../../.github/copilot-instructions.md#9-agent-response-optimization-) for token-efficient response guidelines.
+
+This skill applies to the OUDS Flutter repository. Use it for Flutter components, themes, tokens and localizations, not for OUDS web, Android native, or iOS native platforms.
 
 ## 1. Basic setup
 
@@ -305,7 +309,7 @@ final l10n = OudsLocalizations.of(context);
 
 ### Accessibility
 
-> Load the **`ouds-accessibility`** skill for the full a11y reference (Semantics patterns, text scale, high-contrast, TalkBack/VoiceOver, testing checklist).
+> Load the **`ouds-flutter-accessibility`** skill for the full a11y reference (Semantics patterns, text scale, high-contrast, TalkBack/VoiceOver, testing checklist).
 
 Key reminders:
 - Wrap every interactive root in `Semantics` with appropriate flags (`button`, `checked`, `toggled`, `label`, `hint`, `value`)
@@ -694,4 +698,5 @@ cd ouds_core && flutter gen-l10n
 
 - [ ] Component tested with all 4 themes: **Orange**, **Orange Compact**, **Sosh**, **Wireframe**
 - [ ] Component tested in **light** and **dark** mode
-- [ ] Full accessibility checklist completed → load **`ouds-accessibility`** skill for details
+- [ ] Full accessibility checklist completed → load **`ouds-flutter-accessibility`** skill for details
+

skills/ouds-migration-guide/SKILL.md …ls/ouds-flutter-migration-guide/SKILL.mdskills/ouds-migration-guide/SKILL.md renamed to skills/ouds-flutter-migration-guide/SKILL.md skills/ouds-migration-guide/SKILL.md renamed to skills/ouds-flutter-migration-guide/SKILL.md

@@ -1,18 +1,22 @@
 ---
-name: ouds-migration-guide
+name: ouds-flutter-migration-guide
 description: How to migrate to OUDS Flutter — from native Flutter components, custom/branded components, or across OUDS library versions — with before/after mappings and required actions
 license: MIT
 ---
 
-# OUDS Migration Guide
+# OUDS Flutter Migration Guide
+
+> **Agent optimization**: See [copilot-instructions.md §9](../../.github/copilot-instructions.md#9-agent-response-optimization-) for token-efficient response guidelines.
+
+This skill applies to migration work in the OUDS Flutter repository. Use it for Flutter adoption and version migrations, not for OUDS web, Android native, or iOS native platforms.
 
 Use this skill when a user asks how to:
 
 - **adopt** OUDS Flutter in a new or existing app (from native Flutter widgets or custom components)
 - **migrate** existing OUDS Flutter code across library versions
 - **understand** breaking changes between released OUDS versions
 
-> ⚙️ Always load **`ouds-framework-usage`** alongside this skill to get accurate component APIs, token accessors and state patterns.
+> ⚙️ Always load **`ouds-flutter-framework-usage`** alongside this skill to get accurate component APIs, token accessors and state patterns.
 
 ---
 
@@ -349,7 +353,7 @@ OudsInlineAlert(label: 'Profile updated.', status: Positive())
 
 ### 1.6 Accessibility — migration-specific points
 
-> For the full a11y reference, load the **`ouds-accessibility`** skill.
+> For the full a11y reference, load the **`ouds-flutter-accessibility`** skill.
 
 Migration-specific actions to perform after replacing native widgets with OUDS equivalents:
 
@@ -654,7 +658,7 @@ OudsThemeTweak(
 - [ ] No magic number padding/margin — all values from `spaceScheme(context)` or `sizeScheme(context)`
 - [ ] All user-facing strings use `OudsLocalizations.of(context)` or app localizations
 - [ ] `dart format .` → `flutter analyze --no-pub` → zero errors
-- [ ] Full accessibility checklist completed → load **`ouds-accessibility`** skill for details
+- [ ] Full accessibility checklist completed → load **`ouds-flutter-accessibility`** skill for details
 
 ---
 
@@ -930,3 +934,4 @@ If a migration is unclear or incomplete:
   - GitHub issues
   - GitHub discussions
   - `.github/MAINTAINERS.md`
+

skills/ouds-vocabulary/SKILL.md skills/ouds-flutter-vocabulary/SKILL.mdskills/ouds-vocabulary/SKILL.md renamed to skills/ouds-flutter-vocabulary/SKILL.md

@@ -1,10 +1,16 @@
 ---
-name: ouds-vocabulary
-description: Use when the user asks about OUDS-specific terms such as Tokenator, token, raw token, semantic token, component token, theme, theme tweak, theme config, token provider, or component
+name: ouds-flutter-vocabulary
+description: Reference guide for OUDS Flutter vocabulary and core concepts (Tokenator, token types, theme, theme tweak, theme config, token provider, component)
 license: MIT
 ---
 
-# OUDS Vocabulary
+# OUDS Flutter Vocabulary
+
+> **Agent optimization**: See [copilot-instructions.md §9](../../.github/copilot-instructions.md#9-agent-response-optimization-) for token-efficient response guidelines.
+
+This skill applies to the OUDS Flutter repository and terminology. Use it for Flutter-specific OUDS vocabulary, not for OUDS web, Android native, or iOS native platforms.
+
+## Terminology
 
 | Term | Definition |
 |------|------------|
@@ -26,8 +32,9 @@ license: MIT
 
 | Task | Skill to load |
 |------|---------------|
-| Ask about or explain OUDS-specific terms (Tokenator, token, raw token, semantic token, component token, theme, …) | `ouds-vocabulary` (this skill) |
-| Write or review Dart / Flutter code using OUDS components, themes or tokens | `ouds-framework-usage` |
-| Translate a Figma token or token family into the corresponding Flutter package / token layer / naming pattern | `ouds-figma-to-flutter` |
-| Adopt OUDS from native Flutter or custom components, migrate between versions, remove deprecated APIs | `ouds-migration-guide` |
-| Implement or review accessibility — Semantics, screen readers, text scale, high-contrast, orientation | `ouds-accessibility` |
+| Ask about or explain OUDS-specific terms (Tokenator, token, raw token, semantic token, component token, theme, …) | `ouds-flutter-vocabulary` (this skill) |
+| Write or review Dart / Flutter code using OUDS components, themes or tokens | `ouds-flutter-framework-usage` |
+| Translate a Figma token or token family into the corresponding Flutter package / token layer / naming pattern | `ouds-flutter-figma-to-dart` |
+| Adopt OUDS from native Flutter or custom components, migrate between versions, remove deprecated APIs | `ouds-flutter-migration-guide` |
+| Implement or review accessibility — Semantics, screen readers, text scale, high-contrast, orientation | `ouds-flutter-accessibility` |
+