@mmerterden/multi-agent-pipeline 12.6.0 → 12.7.0

package/pipeline/skills/.skills-index.json

@@ -4,7 +4,7 @@
   "entries": [
     {
       "name": "accessibility-compliance-accessibility-audit",
-      "description": "You are an accessibility expert specializing in WCAG compliance, inclusive design, and assistive technology compatibility. Conduct audits, identify barriers, and provide remediation guidance.",
+      "description": "You are an accessibility expert specializing in WCAG compliance, inclusive design, and assistive technology compatibility. Conduct audits, identify barriers, and provide remediation guidance. Use when auditing a product against WCAG, or when a barrier needs diagnosing and remediating.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -22,7 +22,7 @@
     },
     {
       "name": "agentflow",
-      "description": "Orchestrate autonomous AI development pipelines through your Kanban board (Asana, GitHub Projects, Linear). Manages multi-worker Claude Code dispatch, deterministic quality gates, adversarial review, per-task cost tracking, and crash-proof pipeline execution.",
+      "description": "Orchestrate autonomous AI development pipelines through your Kanban board (Asana, GitHub Projects, Linear). Manages multi-worker Claude Code dispatch, deterministic quality gates, adversarial review, per-task cost tracking, and crash-proof pipeline execution. Use when development should be driven fr",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -40,7 +40,7 @@
     },
     {
       "name": "android_ui_verification",
-      "description": "Automated end-to-end UI testing and verification on an Android Emulator using ADB.",
+      "description": "Automated end-to-end UI testing and verification on an Android Emulator using ADB. Use when an Android build needs driving on an emulator to verify its UI end to end.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -58,7 +58,7 @@
     },
     {
       "name": "android-jetpack-compose-expert",
-      "description": "Expert guidance for building modern Android UIs with Jetpack Compose, covering state management, navigation, performance, and Material Design 3.",
+      "description": "Expert guidance for building modern Android UIs with Jetpack Compose, covering state management, navigation, performance, and Material Design 3. Use when building or reviewing Compose UI, state handling or navigation.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -85,7 +85,7 @@
     },
     {
       "name": "api-patterns",
-      "description": "API design principles and decision-making. REST vs GraphQL vs tRPC selection, response formats, versioning, pagination.",
+      "description": "API design principles and decision-making. REST vs GraphQL vs tRPC selection, response formats, versioning, pagination. Use when choosing between REST, GraphQL and tRPC, or shaping response formats, versioning and pagination.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -94,7 +94,7 @@
     },
     {
       "name": "api-security-best-practices",
-      "description": "Implement secure API design patterns including authentication, authorization, input validation, rate limiting, and protection against common API vulnerabilities",
+      "description": "Implement secure API design patterns including authentication, authorization, input validation, rate limiting, and protection against common API vulnerabilities. Use when designing or reviewing an API's authentication, authorization, input validation or rate limiting.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -121,7 +121,7 @@
     },
     {
       "name": "app-store-changelog",
-      "description": "Generate user-facing App Store release notes from git history since the last tag.",
+      "description": "Generate user-facing App Store release notes from git history since the last tag. Use when release notes have to be written from the commits since the last tag.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -148,7 +148,7 @@
     },
     {
       "name": "apple-archive-compliance",
-      "description": "Apple App Store Review compliance  -  wraps the dev-toolkit-mcp `ios_app_store_audit` tool (17-rule deep scan) with ITMS error code mapping + EN/TR humanizer templates. Consumed by: /multi-agent:test 'store-ready' (primary dispatch), Phase 4 Security Auditor (catalog cross-ref on Info.plist / Privac",
+      "description": "Apple App Store Review compliance  -  wraps the dev-toolkit-mcp `ios_app_store_audit` tool (18-rule deep scan) with ITMS error code mapping + EN/TR humanizer templates. Consumed by: /multi-agent:test 'store-ready' (primary dispatch), Phase 4 Security Auditor (catalog cross-ref on Info.plist / Privac",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -220,7 +220,7 @@
     },
     {
       "name": "ci-cd-pipelines",
-      "description": "CI/CD pipelines: GitHub Actions workflows, Docker multi-stage builds, environment management, secret management, deployment strategies",
+      "description": "CI/CD pipelines: GitHub Actions workflows, Docker multi-stage builds, environment management, secret management, deployment strategies. Use when setting up or fixing a build, test or deploy pipeline.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -292,7 +292,7 @@
     },
     {
       "name": "context-compression",
-      "description": "When agent sessions generate millions of tokens of conversation history, compression becomes mandatory. The naive approach is aggressive compression to minimize tokens per request.",
+      "description": "When agent sessions generate millions of tokens of conversation history, compression becomes mandatory. The naive approach is aggressive compression to minimize tokens per request. Use when an agent session has grown too long to keep in full and history has to be compressed.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -364,7 +364,7 @@
     },
     {
       "name": "css-modern",
-      "description": "Modern CSS: container queries, nesting, @layer, Grid/Flexbox patterns, custom properties, animations, and transitions",
+      "description": "Modern CSS: container queries, nesting, @layer, Grid/Flexbox patterns, custom properties, animations, and transitions. Use when writing or reviewing modern CSS: layout, container queries, custom properties, animation.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -373,7 +373,7 @@
     },
     {
       "name": "database-patterns",
-      "description": "Database patterns: SQL best practices (PostgreSQL), indexing, query optimization, migrations, schema design, ORMs (SQLAlchemy, Prisma, Drizzle)",
+      "description": "Database patterns: SQL best practices (PostgreSQL), indexing, query optimization, migrations, schema design, ORMs (SQLAlchemy, Prisma, Drizzle). Use when designing a schema, writing migrations, or a query needs optimising.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -391,7 +391,7 @@
     },
     {
       "name": "debugging-strategies",
-      "description": "Transform debugging from frustrating guesswork into systematic problem-solving with proven strategies, powerful tools, and methodical approaches.",
+      "description": "Transform debugging from frustrating guesswork into systematic problem-solving with proven strategies, powerful tools, and methodical approaches. Use when a bug resists guesswork and needs a systematic approach.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -409,7 +409,7 @@
     },
     {
       "name": "docker-expert",
-      "description": "You are an advanced Docker containerization expert with comprehensive, practical knowledge of container optimization, security hardening, multi-stage builds, orchestration patterns, and production deployment strategies based on current industry best practices.",
+      "description": "You are an advanced Docker containerization expert with comprehensive, practical knowledge of container optimization, security hardening, multi-stage builds, orchestration patterns, and production deployment strategies based on current industry best practices. Use when writing or reviewing a Dockerf",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -436,7 +436,7 @@
     },
     {
       "name": "fastapi-pro",
-      "description": "Build high-performance async APIs with FastAPI, SQLAlchemy 2.0, and Pydantic V2. Master microservices, WebSockets, and modern Python async patterns.",
+      "description": "Build high-performance async APIs with FastAPI, SQLAlchemy 2.0, and Pydantic V2. Master microservices, WebSockets, and modern Python async patterns. Use when building or reviewing an async Python API with FastAPI, SQLAlchemy or Pydantic.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -445,7 +445,7 @@
     },
     {
       "name": "firebase",
-      "description": "You're a developer who has shipped dozens of Firebase projects. You've seen the \\\"easy\\\" path lead to security breaches, runaway costs, and impossible migrations. You know Firebase is powerful, but you also know its sharp edges.",
+      "description": "You're a developer who has shipped dozens of Firebase projects. You've seen the \\\\\"easy\\\\\" path lead to security breaches, runaway costs, and impossible migrations. You know Firebase is powerful, but you also know its sharp edges. Use when integrating or reviewing Firebase: auth, Firestore, function",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -454,7 +454,7 @@
     },
     {
       "name": "github-actions-templates",
-      "description": "Production-ready GitHub Actions workflow patterns for testing, building, and deploying applications.",
+      "description": "Production-ready GitHub Actions workflow patterns for testing, building, and deploying applications. Use when a GitHub Actions workflow has to be written or hardened.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -490,7 +490,7 @@
     },
     {
       "name": "help-skills",
-      "description": "Mevcut tum iOS/Swift skill'lerini listeler ve ne ise yaradiklarini aciklar.",
+      "description": "Mevcut tum iOS/Swift skill'lerini listeler ve ne ise yaradiklarini aciklar. Use when asked which iOS or Swift skills are available and what each one covers.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -499,7 +499,7 @@
     },
     {
       "name": "hig-components-content",
-      "description": "Apple Human Interface Guidelines for content display components.",
+      "description": "Apple Human Interface Guidelines for content display components. Use when designing or reviewing how content is displayed on an Apple platform.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -508,7 +508,7 @@
     },
     {
       "name": "hig-components-layout",
-      "description": "Apple Human Interface Guidelines for layout and navigation components.",
+      "description": "Apple Human Interface Guidelines for layout and navigation components. Use when designing or reviewing layout and navigation on an Apple platform.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -517,7 +517,7 @@
     },
     {
       "name": "hig-components-status",
-      "description": "Apple HIG guidance for status and progress UI components including progress indicators, status bars, and activity rings.",
+      "description": "Apple HIG guidance for status and progress UI components including progress indicators, status bars, and activity rings. Use when designing or reviewing progress, status or feedback UI on an Apple platform.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -526,7 +526,7 @@
     },
     {
       "name": "hig-components-system",
-      "description": "'Apple HIG guidance for system experience components: widgets, live activities, notifications, complications, home screen quick actions, top shelf, watch faces, app clips, and app shortcuts.'",
+      "description": "'Apple HIG guidance for system experience components: widgets, live activities, notifications, complications, home screen quick actions, top shelf, watch faces, app clips, and app shortcuts. Use when designing or reviewing widgets, Live Activities or notifications on an Apple platform.'",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -535,7 +535,7 @@
     },
     {
       "name": "hig-foundations",
-      "description": "Apple Human Interface Guidelines design foundations.",
+      "description": "Apple Human Interface Guidelines design foundations. Use when a design decision turns on Apple's foundations: layout, typography, colour, motion, accessibility.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -544,7 +544,7 @@
     },
     {
       "name": "hig-inputs",
-      "description": "Check for .claude/apple-design-context.md before asking questions. Use existing context and only ask for information not already covered.",
+      "description": "Check for .claude/apple-design-context.md before asking questions. Use existing context and only ask for information not already covered. Use when designing or reviewing input controls, forms or text entry on an Apple platform.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -553,7 +553,7 @@
     },
     {
       "name": "hig-patterns",
-      "description": "Apple Human Interface Guidelines interaction and UX patterns.",
+      "description": "Apple Human Interface Guidelines interaction and UX patterns. Use when an interaction or UX pattern on an Apple platform needs designing or reviewing.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -562,7 +562,7 @@
     },
     {
       "name": "hig-platforms",
-      "description": "Apple Human Interface Guidelines for platform-specific design.",
+      "description": "Apple Human Interface Guidelines for platform-specific design. Use when a design has to fit a specific Apple platform's conventions.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -571,7 +571,7 @@
     },
     {
       "name": "hig-technologies",
-      "description": "Check for .claude/apple-design-context.md before asking questions. Use existing context and only ask for information not already covered.",
+      "description": "Check for .claude/apple-design-context.md before asking questions. Use existing context and only ask for information not already covered. Use when designing or reviewing a feature built on an Apple technology such as Sign in with Apple, Wallet or Maps.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -589,7 +589,7 @@
     },
     {
       "name": "html-semantic",
-      "description": "Semantic HTML5: elements, forms with validation and accessibility, SEO best practices, structured data, Open Graph, Twitter Cards",
+      "description": "Semantic HTML5: elements, forms with validation and accessibility, SEO best practices, structured data, Open Graph, Twitter Cards. Use when writing or reviewing markup, forms or document structure for semantics, accessibility and SEO.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -616,7 +616,7 @@
     },
     {
       "name": "ios-debugger-agent",
-      "description": "Debug the current iOS project on a booted simulator with XcodeBuildMCP.",
+      "description": "Debug the current iOS project on a booted simulator with XcodeBuildMCP. Use when an iOS bug has to be reproduced and diagnosed on a booted simulator.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -625,7 +625,7 @@
     },
     {
       "name": "ios-developer",
-      "description": "Develop native iOS applications with Swift/SwiftUI. Masters iOS 18, SwiftUI, UIKit integration, Core Data, networking, and App Store optimization.",
+      "description": "Develop native iOS applications with Swift/SwiftUI. Masters iOS 18, SwiftUI, UIKit integration, Core Data, networking, and App Store optimization. Use when building or reviewing a native iOS feature in Swift or SwiftUI.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -670,7 +670,7 @@
     },
     {
       "name": "kotlin-coroutines-expert",
-      "description": "Expert patterns for Kotlin Coroutines and Flow, covering structured concurrency, error handling, and testing.",
+      "description": "Expert patterns for Kotlin Coroutines and Flow, covering structured concurrency, error handling, and testing. Use when writing or reviewing coroutines and Flow, or a concurrency bug needs diagnosing.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -688,7 +688,7 @@
     },
     {
       "name": "macos-menubar-tuist-app",
-      "description": "Build, refactor, or review SwiftUI macOS menubar apps that use Tuist.",
+      "description": "Build, refactor, or review SwiftUI macOS menubar apps that use Tuist. Use when building, refactoring or reviewing a SwiftUI macOS menubar app that uses Tuist.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -697,7 +697,7 @@
     },
     {
       "name": "macos-spm-app-packaging",
-      "description": "Scaffold, build, sign, and package SwiftPM macOS apps without Xcode projects.",
+      "description": "Scaffold, build, sign, and package SwiftPM macOS apps without Xcode projects. Use when a SwiftPM macOS app has to be built, signed or packaged without an Xcode project.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -724,7 +724,7 @@
     },
     {
       "name": "monorepo-architect",
-      "description": "Expert in monorepo architecture, build systems, and dependency management at scale. Masters Nx, Turborepo, Bazel, and Lerna for efficient multi-project development. Use PROACTIVELY for monorepo setup,",
+      "description": "Expert in monorepo architecture, build systems, and dependency management at scale. Masters Nx, Turborepo, Bazel, and Lerna for efficient multi-project development. Use PROACTIVELY for monorepo setup,. Use when a monorepo's build system, task graph or dependency layout needs designing or fixing.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -733,7 +733,7 @@
     },
     {
       "name": "multi-agent",
-      "description": "Task orchestrator: runs the full pipeline from a Jira ID or GitHub Issue URL  -  analysis → plan → TDD development → parallel review (Fable + Sonnet on Claude Code, GPT + Opus + Sonnet on Copilot CLI) → commit → log. Every step is written to agent-log.md.",
+      "description": "Task orchestrator: runs the full pipeline from a Jira ID or GitHub Issue URL  -  analysis → plan → TDD development → parallel review (Fable + Sonnet on Claude Code, GPT + Opus + Sonnet on Copilot CLI) → commit → log. Every step is written to agent-log.md. Use when given a Jira ID, a GitHub issue or ",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -760,7 +760,7 @@
     },
     {
       "name": "multi-agent-autopilot",
-      "description": "Launch any task in autopilot mode: skips every confirmation, runs end-to-end autonomously.",
+      "description": "Launch any task in autopilot mode: skips every confirmation, runs end-to-end autonomously. Use when a task should run end to end with no confirmation prompts.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -769,7 +769,7 @@
     },
     {
       "name": "multi-agent-build-optimize",
-      "description": "Wrapper that dispatches to xcode-build-orchestrator on iOS repos. Benchmarks the current Xcode build, runs compilation / project / SPM analyzers, produces a recommend-first optimization plan in .build-benchmark/, and re-benchmarks after the developer approves changes. Fails fast on non-iOS stacks.",
+      "description": "Wrapper that dispatches to xcode-build-orchestrator on iOS repos. Benchmarks the current Xcode build, runs compilation / project / SPM analyzers, produces a recommend-first optimization plan in .build-benchmark/, and re-benchmarks after the developer approves changes. Fails fast on non-iOS stacks. U",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -787,7 +787,7 @@
     },
     {
       "name": "multi-agent-create-jira",
-      "description": "Create a standards-compliant Jira issue (Task / Bug / Story): asks the type, mines project conventions, drafts from a standard template with auto-sizing sections, full preview + explicit approval before create.",
+      "description": "Create a standards-compliant Jira issue (Task / Bug / Story): asks the type, mines project conventions, drafts from a standard template with auto-sizing sections, full preview + explicit approval before create. Use when a Jira Task, Bug or Story has to be written to the project's own conventions.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -805,7 +805,7 @@
     },
     {
       "name": "multi-agent-dev",
-      "description": "Fast development mode: Init → Dev (Opus) → Test → Commit → Report. Analysis, planning, and review phases are skipped.",
+      "description": "Fast development mode: Init → Dev (Opus) → Test → Commit → Report. Analysis, planning, and review phases are skipped. Use when the work is already scoped and only development, test and commit are needed.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -814,7 +814,7 @@
     },
     {
       "name": "multi-agent-dev-autopilot",
-      "description": "Fastest mode: Dev (Opus) plus Autopilot. Init → Dev → Commit → Report with zero confirmations.",
+      "description": "Fastest mode: Dev (Opus) plus Autopilot. Init → Dev → Commit → Report with zero confirmations. Use when a change is well understood and should go from start to commit with no questions asked.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -823,7 +823,7 @@
     },
     {
       "name": "multi-agent-dev-local",
-      "description": "Fast mode + local  -  Init → Dev(Opus) → Commit → Report, no worktree.",
+      "description": "Fast mode + local  -  Init → Dev(Opus) → Commit → Report, no worktree. Use when a change should be developed on the current branch without creating a worktree.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -832,7 +832,7 @@
     },
     {
       "name": "multi-agent-dev-local-autopilot",
-      "description": "Fastest + local  -  Dev(Opus) + autopilot, no worktree, zero interaction.",
+      "description": "Fastest + local  -  Dev(Opus) + autopilot, no worktree, zero interaction. Use when a change should be developed on the current branch with no worktree and no prompts.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -841,7 +841,7 @@
     },
     {
       "name": "multi-agent-diff-explain",
-      "description": "Map Phase 4 triage findings to branch diff lines. Read-only post-hoc command, used after review to answer 'which finding lines up with which code change'.",
+      "description": "Map Phase 4 triage findings to branch diff lines. Read-only post-hoc command, used after review to answer 'which finding lines up with which code change'. Use when a review finding has to be traced to the exact lines that caused it.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -850,7 +850,7 @@
     },
     {
       "name": "multi-agent-finish",
-      "description": "Continue already-done LOCAL work through the pipeline tail: Review → Build+Test → Commit/PR → Report (technical analysis + Jira test-scenario comment). No dev phase.",
+      "description": "Continue already-done LOCAL work through the pipeline tail: Review → Build+Test → Commit/PR → Report (technical analysis + Jira test-scenario comment). No dev phase. Use when local work is already done and only review, build, commit and reporting remain.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -859,7 +859,7 @@
     },
     {
       "name": "multi-agent-forget",
-      "description": "Remove a saved /multi-agent routine (created by /multi-agent:save): deletes its local-only command and its registry entry. Asks which one and confirms.",
+      "description": "Remove a saved /multi-agent routine (created by /multi-agent:save): deletes its local-only command and its registry entry. Asks which one and confirms. Use when a saved routine is no longer wanted and should be removed.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -868,7 +868,7 @@
     },
     {
       "name": "multi-agent-garbage-collect",
-      "description": "Sweep leftover /tmp scratch (picker state, review diffs, channel payloads, analysis drafts) from past runs. Dry-run first; confirms before deleting.",
+      "description": "Sweep leftover /tmp scratch (picker state, review diffs, channel payloads, analysis drafts) from past runs. Dry-run first; confirms before deleting. Use when scratch files from earlier runs need clearing out.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -877,7 +877,7 @@
     },
     {
       "name": "multi-agent-help",
-      "description": "Multi-agent pipeline usage guide  -  renders in EN or TR per prefs.global.outputLanguage (falls back to promptLanguage for backward compatibility).",
+      "description": "Multi-agent pipeline usage guide  -  renders in EN or TR per prefs.global.outputLanguage (falls back to promptLanguage for backward compatibility). Use when asked what the pipeline can do, which mode to pick, or what a command means.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -886,7 +886,7 @@
     },
     {
       "name": "multi-agent-issue",
-      "description": "List unassigned GitHub issues, pick one, auto-assign, and launch the multi-agent pipeline.",
+      "description": "List unassigned GitHub issues, pick one, auto-assign, and launch the multi-agent pipeline. Use when a GitHub issue should be picked up and started without knowing its number in advance.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -895,7 +895,7 @@
     },
     {
       "name": "multi-agent-jira",
-      "description": "List open Jira issues, pick one, and launch the multi-agent pipeline.",
+      "description": "List open Jira issues, pick one, and launch the multi-agent pipeline. Use when a Jira issue should be picked up and started without knowing its key in advance.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -904,7 +904,7 @@
     },
     {
       "name": "multi-agent-kill",
-      "description": "Stop the given task, then remove its worktree and branch. Asks for confirmation.",
+      "description": "Stop the given task, then remove its worktree and branch. Asks for confirmation. Use when a running or stuck task should be stopped and its worktree removed.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -913,7 +913,7 @@
     },
     {
       "name": "multi-agent-language",
-      "description": "Toggle outputLanguage (assistant explanations). promptLanguage is fixed to English. External payloads stay English.",
+      "description": "Toggle outputLanguage (assistant explanations). promptLanguage is fixed to English. External payloads stay English. Use when the assistant should explain itself in a different language.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -922,7 +922,7 @@
     },
     {
       "name": "multi-agent-local",
-      "description": "Full pipeline in local mode  -  no worktree, runs directly on the current branch.",
+      "description": "Full pipeline in local mode  -  no worktree, runs directly on the current branch. Use when the full pipeline should run on the current branch without creating a worktree.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -931,7 +931,7 @@
     },
     {
       "name": "multi-agent-local-autopilot",
-      "description": "Full pipeline + local + autopilot  -  no worktree, no confirmations, all 8 phases run end-to-end on the current branch.",
+      "description": "Full pipeline + local + autopilot  -  no worktree, no confirmations, all 8 phases run end-to-end on the current branch. Use when the full pipeline should run on the current branch with no worktree and no prompts.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -940,7 +940,7 @@
     },
     {
       "name": "multi-agent-log",
-      "description": "Show the agent-log.md for the given task. With no ID, shows the most recent task.",
+      "description": "Show the agent-log.md for the given task. With no ID, shows the most recent task. Use when asked what a task did, or to read its log.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -949,7 +949,7 @@
     },
     {
       "name": "multi-agent-manual-test",
-      "description": "Switch to the active task's branch and prepare it for manual testing in Xcode. Phase 5 standalone (the UI Bug Hunter lives at multi-agent-test).",
+      "description": "Switch to the active task's branch and prepare it for manual testing in Xcode. Phase 5 standalone (the UI Bug Hunter lives at multi-agent-test). Use when a finished change needs trying by hand on a device or simulator.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -958,7 +958,7 @@
     },
     {
       "name": "multi-agent-prune-logs",
-      "description": "Delete per-task project logs under ~/.claude/logs/multi-agent (filter by age/project/task). Audit trail + metrics are preserved. Dry-run first; confirms before deleting.",
+      "description": "Delete per-task project logs under ~/.claude/logs/multi-agent (filter by age/project/task). Audit trail + metrics are preserved. Dry-run first; confirms before deleting. Use when task logs have built up and need trimming by age, project or task.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -967,7 +967,7 @@
     },
     {
       "name": "multi-agent-purge",
-      "description": "⚠️ Wipes every worktree, branch, log, and state file. Irreversible; asks for double confirmation.",
+      "description": "⚠️ Wipes every worktree, branch, log, and state file. Irreversible; asks for double confirmation. Use when every worktree, branch, log and state file should be wiped and the pipeline reset.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -976,7 +976,7 @@
     },
     {
       "name": "multi-agent-refactor",
-      "description": "Analyse the project: extract adapted best-practices, hunt real bugs + improvement areas, check upstream drift of derived skills, research the companion dev-toolkit MCP server against current MCP practice, draft one plan, take approval, develop, then ask whether to sync.",
+      "description": "Analyse the project: extract adapted best-practices, hunt real bugs + improvement areas, check upstream drift of derived skills, research the companion dev-toolkit MCP server against current MCP practice, draft one plan, take approval, develop, then ask whether to sync. Use when asked to review a pr",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -985,7 +985,7 @@
     },
     {
       "name": "multi-agent-resume",
-      "description": "Resume a stopped or failed task from the phase where it left off.",
+      "description": "Resume a stopped or failed task from the phase where it left off. Use when a task stopped or failed and should carry on from where it left off.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -994,7 +994,7 @@
     },
     {
       "name": "multi-agent-review",
-      "description": "Run parallel review on a branch diff or a Pull Request: 2 models on Claude Code (Fable + Sonnet), 3 models on Copilot CLI (GPT + Opus + Sonnet). On PR input, posts per-finding inline comments + approve/needs-work. With no input (interactive), lists open GitHub + Bitbucket PRs to multi-select.",
+      "description": "Run parallel review on a branch diff or a Pull Request: 2 models on Claude Code (Fable + Sonnet), 3 models on Copilot CLI (GPT + Opus + Sonnet). On PR input, posts per-finding inline comments + approve/needs-work. With no input (interactive), lists open GitHub + Bitbucket PRs to multi-select. Use wh",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -1003,7 +1003,7 @@
     },
     {
       "name": "multi-agent-review-issue",
-      "description": "Assess whether a GitHub issue is ready for multi-agent development: fetch it, grade scope / acceptance criteria / repro / design / API / stack readiness, then (after confirm) post the gaps as an issue comment. Read-only on code.",
+      "description": "Assess whether a GitHub issue is ready for multi-agent development: fetch it, grade scope / acceptance criteria / repro / design / API / stack readiness, then (after confirm) post the gaps as an issue comment. Read-only on code. Use when deciding whether a GitHub issue is specified well enough to ha",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -1012,7 +1012,7 @@
     },
     {
       "name": "multi-agent-review-jira",
-      "description": "Assess whether a Jira issue is ready for multi-agent development: fetch it, grade scope / acceptance criteria / repro / design / API / stack readiness, then (after confirm) post the gaps as a Jira comment. Read-only on code.",
+      "description": "Assess whether a Jira issue is ready for multi-agent development: fetch it, grade scope / acceptance criteria / repro / design / API / stack readiness, then (after confirm) post the gaps as a Jira comment. Read-only on code. Use when deciding whether a Jira issue is specified well enough to hand to ",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -1021,7 +1021,7 @@
     },
     {
       "name": "multi-agent-routines",
-      "description": "List your saved /multi-agent routines (from /multi-agent:save) with what each one does, rendered in outputLanguage.",
+      "description": "List your saved /multi-agent routines (from /multi-agent:save) with what each one does, rendered in outputLanguage. Use when asked which saved routines exist or what one of them does.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -1030,7 +1030,7 @@
     },
     {
       "name": "multi-agent-save",
-      "description": "Save a recurring job as a reusable /multi-agent:<name> command. Reviews the conversation + your CLAUDE.md for candidate routines, you pick one and name it; stored local-only, never synced.",
+      "description": "Save a recurring job as a reusable /multi-agent:<name> command. Reviews the conversation + your CLAUDE.md for candidate routines, you pick one and name it; stored local-only, never synced. Use when a job keeps recurring and should become its own reusable command.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -1039,7 +1039,7 @@
     },
     {
       "name": "multi-agent-scan",
-      "description": "Skill security scan: walks local skill directories against a tiered pattern catalog.",
+      "description": "Skill security scan: walks local skill directories against a tiered pattern catalog. Use when local skill directories need checking for unsafe or unexpected content.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -1048,7 +1048,7 @@
     },
     {
       "name": "multi-agent-search",
-      "description": "Log search across every agent-log.md with smart ranking and filters. Optional --semantic flag queries the per-repo triage corpus.",
+      "description": "Log search across every agent-log.md with smart ranking and filters. Optional --semantic flag queries the per-repo triage corpus. Use when something has to be found across past task logs.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -1057,7 +1057,7 @@
     },
     {
       "name": "multi-agent-setup",
-      "description": "First-run setup wizard: keychain token discovery, Git Identity onboarding, and pipeline preparation.",
+      "description": "First-run setup wizard: keychain token discovery, Git Identity onboarding, and pipeline preparation. Use when the pipeline is being set up for the first time, or tokens and git identity need onboarding.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -1066,7 +1066,7 @@
     },
     {
       "name": "multi-agent-stack",
-      "description": "Select the active stack for this repo by enabling the matching marketplace plugin(s) in .claude/settings.json (ios/android/mobile/backend/frontend/fullstack/all).",
+      "description": "Select the active stack for this repo by enabling the matching marketplace plugin(s) in .claude/settings.json (ios/android/mobile/backend/frontend/fullstack/all). Use when a repo's stack changed or the wrong plugins are enabled for it.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -1075,7 +1075,7 @@
     },
     {
       "name": "multi-agent-status",
-      "description": "Show every multi-agent task's ID, phase, branch, and status.",
+      "description": "Show every multi-agent task's ID, phase, branch, and status. Use when asked what is running, or for an overview of every task.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -1084,7 +1084,7 @@
     },
     {
       "name": "multi-agent-sync",
-      "description": "One-shot sync of the entire multi-agent ecosystem: Claude Code, Copilot CLI, pipeline repo, website, and the dev-toolkit MCP server.",
+      "description": "One-shot sync of the entire multi-agent ecosystem: Claude Code, Copilot CLI, pipeline repo, website, and the dev-toolkit MCP server. Use when work is finished and should be propagated across Claude Code, Copilot CLI, the repos, the website and the dev-toolkit server.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -1093,7 +1093,7 @@
     },
     {
       "name": "multi-agent-test",
-      "description": "UI Bug Hunter  -  iOS Simulator (simctl) + Android Emulator (adb). Auto-detects platform. Screenshot + tap + analyze on the booted device. The Phase 5 Manual Test flow lives at multi-agent-manual-test.",
+      "description": "UI Bug Hunter  -  iOS Simulator (simctl) + Android Emulator (adb). Auto-detects platform. Screenshot + tap + analyze on the booted device. The Phase 5 Manual Test flow lives at multi-agent-manual-test. Use when a running app should be driven on a simulator or emulator to hunt UI bugs.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -1102,7 +1102,7 @@
     },
     {
       "name": "multi-agent-uninstall",
-      "description": "Uninstall the pipeline from Claude Code + Copilot CLI. Keychain access tokens are always left untouched; --all-data also clears pipeline settings and logs. Asks for double confirmation.",
+      "description": "Uninstall the pipeline from Claude Code + Copilot CLI. Keychain access tokens are always left untouched; --all-data also clears pipeline settings and logs. Asks for double confirmation. Use when the pipeline should be removed from Claude Code and Copilot CLI.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -1111,7 +1111,7 @@
     },
     {
       "name": "multi-agent-update",
-      "description": "Update the pipeline to the latest version: git pull, install, migrate.",
+      "description": "Update the pipeline to the latest version: git pull, install, migrate. Use when the installed pipeline is behind and should be brought to the latest version.",
       "platform": null,
       "group": "core",
       "triggerKeywords": [],
@@ -1138,7 +1138,7 @@
     },
     {
       "name": "nextjs-app-router",
-      "description": "Next.js 15+ App Router: Server/Client Components, Server Actions, data fetching, layouts, middleware, ISR/SSG/SSR, and routing patterns",
+      "description": "Next.js 15+ App Router: Server/Client Components, Server Actions, data fetching, layouts, middleware, ISR/SSG/SSR, and routing patterns. Use when building or reviewing App Router work: Server Components, Server Actions, data fetching, layouts.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -1147,7 +1147,7 @@
     },
     {
       "name": "nodejs-backend-patterns",
-      "description": "Comprehensive guidance for building scalable, maintainable, and production-ready Node.js backend applications with modern frameworks, architectural patterns, and best practices.",
+      "description": "Comprehensive guidance for building scalable, maintainable, and production-ready Node.js backend applications with modern frameworks, architectural patterns, and best practices. Use when building or reviewing a Node.js service: structure, error handling, configuration, scaling.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -1156,7 +1156,7 @@
     },
     {
       "name": "observability-engineer",
-      "description": "Build production-ready monitoring, logging, and tracing systems. Implements comprehensive observability strategies, SLI/SLO management, and incident response workflows.",
+      "description": "Build production-ready monitoring, logging, and tracing systems. Implements comprehensive observability strategies, SLI/SLO management, and incident response workflows. Use when metrics, logging, tracing or alerting have to be designed or fixed.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -1228,7 +1228,7 @@
     },
     {
       "name": "python-patterns",
-      "description": "Modern Python 3.12+: type hints, dataclasses, Pydantic v2, async/await, context managers, generators, pattern matching",
+      "description": "Modern Python 3.12+: type hints, dataclasses, Pydantic v2, async/await, context managers, generators, pattern matching. Use when writing or reviewing modern Python: typing, dataclasses, Pydantic, async, generators.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -1237,7 +1237,7 @@
     },
     {
       "name": "react-best-practices",
-      "description": "React 19+ best practices: Server Components, use() hook, Actions, hooks patterns, state management, and performance optimization",
+      "description": "React 19+ best practices: Server Components, use() hook, Actions, hooks patterns, state management, and performance optimization. Use when building or reviewing React work: components, hooks, state, Server Components, Actions.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -1255,7 +1255,7 @@
     },
     {
       "name": "rest-api-design",
-      "description": "REST API design: HTTP methods, status codes, pagination, versioning, rate limiting, caching headers, OpenAPI documentation",
+      "description": "REST API design: HTTP methods, status codes, pagination, versioning, rate limiting, caching headers, OpenAPI documentation. Use when a REST surface needs designing or reviewing: methods, status codes, pagination, versioning, caching.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -1300,7 +1300,7 @@
     },
     {
       "name": "skill-creator",
-      "description": "Author and refine skills for a plugin/toolkit efficiently. Use when creating a new skill, trimming or splitting an existing one, writing a skill's description, or choosing skill vs command vs agent vs CLAUDE.md. Encodes the house rules — lean SKILL.md as an index, progressive disclosure into bundled",
+      "description": "Author and refine skills for a plugin/toolkit efficiently. Use when creating a new skill, trimming or splitting an existing one, writing a skill's description, or choosing skill vs command vs agent vs CLAUDE.md. Encodes the house rules - lean SKILL.md as an index, progressive disclosure into bundled",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -1381,7 +1381,7 @@
     },
     {
       "name": "swift-concurrency-expert",
-      "description": "Review and fix Swift concurrency issues such as actor isolation and Sendable violations.",
+      "description": "Review and fix Swift concurrency issues such as actor isolation and Sendable violations. Use when a Swift concurrency problem needs diagnosing, such as actor isolation or a Sendable violation.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -1543,7 +1543,7 @@
     },
     {
       "name": "swiftui-performance-audit",
-      "description": "Audit SwiftUI performance issues from code review and profiling evidence.",
+      "description": "Audit SwiftUI performance issues from code review and profiling evidence. Use when a SwiftUI view is slow and the cause has to be found from code and profiling evidence.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -1561,7 +1561,7 @@
     },
     {
       "name": "swiftui-ui-patterns",
-      "description": "Apply proven SwiftUI UI patterns for navigation, sheets, async state, and reusable screens.",
+      "description": "Apply proven SwiftUI UI patterns for navigation, sheets, async state, and reusable screens. Use when a SwiftUI screen needs a proven pattern for navigation, sheets, async state or reuse.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -1579,7 +1579,7 @@
     },
     {
       "name": "swiftui-view-refactor",
-      "description": "Refactor SwiftUI views into smaller components with stable, explicit data flow.",
+      "description": "Refactor SwiftUI views into smaller components with stable, explicit data flow. Use when a SwiftUI view has grown too large and needs splitting with clear data flow.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -1597,7 +1597,7 @@
     },
     {
       "name": "tailwind-css",
-      "description": "Tailwind CSS v4: utility-first styling, responsive design, dark mode, custom themes, component patterns, and cn() utility",
+      "description": "Tailwind CSS v4: utility-first styling, responsive design, dark mode, custom themes, component patterns, and cn() utility. Use when styling or reviewing UI with Tailwind: utilities, responsive design, dark mode, theming.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -1606,7 +1606,7 @@
     },
     {
       "name": "testing-backend",
-      "description": "Backend testing: pytest patterns (Python), Jest patterns (Node.js), integration testing, database fixtures/factories, API contract testing",
+      "description": "Backend testing: pytest patterns (Python), Jest patterns (Node.js), integration testing, database fixtures/factories, API contract testing. Use when writing or reviewing backend tests: unit, integration, database and API level.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -1624,7 +1624,7 @@
     },
     {
       "name": "typescript-patterns",
-      "description": "Modern TypeScript patterns: strict mode, utility types, generics, conditional types, type guards, discriminated unions, Zod validation",
+      "description": "Modern TypeScript patterns: strict mode, utility types, generics, conditional types, type guards, discriminated unions, Zod validation. Use when writing or reviewing TypeScript types: generics, utility and conditional types, guards, strict mode.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -1642,7 +1642,7 @@
     },
     {
       "name": "vue-composition",
-      "description": "Vue 3 Composition API: ref, reactive, computed, watch, composables, Pinia state management, Vue Router 4, script setup",
+      "description": "Vue 3 Composition API: ref, reactive, computed, watch, composables, Pinia state management, Vue Router 4, script setup. Use when building or reviewing Vue 3 work with the Composition API, composables or Pinia.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -1660,7 +1660,7 @@
     },
     {
       "name": "web-accessibility",
-      "description": "WCAG 2.2 AA web accessibility: ARIA roles/states, keyboard navigation, screen readers, color contrast, focus management, axe-core testing",
+      "description": "WCAG 2.2 AA web accessibility: ARIA roles/states, keyboard navigation, screen readers, color contrast, focus management, axe-core testing. Use when auditing or fixing a web UI against WCAG: ARIA, keyboard access, screen readers, contrast.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -1669,7 +1669,7 @@
     },
     {
       "name": "web-performance",
-      "description": "Web performance: Core Web Vitals (LCP, INP, CLS), image optimization, code splitting, caching strategies, bundle analysis, Lighthouse",
+      "description": "Web performance: Core Web Vitals (LCP, INP, CLS), image optimization, code splitting, caching strategies, bundle analysis, Lighthouse. Use when a page is slow and Core Web Vitals, images, bundles or caching have to be addressed.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],
@@ -1678,7 +1678,7 @@
     },
     {
       "name": "web-testing",
-      "description": "Web testing: Vitest unit tests, React Testing Library, Playwright E2E, MSW API mocking, testing hooks and async operations",
+      "description": "Web testing: Vitest unit tests, React Testing Library, Playwright E2E, MSW API mocking, testing hooks and async operations. Use when writing or reviewing web tests with Vitest, Testing Library, Playwright or MSW.",
       "platform": null,
       "group": "external",
       "triggerKeywords": [],