@softspark/ai-toolkit 3.4.1 → 3.5.0

package/app/skills/cpp-rules/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cpp-rules
-description: "C++ coding rules from ai-toolkit: coding-style, frameworks, patterns, security, testing. Triggers: .cpp, .cc, .cxx, .hpp, .h, CMakeLists.txt, Makefile, GoogleTest, clang-tidy. Load when writing, reviewing, or editing C++ code."
+description: "C++ coding rules: style, patterns, security, testing. Triggers: .cpp, .cc, .cxx, .hpp, .h, CMakeLists.txt, Makefile, GoogleTest, clang-tidy."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/csharp-patterns/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: csharp-patterns
-description: "C# and .NET development patterns: LINQ, async/await, dependency injection, records, nullable reference types, ASP.NET Core minimal APIs, EF Core, MediatR. Triggers: C#, .NET, dotnet, ASP.NET, EF Core, LINQ, IServiceCollection, record type, async C#, nullable reference types. Load when writing or reviewing C#/.NET code."
+description: "C#/.NET: LINQ, async/await, DI, records, nullable refs, ASP.NET Core, EF Core, MediatR. Triggers: C#, .NET, dotnet, ASP.NET, EF Core, LINQ, record type, IServiceCollection."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/csharp-rules/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: csharp-rules
-description: "C#/.NET coding rules from ai-toolkit: coding-style, frameworks, patterns, security, testing. Triggers: .cs, .csproj, .sln, ASP.NET, ASP.NET Core, EF Core, LINQ, NUnit, xUnit, dotnet. Load when writing, reviewing, or editing C#/.NET code."
+description: "C#/.NET coding rules: style, patterns, security, testing. Triggers: .cs, .csproj, .sln, ASP.NET, ASP.NET Core, EF Core, LINQ, NUnit, xUnit, dotnet."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/cve-scan/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cve-scan
-description: "Scan project dependencies for known CVEs using native audit tools (npm, pip, composer, cargo, go, bundler, dart)"
+description: "Scans deps for known CVEs via native audit (npm, pip, composer, cargo, go, bundler, dart). Triggers: CVE scan, vulnerability scan, npm audit, pip audit."
 user-invocable: true
 effort: medium
 argument-hint: "[--ecosystem npm|pip|composer|cargo|go|ruby|dart] [--fix] [--json]"

package/app/skills/dart-rules/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: dart-rules
-description: "Dart/Flutter coding rules from ai-toolkit: coding-style, frameworks, patterns, security, testing. Triggers: .dart, pubspec.yaml, Flutter, Riverpod, Bloc, widget, StatelessWidget, StatefulWidget. Load when writing, reviewing, or editing Dart/Flutter code."
+description: "Dart/Flutter coding rules: style, patterns, security, testing. Triggers: .dart, pubspec.yaml, Flutter, Riverpod, Bloc, widget, StatelessWidget, StatefulWidget."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/database-patterns/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: database-patterns
-description: "Database schema design and query optimization: normalization, indexing strategies, joins, N+1, transactions, isolation levels, partitioning, EXPLAIN plans. Triggers: schema, table design, index, slow query, N+1, PostgreSQL, MySQL, SQL Server, SQL, EXPLAIN, query plan, transaction, deadlock. Load when designing tables or tuning queries."
+description: "DB schema design and query tuning: normalization, indexing, N+1, transactions, EXPLAIN. Triggers: schema, index, slow query, N+1, PostgreSQL, MySQL, EXPLAIN, deadlock, query plan."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/debug/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: debug
-description: "Debug errors and trace root causes systematically using logs, health checks, and hypothesis-driven investigation. Use when a bug or error message is in hand — not for architectural questions or when there is no reproducible symptom."
+description: "Systematic debugging via logs, health checks, hypothesis-driven investigation. Triggers: debug, error, trace root cause, fix bug, reproduce symptom, investigation."
 user-invocable: true
 effort: medium
 argument-hint: "[symptom]"

package/app/skills/debugging-tactics/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: debugging-tactics
-description: "Root-cause debugging with 4-phase method: investigation, hypothesis, validation, fix. No fix without RCA. Triggers: bug, error, exception, stack trace, not working, intermittent, flaky, crash, regression, fails sometimes, why is X happening, broken after. Load when user reports a bug or asks to investigate failing code."
+description: "RCA debugging: investigation, hypothesis, validation, fix. No fix without RCA. Triggers: bug, error, exception, stack trace, intermittent, flaky, crash, regression, broken after."
 effort: medium
 user-invocable: false
 allowed-tools: Grep, Read

package/app/skills/deploy/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: deploy
-description: "Deploy with pre-flight checks and health verification"
+description: "Deploys with pre-flight checks and health verification. Triggers: deploy, deployment, ship, release, push to prod."
 effort: medium
 disable-model-invocation: true
 argument-hint: "[environment]"

package/app/skills/design-an-interface/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: design-an-interface
-description: "Generate multiple radically different interface designs using parallel sub-agents, then compare on simplicity, depth, and correctness. Based on 'Design It Twice' from Ousterhout. Use when user wants to design an API, explore interface options, compare module shapes, or mentions 'design it twice'."
+description: "Generates multiple alternative interface designs in parallel and compares them (Ousterhout 'Design It Twice'). Triggers: design API, interface options, compare modules, design it twice."
 user-invocable: true
 effort: high
 argument-hint: "[module or interface to design]"

package/app/skills/design-engineering/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: design-engineering
-description: "UI craftsmanship (Emil Kowalski school): animation frequency rules, easing curves, micro-interactions, state polish, invisible-details philosophy. Triggers: animation, transition, ease-out, ease-in-out, motion, micro-interaction, hover state, loading state, UI polish, design detail, spring curve, delightful UX. Load when building or reviewing interactive UI."
+description: "UI craftsmanship: animation rules, easing, micro-interactions, state polish. Triggers: animation, transition, ease-out, motion, micro-interaction, hover, loading state, UI polish."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/docker-devops/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: docker-devops
-description: "Docker, containers, Kubernetes, and DevOps patterns: Dockerfile best practices, multi-stage builds, compose, k8s manifests, Helm charts, service mesh, image hardening. Triggers: Docker, Dockerfile, container, image, Kubernetes, k8s, compose, Helm, registry, layer caching, service mesh, pod, deployment yaml. Load when writing or fixing container/orchestration configs."
+description: "Docker/K8s/DevOps: Dockerfile, multi-stage builds, compose, manifests, Helm, image hardening. Triggers: Docker, Dockerfile, container, Kubernetes, k8s, compose, Helm, pod, deployment yaml."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/docs/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: docs
-description: "Generate and update README, API docs, and architecture notes"
+description: "Generates/updates README, API docs, architecture notes. Triggers: docs, README, API docs, architecture note, documentation."
 user-invocable: true
 effort: high
 argument-hint: "[type: readme/api/architecture-note]"

package/app/skills/documentation-standards/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: documentation-standards
-description: "KB document conventions: YAML frontmatter (7 required fields), 5-category taxonomy (reference/howto/procedures/troubleshooting/best-practices), directory-category matching, validate.sh CI rules. Triggers: kb/, KB document, architecture note, SOP, runbook, howto, frontmatter, knowledge base entry, documentation standard. Load when creating or editing any file under kb/."
+description: "KB conventions: YAML frontmatter, 5-category taxonomy (reference/howto/procedures/troubleshooting/best-practices). Triggers: kb/, SOP, runbook, howto, frontmatter, knowledge base."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/ecommerce-patterns/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: ecommerce-patterns
-description: "E-commerce domain patterns: cart, checkout flow, payment providers (Stripe/Adyen), order state machine, inventory, promotions, tax, B2B vs B2C. Triggers: cart, checkout, product, SKU, inventory, payment, Stripe, Shopify, Medusa, Magento, order status, promotion, tax calculation, coupon, refund. Load when working on any e-commerce feature."
+description: "E-commerce: cart, checkout, payments (Stripe/Adyen), order state, inventory, promos, tax. Triggers: cart, checkout, SKU, payment, Stripe, Shopify, Medusa, Magento, coupon, refund."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/evaluate/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: evaluate
-description: "Evaluate RAG retrieval accuracy and LLM-as-a-judge quality metrics (faithfulness, relevancy, context precision) against a golden dataset. Use when the user asks to measure RAG quality or detect knowledge gaps — not for evaluating generic LLM outputs."
+description: "Evaluates RAG retrieval and LLM-as-judge metrics (faithfulness, relevancy, context precision). Triggers: measure RAG quality, knowledge gap, RAG eval, golden dataset."
 effort: medium
 disable-model-invocation: true
 argument-hint: "[--threshold N]"

package/app/skills/evolve/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: evolve
-description: "Analyzes failure patterns and inefficiencies in agent/skill definitions, then drafts and applies targeted improvements to system prompts, tool permissions, and behavioral rules. Use when the user asks to improve agent behavior, refine skill definitions, update system prompts, or optimize agent configurations based on observed failures."
+description: "Analyzes failure patterns in agents/skills and drafts targeted prompt/permission improvements. Triggers: improve agent, refine skill, update system prompt, optimize agent, fix failure pattern."
 effort: medium
 disable-model-invocation: true
 context: fork

package/app/skills/explain/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: explain
-description: "Explain code, architecture, or concepts with Mermaid diagrams and sequence flows. Use when the user asks 'what does X do' or 'how does Y work' — not to critique code quality or implement changes."
+description: "Explains code/architecture with Mermaid diagrams and sequence flows. Triggers: what does X do, how does Y work, explain code, sequence diagram."
 user-invocable: true
 effort: medium
 argument-hint: "[file or module path]"

package/app/skills/explore/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: explore
-description: "Explore codebase structure, stack, and architecture"
+description: "Explores codebase structure, stack, and architecture. Triggers: explore codebase, project structure, stack overview, architecture map."
 user-invocable: true
 effort: medium
 argument-hint: "[path or question]"

package/app/skills/fix/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: fix
-description: "Apply a targeted fix to a known bug or lint error and verify it with the same command that surfaced the problem. Use when the root cause is already identified — not for unknown symptoms or open-ended debugging."
+description: "Applies targeted fix to known bug/lint error, verifies with same command that surfaced it. Triggers: fix, apply fix, fix bug, fix lint, targeted fix."
 effort: low
 disable-model-invocation: true
 argument-hint: "[test or lint target]"

package/app/skills/flutter-patterns/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: flutter-patterns
-description: "Flutter and Dart development patterns: widget composition, state management (Riverpod/Bloc/Provider), navigation, async, platform channels, performance. Triggers: Flutter, Dart, widget, StatefulWidget, Riverpod, Bloc, Provider, pubspec, Navigator, platform channel, hot reload, StatelessWidget. Load when writing or reviewing Flutter code."
+description: "Flutter/Dart: widget composition, state mgmt (Riverpod/Bloc/Provider), navigation, platform channels. Triggers: Flutter, Dart, widget, Riverpod, Bloc, pubspec, Navigator, hot reload."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/git-mastery/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: git-mastery
-description: "Advanced Git workflows: interactive rebase, bisect, reflog, cherry-pick, worktrees, history rewriting, submodules, large-file migration (LFS/filter-repo). Triggers: git rebase, bisect, cherry-pick, reflog, force push, history rewrite, detached HEAD, merge conflict, worktree, squash, fixup, submodule. Load when user needs non-trivial Git operations."
+description: "Advanced Git: rebase, bisect, reflog, cherry-pick, worktrees, history rewriting, LFS. Triggers: git rebase, bisect, cherry-pick, reflog, force push, merge conflict, worktree, submodule."
 effort: medium
 user-invocable: false
 allowed-tools: Read, Grep, Glob

package/app/skills/golang-rules/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: golang-rules
-description: "Go coding rules from ai-toolkit: coding-style, frameworks, patterns, security, testing. Triggers: .go, go.mod, go.sum, Gin, Echo, Gorilla, testing, gofmt. Load when writing, reviewing, or editing Go code."
+description: "Go coding rules: style, patterns, security, testing. Triggers: .go, go.mod, go.sum, Gin, Echo, Gorilla, testing, gofmt."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/grill-me/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: grill-me
-description: "Stress-test a plan or design through relentless Socratic questioning, walking down each decision branch until reaching shared understanding. Use when user wants to stress-test a plan, get grilled, validate assumptions, or mentions 'grill me'."
+description: "Stress-tests a plan via Socratic questioning down each decision branch. Triggers: stress-test, grill me, validate assumptions, challenge plan, socratic review."
 user-invocable: true
 effort: medium
 argument-hint: "[plan or design to stress-test]"

package/app/skills/health/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: health
-description: "Report service and infrastructure health status via liveness/readiness checks, resource usage, and quick diagnostics. Use when the user asks whether services are up or degraded — not for deep debugging of a known error."
+description: "Service/infra health via liveness/readiness checks, resource usage, quick diagnostics. Triggers: health check, services up, system status, infra health, degraded service."
 effort: medium
 disable-model-invocation: true
 argument-hint: "[service]"

package/app/skills/hipaa-validate/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: hipaa-validate
-description: "Validate code against HIPAA policy: PHI exposure, missing audit logging, unencrypted transmission/storage, access control gaps, temp file exposure, and missing BAA references"
+description: "HIPAA validator: PHI exposure, audit logging, encryption, access control, BAA refs. Triggers: HIPAA, PHI, healthcare compliance, audit log, BAA."
 user-invocable: true
 effort: medium
 disable-model-invocation: true

package/app/skills/hive-mind/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: hive-mind
-description: "Multi-agent swarm coordination: consensus voting with confidence scores, output aggregation, file ownership, targeted vs broadcast messaging, map-reduce workflows. Triggers: swarm, hive mind, multi-agent, consensus, parallel agents, team of agents, aggregate results, agent voting, distributed agents. Load when orchestrating 3+ agents working in parallel."
+description: "Multi-agent swarm: consensus voting, output aggregation, file ownership, map-reduce. Triggers: swarm, hive mind, multi-agent, consensus, parallel agents, team of agents, agent voting."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/hook-creator/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: hook-creator
-description: "Create a new Claude Code lifecycle hook (PreToolUse, PostToolUse, Stop, SessionStart, etc.) with a bash script and hooks.json registration. Use when the user wants automated behavior tied to a specific event — not for one-off commands."
+description: "Create new Claude Code lifecycle hook (PreToolUse/PostToolUse/Stop/SessionStart) with bash + hooks.json. Triggers: create hook, lifecycle hook, PreToolUse, PostToolUse, hook event."
 effort: high
 disable-model-invocation: true
 argument-hint: "[hook event or description]"

package/app/skills/index/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: index
-description: "Reindex the knowledge base for semantic search via the configured vector store (e.g., Qdrant). Use only when the user explicitly asks to reindex — never trigger speculative rebuilds."
+description: "Reindexes KB for semantic search via vector store (Qdrant). Triggers: reindex KB, rebuild index, vector reindex, refresh embeddings."
 effort: low
 disable-model-invocation: true
 argument-hint: "[path or scope]"

package/app/skills/instinct-review/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: instinct-review
-description: "Review, promote, or remove learned instincts extracted from past sessions (`.claude/instincts/*.md`). Use when the user wants to curate the instinct list — not to extract new instincts or edit memory."
+description: "Reviews/promotes/removes instincts from `.claude/instincts/*.md`. Triggers: instinct review, curate instincts, manage instincts, promote instinct."
 effort: low
 user-invocable: true
 argument-hint: "[--list | --promote <id> | --remove <id> | --clear]"

package/app/skills/java-patterns/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: java-patterns
-description: "Java development patterns: Spring Boot, CompletableFuture, records, sealed types, streams, JPA/Hibernate, Maven/Gradle, virtual threads (Loom). Triggers: Java, Spring, Spring Boot, JPA, Hibernate, Maven, Gradle, CompletableFuture, record type, sealed class, virtual thread. Load when writing or reviewing Java code."
+description: "Java: Spring Boot, CompletableFuture, records, sealed types, JPA/Hibernate, virtual threads. Triggers: Java, Spring, JPA, Hibernate, Maven, Gradle, virtual thread, sealed class."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/java-rules/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: java-rules
-description: "Java coding rules from ai-toolkit: coding-style, frameworks, patterns, security, testing. Triggers: .java, pom.xml, build.gradle, Spring, Spring Boot, JPA, Hibernate, JUnit, Maven, Gradle. Load when writing, reviewing, or editing Java code."
+description: "Java coding rules: style, patterns, security, testing. Triggers: .java, pom.xml, build.gradle, Spring, Spring Boot, JPA, Hibernate, JUnit, Maven, Gradle."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/json-mode-patterns/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: json-mode-patterns
-description: "Loaded when user needs structured JSON output from Claude. Covers tool-use-as-JSON-mode, schema design, parsing, partial recovery, and validation."
+description: "Structured JSON output from Claude: tool-use-as-JSON, schema, parsing, partial recovery. Triggers: JSON mode, structured output, schema validation, JSON parsing."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/kotlin-patterns/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: kotlin-patterns
-description: "Kotlin development patterns: coroutines, Flow, sealed classes, data classes, extension functions, null safety, Ktor, Jetpack Compose, KMP. Triggers: Kotlin, coroutine, Flow, suspend, Ktor, Android Kotlin, Jetpack Compose, sealed class, data class, KMP, kotlinx. Load when writing or reviewing Kotlin code."
+description: "Kotlin: coroutines, Flow, sealed/data classes, null safety, Ktor, Compose, KMP. Triggers: Kotlin, coroutine, Flow, suspend, Ktor, Jetpack Compose, KMP, kotlinx."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/kotlin-rules/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: kotlin-rules
-description: "Kotlin coding rules from ai-toolkit: coding-style, frameworks, patterns, security, testing. Triggers: .kt, .kts, build.gradle.kts, Ktor, Jetpack Compose, coroutines, kotlinx. Load when writing, reviewing, or editing Kotlin code."
+description: "Kotlin coding rules: style, patterns, security, testing. Triggers: .kt, .kts, build.gradle.kts, Ktor, Jetpack Compose, coroutines, kotlinx."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/lint/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: lint
-description: "Run the project's linter and type-checker with auto-detected toolchain (ruff/mypy, eslint/tsc, phpstan, golangci-lint, clippy, dart analyze). Use when the user asks for static-analysis feedback — not to run tests or refactor."
+description: "Runs linter+typechecker with auto-detected toolchain (ruff/mypy, eslint/tsc, phpstan, golangci-lint, clippy). Triggers: lint, typecheck, static analysis."
 effort: low
 disable-model-invocation: true
 argument-hint: "[path]"

package/app/skills/mcp-builder/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mcp-builder
-description: "Build production-grade MCP (Model Context Protocol) servers from scratch using the 4-phase methodology: research, implement, test, evaluate. Use when creating new MCP integrations for external APIs, databases, or internal services."
+description: "Builds production MCP servers via 4-phase methodology: research, implement, test, evaluate. Triggers: build MCP, new MCP, MCP integration, MCP server scaffold."
 effort: high
 disable-model-invocation: true
 argument-hint: "[service name or API description]"

package/app/skills/mcp-patterns/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mcp-patterns
-description: "MCP (Model Context Protocol) server design: tool schemas, resource patterns, transport selection (stdio/SSE), client configuration, error handling, capability negotiation. Triggers: MCP, Model Context Protocol, MCP server, MCP tool, MCP resource, JSON-RPC, stdio transport, SSE transport, Claude Desktop config, Cursor MCP. Load when building or integrating MCP servers."
+description: "MCP server design: tool schemas, resources, stdio/SSE transports, capability negotiation. Triggers: MCP, Model Context Protocol, MCP server, JSON-RPC, stdio, SSE, Claude Desktop config."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/medplum-rules/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: medplum-rules
-description: "Medplum (FHIR healthcare) coding rules from ai-toolkit: coding-style, frameworks, patterns, security, testing. Triggers: medplum.config.mts, medplum.config.ts, FHIR, Medplum, Bot, Subscription, Questionnaire. Load when writing, reviewing, or editing Medplum (FHIR healthcare) code."
+description: "Medplum (FHIR healthcare) coding rules: style, patterns, security, testing. Triggers: medplum.config.mts, medplum.config.ts, FHIR, Medplum, Bot, Subscription, Questionnaire."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/mem-search/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mem-search
-description: "Search past coding sessions using natural language. Finds relevant observations, decisions, and context from previous work."
+description: "Searches past coding sessions for observations, decisions, context. Triggers: mem-search, recall session, past work, prior decisions, session history."
 effort: medium
 argument-hint: "[search query]"
 allowed-tools: Bash, Read

package/app/skills/migrate/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: migrate
-description: "Run or create database migrations with the detected tool (Alembic, Prisma, Laravel, Django, Flyway, Drizzle) and verify backups exist first. Use when the user asks to apply, roll back, or generate a migration — not for general schema design."
+description: "Run/create DB migrations with detected tool (Alembic, Prisma, Laravel, Django, Flyway, Drizzle), checks backup. Triggers: apply migration, rollback, generate migration, db migration."
 effort: medium
 disable-model-invocation: true
 argument-hint: "[direction]"

package/app/skills/migration-patterns/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: migration-patterns
-description: "Zero-downtime database migration patterns: expand-contract, double-write, backfill, blue-green schema changes, feature flags, rollback safety, online DDL. Triggers: migration, schema change, zero-downtime, expand-contract, double-write, backfill, ALTER TABLE, column rename, safe deploy, online DDL. Load when planning non-trivial DB schema changes."
+description: "Zero-downtime DB migrations: expand-contract, double-write, backfill, blue-green schema. Triggers: migration, schema change, zero-downtime, backfill, ALTER TABLE, online DDL, safe deploy."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/model-routing-patterns/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: model-routing-patterns
-description: "Loaded when user builds multi-model pipelines (Haiku/Sonnet/Opus). Covers cost-optimized routing, escalation, sub-agent delegation, and fallback chains."
+description: "Multi-model pipelines (Haiku/Sonnet/Opus): cost routing, escalation, fallback chains. Triggers: model routing, Haiku, Sonnet, Opus, escalation, fallback chain."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/night-watch/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: night-watch
-description: "Run autonomous maintenance tasks (dependency updates, dead code removal, small refactors) in an isolated branch. Use only when the user triggers it explicitly — typically off-hours; never auto-invoked."
+description: "Autonomous maintenance (dep updates, dead code, small refactors) in isolated branch, off-hours. Triggers: night watch, autonomous maintenance, dep updates."
 effort: medium
 disable-model-invocation: true
 context: fork

package/app/skills/observability-patterns/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: observability-patterns
-description: "Observability: structured logging, metrics (RED/USE/four golden signals), distributed tracing (OpenTelemetry), correlation IDs, log aggregation, SLO/SLI. Triggers: logging, log level, metrics, Prometheus, Grafana, OpenTelemetry, trace, span, structured log, observability, monitoring, SLO, SLI, alerting. Load when adding or reviewing logs, metrics, or traces."
+description: "Observability: structured logs, metrics (RED/USE), tracing (OpenTelemetry), SLO/SLI. Triggers: logging, metrics, Prometheus, Grafana, OpenTelemetry, trace, span, monitoring, alerting."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/onboard/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: onboard
-description: "Guide setup of ai-toolkit in a new project: install symlinks, create CLAUDE.md, capture undocumented intent via interview. Use when the user starts a fresh project or migrates an existing one to ai-toolkit."
+description: "Sets up ai-toolkit in a project: symlinks, CLAUDE.md, intent interview. Triggers: onboard, setup project, install ai-toolkit, migrate project."
 effort: medium
 disable-model-invocation: true
 argument-hint: "[project-path]"

package/app/skills/orchestrate/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: orchestrate
-description: "Coordinate multiple specialized agents in parallel"
+description: "Coordinates multiple specialized agents in parallel. Triggers: orchestrate, multi-agent, parallel agents, coordinate agents."
 user-invocable: true
 effort: max
 argument-hint: "[task]"

package/app/skills/panic/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: panic
-description: "Emergency kill switch that halts all agent activity via a lockfile gate. Use when agents are looping, misbehaving, or the user wants to stop everything NOW — not for normal workflow interruptions."
+description: "Emergency kill switch — halts all agents via lockfile gate. Triggers: panic, stop everything, kill switch, halt agents, agents looping."
 effort: low
 disable-model-invocation: true
 agent: system-governor

package/app/skills/performance-profiling/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: performance-profiling
-description: "Performance measurement and optimization: four golden signals (latency/traffic/errors/saturation), p50/p95/p99, baseline-change-measure loop, flame graphs, load testing. Triggers: performance, slow, latency, p99, flame graph, profile, bottleneck, optimization, load test, benchmark, CPU profiling, memory leak. Load when diagnosing or optimizing slow code or services."
+description: "Performance: golden signals (latency/traffic/errors/saturation), p50/p95/p99, flame graphs, load testing. Triggers: performance, slow, latency, p99, flame graph, bottleneck, load test, memory leak."
 effort: medium
 allowed-tools: Read, Grep
 user-invocable: false

package/app/skills/persona/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: persona
-description: "Switch engineering persona at runtime: backend-lead, frontend-lead, devops-eng, junior-dev"
+description: "Switches engineering persona at runtime. Triggers: persona, switch role, backend-lead, frontend-lead, devops-eng, junior-dev."
 effort: low
 user-invocable: true
 argument-hint: "[backend-lead | frontend-lead | devops-eng | junior-dev | --list | --clear]"

package/app/skills/php-rules/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: php-rules
-description: "PHP coding rules from ai-toolkit: coding-style, frameworks, patterns, security, testing. Triggers: .php, composer.json, Laravel, Symfony, PHPUnit, PSR-12, Composer. Load when writing, reviewing, or editing PHP code."
+description: "PHP coding rules: style, patterns, security, testing. Triggers: .php, composer.json, Laravel, Symfony, PHPUnit, PSR-12, Composer."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/plan/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: plan
-description: "Breaks down feature requests and project goals into phased implementation plans with task lists, agent assignments, dependency graphs, and success criteria. Use when the user asks to plan a feature, create an implementation roadmap, break down a coding task, or outline project phases."
+description: "Breaks features/goals into phased plans with task lists, agent assignments, dependencies. Triggers: plan feature, implementation roadmap, break down task, project phases."
 user-invocable: true
 effort: high
 argument-hint: "[goal]"

package/app/skills/plan-writing/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: plan-writing
-description: "Implementation plan and pre-mortem drafting: phase breakdown, success criteria, risks, rollback plan, acceptance tests, estimated effort. Triggers: implementation plan, pre-mortem, phased plan, project plan, task breakdown, success criteria, rollback strategy, risk register. Load when user asks to write a plan or pre-mortem document."
+description: "Implementation plans + pre-mortems: phases, success criteria, risks, rollback, acceptance tests. Triggers: implementation plan, pre-mortem, phased plan, task breakdown, risk register."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/plugin-creator/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: plugin-creator
-description: "Creates experimental opt-in plugin packs with manifests, conventions, and optional module scaffolding for Claude and Codex runtimes"
+description: "Creates opt-in plugin packs with manifests + module scaffolding for Claude/Codex. Triggers: new plugin, plugin pack, plugin scaffold."
 effort: high
 disable-model-invocation: true
 argument-hint: "[plugin pack name or domain]"

package/app/skills/pr/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pr
-description: "Create a GitHub pull request after running pre-flight checks (lint, typecheck, tests) and generating a structured summary from commit history. Use when the branch is ready to merge — not for drafting work-in-progress."
+description: "Creates GitHub PR after pre-flight checks (lint/typecheck/tests), structured summary from commits. Triggers: pr, pull request, create PR, ready to merge."
 effort: medium
 disable-model-invocation: true
 argument-hint: "[title or branch]"

package/app/skills/prd-to-issues/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: prd-to-issues
-description: "Break a PRD into independently-grabbable GitHub issues using vertical slices with HITL/AFK tagging and dependency ordering. Use when user wants to convert a PRD to issues, create tickets, or break down a PRD into work items."
+description: "Splits a PRD into vertical-slice GitHub issues with HITL/AFK tagging and dependencies. Triggers: PRD to issues, create tickets, break down PRD, work items."
 effort: medium
 disable-model-invocation: true
 argument-hint: "[PRD issue number]"

package/app/skills/prd-to-plan/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: prd-to-plan
-description: "Convert a PRD into a phased implementation plan using tracer-bullet vertical slices. Use when user wants to break down a PRD, create an implementation plan, plan phases from a PRD, or mentions tracer bullets."
+description: "Converts PRD into phased plan via tracer-bullet vertical slices. Triggers: PRD to plan, break down PRD, implementation plan, tracer bullets, phased plan."
 user-invocable: true
 effort: high
 argument-hint: "[PRD issue number or paste PRD]"

package/app/skills/predict/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: predict
-description: "Analyzes code diffs and file changes to identify potential regressions, maps dependency impact across the codebase, and generates a risk-scored impact report. Use when reviewing pull requests, assessing code change risk, checking for breaking changes, or analyzing the blast radius of a diff."
+description: "Analyzes diffs for regression risk and blast radius, generates risk-scored impact report. Triggers: PR review, code change risk, breaking change, blast radius, regression check."
 effort: medium
 disable-model-invocation: true
 argument-hint: "[change description]"

package/app/skills/prompt-caching-patterns/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: prompt-caching-patterns
-description: "Loaded when user builds with Anthropic API and needs to cut cost or latency via prompt caching. Covers TTL, cache breakpoints, stacking, invalidation, and measuring hit rate."
+description: "Anthropic API prompt caching: TTL, breakpoints, stacking, invalidation, hit rate. Triggers: prompt caching, cache_control, cache breakpoint, cache TTL, hit rate."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/python-rules/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: python-rules
-description: "Python coding rules from ai-toolkit: coding-style, frameworks, patterns, security, testing. Triggers: .py, .pyi, pyproject.toml, requirements.txt, Pipfile, FastAPI, Django, Flask, pytest, SQLAlchemy, ruff, mypy. Load when writing, reviewing, or editing Python code."
+description: "Python coding rules: style, patterns, security, testing. Triggers: .py, .pyi, pyproject.toml, requirements.txt, Pipfile, FastAPI, Django, Flask, pytest, SQLAlchemy, ruff, mypy."
 effort: medium
 user-invocable: false
 allowed-tools: Read

package/app/skills/qa-session/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: qa-session
-description: "Interactive QA session where user reports bugs conversationally and agent files GitHub issues with domain language. Explores codebase in background for context. Use when user wants to report bugs, do QA, file issues conversationally, or mentions QA session."
+description: "Interactive QA: user reports bugs conversationally, agent files GitHub issues. Triggers: QA session, report bug, file issue, conversational QA, bug intake."
 user-invocable: true
 effort: high
 argument-hint: "[area to QA or first bug report]"