diff --git a/plugins/copilot-preset/skills/copilot-preset/SKILL.md b/plugins/copilot-preset/skills/copilot-preset/SKILL.md index 7ac7fea..9f1a754 100644 --- a/plugins/copilot-preset/skills/copilot-preset/SKILL.md +++ b/plugins/copilot-preset/skills/copilot-preset/SKILL.md @@ -1,10 +1,6 @@ --- name: copilot-preset -description: >- - How this OMP workspace is wired to GitHub Copilot models. Use when the user - asks which model is running, how to switch Copilot models, about AI-credit / - token billing, which model is cheapest, MAI-Code-1-Flash ("MIA Coding"), or - how to run the dev-team cheaply on their Copilot license. +description: "How this OMP workspace is wired to GitHub Copilot models. Use when the user asks which model is running, how to switch Copilot models, about AI-credit/token billing, which model is cheapest, MAI-Code-1-Flash (\"MIA Coding\"), or how to run the dev-team cheaply on their Copilot license." --- # GitHub Copilot model preset diff --git a/plugins/dev-team/skills/add-plugin/SKILL.md b/plugins/dev-team/skills/add-plugin/SKILL.md index 9a604e4..816a96f 100644 --- a/plugins/dev-team/skills/add-plugin/SKILL.md +++ b/plugins/dev-team/skills/add-plugin/SKILL.md @@ -1,10 +1,6 @@ --- name: add-plugin -description: >- - Install a Oh-My-Pi (OMP) plugin and register it in settings.json so the - full team can replicate the install. Use this whenever adding a new - plugin to the project — it keeps settings.json in sync with what is - actually installed. +description: "Install an Oh-My-Pi (OMP) plugin and register it in settings.json so the team can replicate the install. Use whenever adding a new plugin to the project — it keeps settings.json in sync with what is installed." argument-hint: >- [--repo ] user-invocable: true diff --git a/plugins/dev-team/skills/adr-tools/SKILL.md b/plugins/dev-team/skills/adr-tools/SKILL.md index 6e5a6a8..bb80153 100644 --- a/plugins/dev-team/skills/adr-tools/SKILL.md +++ b/plugins/dev-team/skills/adr-tools/SKILL.md @@ -1,13 +1,6 @@ --- name: adr-tools -description: >- - Create and manage Architecture Decision Records using the adr-tools CLI - (https://github.com/npryce/adr-tools). Use when the user asks to "add an ADR", - "record this decision", "create an ADR", "supersede ADR N", "link ADRs", - "generate the ADR table of contents", or any request involving the `adr` - command. Pairs with the adr-author agent — this skill is the mechanics - (commands, files, links); adr-author is the decision framework (when an ADR is - warranted) and the prose authoring. +description: "Create and manage Architecture Decision Records via the adr-tools CLI (https://github.com/npryce/adr-tools). Use when the user asks to \"add an ADR\", \"record this decision\", \"create an ADR\", \"supersede ADR N\", \"link ADRs\", \"generate the ADR table of contents\", or any request involving the `adr` command. Pairs with the adr-author agent: this skill is the mechanics (commands, files, links); adr-author is the decision framework and prose." role: worker user-invocable: true --- diff --git a/plugins/dev-team/skills/agent-add/SKILL.md b/plugins/dev-team/skills/agent-add/SKILL.md index b5ccdfd..b08ad15 100644 --- a/plugins/dev-team/skills/agent-add/SKILL.md +++ b/plugins/dev-team/skills/agent-add/SKILL.md @@ -1,12 +1,6 @@ --- name: agent-add -description: >- - Create a new Oh-My-Pi (OMP) agent file (review or team type) following the - official sub-agent schema and token-efficiency budgets. Use when the user - wants to add a new review agent, detect a new category of code issue, create - a team agent persona, or says things like "add an agent for X", "create a - reviewer for Y", "new team agent for Z". Also use when given a URL to a - coding standard that should become a review agent. +description: "Create a new Oh-My-Pi (OMP) agent file (review or team type) following the official sub-agent schema and token-efficiency budgets. Use when the user wants to add a review agent, detect a new category of code issue, or create a team-agent persona: \"add an agent for X\", \"create a reviewer for Y\", \"new team agent for Z\". Also use when given a URL to a coding standard that should become a review agent." argument-hint: >- [--name ] [--type review|team] [--tier small|mid|frontier] [--context diff-only|full-file|project-structure] diff --git a/plugins/dev-team/skills/agent-audit/SKILL.md b/plugins/dev-team/skills/agent-audit/SKILL.md index a1d3dc2..a9a4609 100644 --- a/plugins/dev-team/skills/agent-audit/SKILL.md +++ b/plugins/dev-team/skills/agent-audit/SKILL.md @@ -1,11 +1,6 @@ --- name: agent-audit -description: >- - Audit code-review agents, skills, and hooks for structural compliance. - Use this when adding or modifying any agent, skill, or hook file, or for - a periodic health check of the toolkit. Trigger phrases: "audit the - agents", "check compliance", "validate the skills", "are the agents - correct", or any time agent/skill files change. +description: "Audit code-review agents, skills, and hooks for structural compliance. Use when adding or modifying any agent, skill, or hook file, or for a periodic health check: \"audit the agents\", \"check compliance\", \"validate the skills\", \"are the agents correct\", or any time agent/skill files change." argument-hint: "[file-path | --all] [--fix]" user-invocable: true allowed-tools: read, edit, search, find diff --git a/plugins/dev-team/skills/agent-create/SKILL.md b/plugins/dev-team/skills/agent-create/SKILL.md index acaff50..d86c8df 100644 --- a/plugins/dev-team/skills/agent-create/SKILL.md +++ b/plugins/dev-team/skills/agent-create/SKILL.md @@ -1,13 +1,6 @@ --- name: agent-create -description: >- - Create new Oh-My-Pi (OMP) sub-agent files following the official schema and - token-efficiency budgets. Handles both review agents (JSON output, read-only - tools, ≤ 40-line body) and team agents (prose output, action tools, ≤ 75-line - body). Use when the user says "add an agent", "create a reviewer for X", - "new team agent for Y", or when /agent-add is invoked. Validates against - /agent-audit before writing. Updates the agent registry and CLAUDE.md after - success. +description: "Create new Oh-My-Pi (OMP) sub-agent files following the official schema and token-efficiency budgets — review agents (JSON output, read-only tools, ≤ 40-line body) and team agents (prose output, action tools, ≤ 75-line body). Use when the user says \"add an agent\", \"create a reviewer for X\", \"new team agent for Y\", or when /agent-add is invoked. Validates against /agent-audit before writing, then updates the agent registry and CLAUDE.md." role: worker user-invocable: true --- diff --git a/plugins/dev-team/skills/agent-eval/SKILL.md b/plugins/dev-team/skills/agent-eval/SKILL.md index da6ec35..b448faf 100644 --- a/plugins/dev-team/skills/agent-eval/SKILL.md +++ b/plugins/dev-team/skills/agent-eval/SKILL.md @@ -1,10 +1,6 @@ --- name: agent-eval -description: >- - Run eval fixtures against review agents and grade results. Use this after - adding or modifying a review agent, to validate detection accuracy, or - when the user says "run the evals", "test the agents", "check for - regressions", or "how accurate is the agent". +description: "Run eval fixtures against review agents and grade results. Use after adding or modifying a review agent, to validate detection accuracy, or when the user says \"run the evals\", \"test the agents\", \"check for regressions\", or \"how accurate is the agent\"." argument-hint: "[--agent ] [--skill ] [--fixture ] [--trials ] [--verbose]" user-invocable: true allowed-tools: >- diff --git a/plugins/dev-team/skills/agent-readiness/SKILL.md b/plugins/dev-team/skills/agent-readiness/SKILL.md index d205eb7..67e3432 100644 --- a/plugins/dev-team/skills/agent-readiness/SKILL.md +++ b/plugins/dev-team/skills/agent-readiness/SKILL.md @@ -1,10 +1,6 @@ --- name: agent-readiness -description: >- - Score how ready the current repository is for AI-assisted development against - the Agent-Readiness Scorecard. Use when the user asks "how agent-ready is this - repo", "score this repo for agents", "agent readiness", or wants a tiered - readiness report. +description: "Score how ready the current repository is for AI-assisted development against the Agent-Readiness Scorecard. Use when the user asks \"how agent-ready is this repo\", \"score this repo for agents\", \"agent readiness\", or wants a tiered readiness report." argument-hint: "[repo-path] [--json ] [--markdown ]" user-invocable: true allowed-tools: >- diff --git a/plugins/dev-team/skills/agent-remove/SKILL.md b/plugins/dev-team/skills/agent-remove/SKILL.md index 60ac698..ac28c7a 100644 --- a/plugins/dev-team/skills/agent-remove/SKILL.md +++ b/plugins/dev-team/skills/agent-remove/SKILL.md @@ -1,11 +1,6 @@ --- name: agent-remove -description: >- - Remove an agent from the system — deletes the agent file, cleans up all - registry entries, removes cross-references, and updates documentation. - Use when the user says "remove the X agent", "delete X-review", "retire - the X role", or "we no longer need X". Handles both team agents and review - agents. Always confirms before deleting. +description: "Remove an agent — deletes the agent file, cleans up registry entries and cross-references, and updates docs. Use when the user says \"remove the X agent\", \"delete X-review\", \"retire the X role\", or \"we no longer need X\". Handles team and review agents; always confirms before deleting." argument-hint: " [--dry]" user-invocable: true allowed-tools: read, edit, bash(rm *), bash(ls *), bash(git rm *), bash(grep -r *), find, search diff --git a/plugins/dev-team/skills/agent-skill-authoring/SKILL.md b/plugins/dev-team/skills/agent-skill-authoring/SKILL.md index b04827e..1e4adfb 100644 --- a/plugins/dev-team/skills/agent-skill-authoring/SKILL.md +++ b/plugins/dev-team/skills/agent-skill-authoring/SKILL.md @@ -1,6 +1,6 @@ --- name: agent-skill-authoring -description: Conventions, anti-patterns, and meta-patterns for writing skills (and the shared agent/skill philosophy). Use when creating or editing a SKILL.md file, or when reviewing the agent-vs-skill separation. For the procedural workflow that generates a new agent file, use the agent-create skill (invoked by /agent-add). +description: "Conventions, anti-patterns, and meta-patterns for writing skills (and the shared agent/skill philosophy). Use when creating or editing a SKILL.md file, or reviewing the agent-vs-skill separation. For the procedural workflow that generates a new agent file, use the agent-create skill (invoked by /agent-add)." role: worker user-invocable: true --- diff --git a/plugins/dev-team/skills/apply-fixes/SKILL.md b/plugins/dev-team/skills/apply-fixes/SKILL.md index 5e9bd69..efb197d 100644 --- a/plugins/dev-team/skills/apply-fixes/SKILL.md +++ b/plugins/dev-team/skills/apply-fixes/SKILL.md @@ -1,10 +1,6 @@ --- name: apply-fixes -description: >- - Apply correction prompts generated by /code-review. Use this whenever the - user wants to apply, fix, or action the results of a code review — phrases - like "apply the fixes", "fix the issues", "apply corrections", or after - /code-review has run and produced a corrections/ directory. +description: "Apply correction prompts generated by /code-review. Use when the user wants to apply or action review results: \"apply the fixes\", \"fix the issues\", \"apply corrections\", or after /code-review has produced a corrections/ directory." argument-hint: " [--dry] [--skip-tests] [--skip-build] [--skip-lint]" user-invocable: true allowed-tools: read, edit, search, find, bash(git diff *, npm run *, npx *, yarn *, pnpm *) diff --git a/plugins/dev-team/skills/benchmark/SKILL.md b/plugins/dev-team/skills/benchmark/SKILL.md index 7b078fa..ccadd74 100644 --- a/plugins/dev-team/skills/benchmark/SKILL.md +++ b/plugins/dev-team/skills/benchmark/SKILL.md @@ -1,10 +1,6 @@ --- name: benchmark -description: >- - Capture runtime performance metrics (Core Web Vitals, resource sizes, load - times) for web pages. Compare against baselines and performance budgets. - Use when the user says "benchmark", "check performance", "page speed", - "web vitals", "performance regression", or "how fast is this page". +description: "Capture runtime performance metrics (Core Web Vitals, resource sizes, load times) for web pages and compare against baselines and budgets. Use when the user says \"benchmark\", \"check performance\", \"page speed\", \"web vitals\", \"performance regression\", or \"how fast is this page\"." argument-hint: " [--baseline] [--budget] [--trend] [--mobile] [--3g] [--runs ]" user-invocable: true allowed-tools: read, write, find, search, bash(npx playwright *), bash(node *), bash(mkdir *), bash(date *), bash(cat *) diff --git a/plugins/dev-team/skills/branch-workflow/SKILL.md b/plugins/dev-team/skills/branch-workflow/SKILL.md index 6cc9738..680dd65 100644 --- a/plugins/dev-team/skills/branch-workflow/SKILL.md +++ b/plugins/dev-team/skills/branch-workflow/SKILL.md @@ -1,6 +1,6 @@ --- name: branch-workflow -description: Clean branch completion workflow — PR creation, merge strategy, and cleanup. Use this skill when implementation is complete and it's time to ship — after Phase 3 human gate passes. Also use when the user says "create a PR", "merge this", "ship it", "finish this branch", or asks about merge strategy. +description: "Clean branch-completion workflow — PR creation, merge strategy, and cleanup. Use when implementation is complete and it's time to ship (after the Phase 3 human gate), or when the user says \"create a PR\", \"merge this\", \"ship it\", \"finish this branch\", or asks about merge strategy." role: worker user-invocable: true --- diff --git a/plugins/dev-team/skills/build/SKILL.md b/plugins/dev-team/skills/build/SKILL.md index a89960f..55c2930 100644 --- a/plugins/dev-team/skills/build/SKILL.md +++ b/plugins/dev-team/skills/build/SKILL.md @@ -1,10 +1,6 @@ --- name: build -description: >- - Execute an approved implementation plan using TDD. Reads the plan, implements - each step with RED-GREEN-REFACTOR, runs inline review checkpoints, and - produces verification evidence. Use when the user says "build this", "implement - the plan", "start building", or after /plan has been approved. +description: "Execute an approved implementation plan using TDD — read the plan, implement each step with RED-GREEN-REFACTOR, run inline review checkpoints, and produce verification evidence. Use when the user says \"build this\", \"implement the plan\", \"start building\", or after /plan is approved." argument-hint: "[--plan ]" user-invocable: true allowed-tools: read, write, edit, find, search, bash, task, ask diff --git a/plugins/dev-team/skills/cd-test-architecture/SKILL.md b/plugins/dev-team/skills/cd-test-architecture/SKILL.md index 8fbde63..c1225a6 100644 --- a/plugins/dev-team/skills/cd-test-architecture/SKILL.md +++ b/plugins/dev-team/skills/cd-test-architecture/SKILL.md @@ -1,6 +1,6 @@ --- name: cd-test-architecture -description: Evaluate an existing application's tests and recommend a CD-pipeline-aligned test architecture — fast, deterministic tests with minimal tooling that fully validate behavior (including cross-service interaction) and run in CI without configuring the rest of the system. Use when the user says "evaluate how this app is tested", "design a test architecture", "align our tests for CD", "make our CI tests deterministic", "our tests need the whole system configured", "our tests live in another repo / Postman / manual scripts", or asks for UI/service/batch test patterns. +description: "Evaluate an existing app's tests and recommend a CD-pipeline-aligned test architecture — fast, deterministic, minimal-tooling tests that fully validate behavior (including cross-service) and run in CI without standing up the rest of the system. Use when the user says \"evaluate how this app is tested\", \"design a test architecture\", \"align our tests for CD\", \"make our CI tests deterministic\", \"our tests need the whole system configured\", \"our tests live in another repo / Postman / manual scripts\", or asks for UI/service/batch test patterns." role: worker user-invocable: true --- diff --git a/plugins/dev-team/skills/ci-debugging/SKILL.md b/plugins/dev-team/skills/ci-debugging/SKILL.md index fef1b61..8540c2d 100644 --- a/plugins/dev-team/skills/ci-debugging/SKILL.md +++ b/plugins/dev-team/skills/ci-debugging/SKILL.md @@ -1,6 +1,6 @@ --- name: ci-debugging -description: Systematic CI/CD failure diagnosis with hypothesis-first approach, environment delta analysis, and anti-patterns. Use when CI fails, pipelines break, or the user says "CI is failing", "build broke", "pipeline error", or "tests pass locally but fail in CI". +description: "Systematic CI/CD failure diagnosis — hypothesis-first, environment-delta analysis, and anti-patterns. Use when CI fails or the user says \"CI is failing\", \"build broke\", \"pipeline error\", or \"tests pass locally but fail in CI\"." role: worker user-invocable: true --- diff --git a/plugins/dev-team/skills/code-review/SKILL.md b/plugins/dev-team/skills/code-review/SKILL.md index 01faf13..edf35b6 100644 --- a/plugins/dev-team/skills/code-review/SKILL.md +++ b/plugins/dev-team/skills/code-review/SKILL.md @@ -1,11 +1,6 @@ --- name: code-review -description: >- - Run all enabled review agents against target files. Use this whenever the - user asks for a code review, wants feedback on their code, says "review my - code", "check this before I PR", "what's wrong with this", "run the - agents", or has just finished implementing a feature. Use proactively - before commits and pull requests. +description: "Run all enabled review agents against target files. Use whenever the user asks for a code review or feedback: \"review my code\", \"check this before I PR\", \"what's wrong with this\", \"run the agents\", or has just finished implementing a feature. Use proactively before commits and pull requests." argument-hint: >- [--agent ] [--since ] [--path ] [--all] [--json] [--force --reason ""] [--static-analysis|--no-static-analysis] diff --git a/plugins/dev-team/skills/competitive-analysis/SKILL.md b/plugins/dev-team/skills/competitive-analysis/SKILL.md index d226ae9..7f8ce4f 100644 --- a/plugins/dev-team/skills/competitive-analysis/SKILL.md +++ b/plugins/dev-team/skills/competitive-analysis/SKILL.md @@ -1,19 +1,6 @@ --- name: competitive-analysis -description: >- - Compare this plugin against external plugins, tools, feature sets, or ideas to - find gaps and weaknesses. Produces a structured gap analysis report with rough - specs for closing each gap. Use this skill whenever the user references - capabilities from OUTSIDE the plugin — another plugin they found, a competitor's - tool, a feature list from a different project, a repo URL, or a hypothetical - concept for capabilities we lack. Trigger phrases include "how do we compare - to X", "what does Y have that we don't", "what are we missing", "gap analysis", - "competitive analysis", "weaknesses compared to", "stack up against", - "where do we fall short", and "should we add X — I saw it in another tool". - Also trigger when the user pastes a feature list or describes capabilities - they saw elsewhere and asks whether we should have them. Do NOT trigger for - internal operations like running reviews, auditing our own agents, adding - skills, threat modeling, domain analysis, or debugging — those use other skills. +description: "Compare this plugin against external plugins, tools, or feature sets to find gaps and weaknesses; produces a structured gap-analysis report with rough specs to close each gap. Use when the user references capabilities from OUTSIDE the plugin (a competitor tool, a pasted feature list, a repo URL, or \"should we add X — I saw it in another tool\"): \"how do we compare to X\", \"what does Y have that we don't\", \"what are we missing\", \"gap analysis\", \"competitive analysis\", \"weaknesses compared to\", \"stack up against\", \"where do we fall short\". Do NOT trigger for internal ops (reviews, agent audits, adding skills, threat modeling, domain analysis, debugging)." role: orchestrator user-invocable: true --- diff --git a/plugins/dev-team/skills/continue/SKILL.md b/plugins/dev-team/skills/continue/SKILL.md index c7d3752..1469637 100644 --- a/plugins/dev-team/skills/continue/SKILL.md +++ b/plugins/dev-team/skills/continue/SKILL.md @@ -1,10 +1,6 @@ --- name: continue -description: >- - Resume work from a prior session by reading phase progress files in memory/ - and active plans. Use this when starting a new session on in-progress work, - or when the user says "continue", "pick up where I left off", "resume", - or "what was I working on". +description: "Resume work from a prior session by reading phase-progress files in memory/ and active plans. Use when starting a new session on in-progress work, or when the user says \"continue\", \"pick up where I left off\", \"resume\", or \"what was I working on\"." argument-hint: "" user-invocable: true allowed-tools: read, find, search, bash(git log *), bash(git branch *), bash(git status *), bash(git diff *), bash(ls *) diff --git a/plugins/dev-team/skills/cost-report/SKILL.md b/plugins/dev-team/skills/cost-report/SKILL.md index d716f34..47e2962 100644 --- a/plugins/dev-team/skills/cost-report/SKILL.md +++ b/plugins/dev-team/skills/cost-report/SKILL.md @@ -1,10 +1,6 @@ --- name: cost-report -description: >- - Report actual token spend and dollar cost of dispatched work — per agent and - total — and flag cost regressions. Use when the user asks "how much did that - cost", "token spend", "cost of this run", "cost report", or wants to check for - a cost regression after /code-review or an orchestration run. +description: "Report actual token spend and dollar cost of dispatched work — per agent and total — and flag cost regressions. Use when the user asks \"how much did that cost\", \"token spend\", \"cost of this run\", \"cost report\", or wants to check for a cost regression after /code-review or an orchestration run." argument-hint: "[--transcript ] [--tolerance ]" user-invocable: true allowed-tools: >- diff --git a/plugins/dev-team/skills/design-doc/SKILL.md b/plugins/dev-team/skills/design-doc/SKILL.md index 193db94..ebda652 100644 --- a/plugins/dev-team/skills/design-doc/SKILL.md +++ b/plugins/dev-team/skills/design-doc/SKILL.md @@ -1,6 +1,6 @@ --- name: design-doc -description: Produce a written design document in docs/specs/ with user approval before planning begins. Use this skill during the Research phase when a feature request, architectural change, or non-trivial task enters the pipeline. Ensures misunderstandings are caught before any planning or implementation work starts. Also use when the user says "brainstorm", "design", "spec", or "let's think through this". +description: "Produce a written design document in docs/specs/ with user approval before planning begins. Use during the Research phase when a feature request, architectural change, or non-trivial task enters the pipeline, so misunderstandings are caught before planning or implementation. Also use when the user says \"brainstorm\", \"design\", \"spec\", or \"let's think through this\"." role: worker user-invocable: true --- diff --git a/plugins/dev-team/skills/design-interrogation/SKILL.md b/plugins/dev-team/skills/design-interrogation/SKILL.md index bfed9fb..d9b0ea5 100644 --- a/plugins/dev-team/skills/design-interrogation/SKILL.md +++ b/plugins/dev-team/skills/design-interrogation/SKILL.md @@ -1,13 +1,6 @@ --- name: design-interrogation -description: >- - Relentlessly interview the user about a plan, design, or feature spec to - surface unresolved decisions, hidden assumptions, and edge cases. Use when - the user says "grill me", "stress-test this plan", "poke holes in my design", - "what am I missing", or before committing to a plan that feels under-examined. - Unlike /specs (which produces artifacts) this skill produces clarity — it's a - thinking tool. Also use proactively in the Research phase when a design doc - has implicit decisions that need to be made explicit. +description: "Relentlessly interview the user about a plan, design, or feature spec to surface unresolved decisions, hidden assumptions, and edge cases. Use when the user says \"grill me\", \"stress-test this plan\", \"poke holes in my design\", \"what am I missing\", or before committing to an under-examined plan. Unlike /specs (which produces artifacts) this produces clarity — a thinking tool. Also use proactively in the Research phase when a design doc has implicit decisions to make explicit." role: worker user-invocable: true --- diff --git a/plugins/dev-team/skills/design-it-twice/SKILL.md b/plugins/dev-team/skills/design-it-twice/SKILL.md index 56723e9..2548a23 100644 --- a/plugins/dev-team/skills/design-it-twice/SKILL.md +++ b/plugins/dev-team/skills/design-it-twice/SKILL.md @@ -1,12 +1,6 @@ --- name: design-it-twice -description: >- - Generate multiple radically different interface designs for a module using - parallel sub-agents, then compare and synthesize. Based on Ousterhout's - "Design It Twice" principle. Use when the user wants to explore interface - options, design an API, compare module shapes, or says "design it twice", - "what are my options", or "show me alternatives". Also use when the Architect - agent is designing a new module boundary or public interface. +description: "Generate multiple radically different interface designs for a module using parallel sub-agents, then compare and synthesize (Ousterhout's \"Design It Twice\"). Use when the user wants to explore interface options, design an API, or compare module shapes: \"design it twice\", \"what are my options\", \"show me alternatives\". Also use when the Architect agent is designing a new module boundary or public interface." role: worker user-invocable: true --- diff --git a/plugins/dev-team/skills/docker-image-audit/SKILL.md b/plugins/dev-team/skills/docker-image-audit/SKILL.md index 498e17a..ae3e88f 100644 --- a/plugins/dev-team/skills/docker-image-audit/SKILL.md +++ b/plugins/dev-team/skills/docker-image-audit/SKILL.md @@ -1,6 +1,6 @@ --- name: docker-image-audit -description: Audit Docker images and Dockerfiles for security vulnerabilities, bloat, and best-practice violations using hadolint, Trivy, and Grype. Produces a structured severity report with actionable fixes. Use this skill whenever the user wants to check a Docker image for security issues, scan a container for vulnerabilities, audit a Dockerfile, harden a Docker image, reduce image size, minimize attack surface, check for CVEs in a container, or says things like "is this Dockerfile secure?", "scan my image", "check my container for vulnerabilities", "how can I make this image smaller?", "audit my Docker setup", or "harden this container". Also trigger when the user has just created or modified a Dockerfile and wants validation before shipping it. +description: "Audit Docker images and Dockerfiles for security vulnerabilities, bloat, and best-practice violations using hadolint, Trivy, and Grype; produces a structured severity report with actionable fixes. Use when the user wants to scan or harden a Docker image or audit a Dockerfile: \"is this Dockerfile secure?\", \"scan my image\", \"check my container for vulnerabilities\", \"how can I make this image smaller?\", \"audit my Docker setup\", \"harden this container\". Also trigger right after a Dockerfile is created or modified and wants validation before shipping." user-invocable: true --- diff --git a/plugins/dev-team/skills/docker-image-create/SKILL.md b/plugins/dev-team/skills/docker-image-create/SKILL.md index 9da3773..af61baa 100644 --- a/plugins/dev-team/skills/docker-image-create/SKILL.md +++ b/plugins/dev-team/skills/docker-image-create/SKILL.md @@ -1,6 +1,6 @@ --- name: docker-image-create -description: Generate production-ready Dockerfiles from project source code. Detects language/framework automatically and produces multi-stage builds with minimal, distroless, or slim base images. Use this skill whenever the user wants to containerize an application, create a Dockerfile, dockerize a project, build a Docker image, or says things like "make this run in Docker", "create a container for this app", "I need a Dockerfile", "package this for deployment", or "containerize this service". Also trigger when the user has an existing Dockerfile and wants it rewritten for production use, or when they ask about Docker best practices for their project. +description: "Generate production-ready Dockerfiles from project source — auto-detects language/framework and produces multi-stage builds on minimal, distroless, or slim bases. Use when the user wants to containerize or dockerize an app or needs a Dockerfile: \"make this run in Docker\", \"create a container for this app\", \"I need a Dockerfile\", \"package this for deployment\", \"containerize this service\". Also trigger to rewrite an existing Dockerfile for production or for Docker best-practice questions." user-invocable: true --- diff --git a/plugins/dev-team/skills/domain-analysis/SKILL.md b/plugins/dev-team/skills/domain-analysis/SKILL.md index 75784c3..fd81263 100644 --- a/plugins/dev-team/skills/domain-analysis/SKILL.md +++ b/plugins/dev-team/skills/domain-analysis/SKILL.md @@ -1,6 +1,6 @@ --- name: domain-analysis -description: Strategic DDD health assessment of an existing system. Use whenever someone asks to analyze their architecture, assess domain health, find coupling problems, map bounded contexts, trace event flows across services, or understand what is slowing down delivery. Trigger on phrases like "what's wrong with our architecture", "where is the coupling", "assess our domain", "event storming", "value stream", "friction report", "bounded contexts", or "why is everything so tangled". Apply to existing codebases — use domain-driven-design skill for greenfield modeling. +description: "Strategic DDD health assessment of an existing system. Use when someone asks to analyze their architecture, assess domain health, find coupling, map bounded contexts, trace cross-service event flows, or understand what is slowing delivery: \"what's wrong with our architecture\", \"where is the coupling\", \"assess our domain\", \"event storming\", \"value stream\", \"friction report\", \"bounded contexts\", \"why is everything so tangled\". For existing codebases — use the domain-driven-design skill for greenfield modeling." role: worker user-invocable: true --- diff --git a/plugins/dev-team/skills/exploratory-testing/SKILL.md b/plugins/dev-team/skills/exploratory-testing/SKILL.md index 8d9ccdd..96509e4 100644 --- a/plugins/dev-team/skills/exploratory-testing/SKILL.md +++ b/plugins/dev-team/skills/exploratory-testing/SKILL.md @@ -1,6 +1,6 @@ --- name: exploratory-testing -description: Charter-driven exploratory testing — probe a running feature/endpoint with structured heuristics, evaluate charter quality, run adversarial expansion, classify defects, and auto-triage critical findings into an incremental report. Use when the user runs /explore, says "explore this endpoint", "poke at this feature", "find bugs in the running app", or wants hands-off exploratory testing of a live target. +description: "Charter-driven exploratory testing — probe a running feature/endpoint with structured heuristics, evaluate charter quality, run adversarial expansion, classify defects, and auto-triage critical findings into an incremental report. Use when the user runs /explore, says \"explore this endpoint\", \"poke at this feature\", \"find bugs in the running app\", or wants hands-off exploratory testing of a live target." role: worker user-invocable: true --- diff --git a/plugins/dev-team/skills/explore/SKILL.md b/plugins/dev-team/skills/explore/SKILL.md index 566b013..decf6d0 100644 --- a/plugins/dev-team/skills/explore/SKILL.md +++ b/plugins/dev-team/skills/explore/SKILL.md @@ -1,12 +1,6 @@ --- name: explore -description: >- - Charter-driven exploratory testing of a running feature or endpoint. Dispatches - the QA Engineer in "Chaos Specialist" mode to probe with structured heuristics - (Goldilocks, Happy-Path Divergence, Telemetry Deepening, Invariant Probing, - CRUD Sweep), run adversarial expansion, and auto-triage critical defects into an - incremental report. Use when the user says "explore this endpoint", "poke at - this feature", or wants hands-off exploratory testing of a live target. +description: "Charter-driven exploratory testing of a running feature or endpoint. Dispatches the QA Engineer in \"Chaos Specialist\" mode with structured heuristics (Goldilocks, Happy-Path Divergence, Telemetry Deepening, Invariant Probing, CRUD Sweep), runs adversarial expansion, and auto-triages critical defects into an incremental report. Use when the user says \"explore this endpoint\", \"poke at this feature\", or wants hands-off exploratory testing of a live target." argument-hint: "--charter '' [target] [--probe-budget ] [--invariants ''] [--no-adversarial] [--force]" user-invocable: true allowed-tools: read, search, find, bash, write, task diff --git a/plugins/dev-team/skills/feature-file-validation/SKILL.md b/plugins/dev-team/skills/feature-file-validation/SKILL.md index f800333..1d6ceb8 100644 --- a/plugins/dev-team/skills/feature-file-validation/SKILL.md +++ b/plugins/dev-team/skills/feature-file-validation/SKILL.md @@ -1,13 +1,6 @@ --- name: feature-file-validation -description: >- - Validate Gherkin feature files for structural quality, determinism, and - implementation independence, then verify each scenario has matching test - automation. Use this skill whenever reviewing test files, feature files, or - BDD scenarios — including during /code-review when .feature files or step - definition files appear in the changeset. Also use when a user asks to - "check my feature files", "validate my Gherkin", "are my scenarios - testable", or "do my feature files have tests". +description: "Validate Gherkin feature files for structural quality, determinism, and implementation independence, then verify each scenario has matching test automation. Use whenever reviewing test files, feature files, or BDD scenarios — including during /code-review when .feature or step-definition files appear in the changeset. Also use when the user asks to \"check my feature files\", \"validate my Gherkin\", \"are my scenarios testable\", \"do my feature files have tests\"." role: worker user-invocable: true --- diff --git a/plugins/dev-team/skills/js-project-init/SKILL.md b/plugins/dev-team/skills/js-project-init/SKILL.md index e3df685..7750c85 100644 --- a/plugins/dev-team/skills/js-project-init/SKILL.md +++ b/plugins/dev-team/skills/js-project-init/SKILL.md @@ -1,6 +1,6 @@ --- name: js-project-init -description: Initialize a new JavaScript project with ES modules, functional style, prettier, eslint, editorconfig, vitest, and gitignore. Use this skill whenever the user wants to start a new JS project, scaffold a Node.js app, create a new package, bootstrap a JavaScript repo, or says things like "init a new project", "set up a JS project", "create a new node app", "start a new frontend project", or "bootstrap a new package". Also trigger when the user asks to add standard JS tooling (linting, formatting, testing) to an empty or near-empty directory. +description: "Initialize a new JavaScript project with ES modules, functional style, prettier, eslint, editorconfig, vitest, and gitignore. Use when the user wants to start, scaffold, or bootstrap a JS/Node project or package: \"init a new project\", \"set up a JS project\", \"create a new node app\", \"start a new frontend project\", \"bootstrap a new package\". Also trigger to add standard JS tooling (linting, formatting, testing) to an empty or near-empty directory." user-invocable: true --- diff --git a/plugins/dev-team/skills/mermaid-diagramming/SKILL.md b/plugins/dev-team/skills/mermaid-diagramming/SKILL.md index 11d7dde..87622ff 100644 --- a/plugins/dev-team/skills/mermaid-diagramming/SKILL.md +++ b/plugins/dev-team/skills/mermaid-diagramming/SKILL.md @@ -1,6 +1,6 @@ --- name: mermaid-diagramming -description: Create Mermaid diagrams using the project's blue-gray theme. Use whenever the user asks to draw a diagram, create a flowchart, visualize a process, document architecture, or add any Mermaid diagram to a markdown file. Trigger on phrases like "draw a diagram", "create a flowchart", "visualize this", "add a mermaid diagram", "document the flow", "sequence diagram", "architecture diagram", or any request to diagram a process or system. +description: "Create Mermaid diagrams using the project's blue-gray theme. Use whenever the user asks to draw a diagram, create a flowchart, visualize a process, document architecture, or add a Mermaid diagram to markdown: \"draw a diagram\", \"create a flowchart\", \"visualize this\", \"add a mermaid diagram\", \"document the flow\", \"sequence diagram\", \"architecture diagram\"." role: worker user-invocable: true --- diff --git a/plugins/dev-team/skills/mutation-testing/SKILL.md b/plugins/dev-team/skills/mutation-testing/SKILL.md index b0330e3..cab8003 100644 --- a/plugins/dev-team/skills/mutation-testing/SKILL.md +++ b/plugins/dev-team/skills/mutation-testing/SKILL.md @@ -1,6 +1,6 @@ --- name: mutation-testing -description: Validate test suite quality by running a real mutation testing tool and triaging surviving mutants. Use after writing tests to verify assertions catch behavioral changes, when evaluating test coverage quality, or as a CI quality gate on critical modules. The AI value here is triage — classifying survivors, writing fix tests — not generating or estimating mutations. +description: "Validate test-suite quality by running a real mutation-testing tool and triaging surviving mutants. Use after writing tests to verify assertions catch behavioral changes, when evaluating coverage quality, or as a CI quality gate on critical modules. The AI value is triage — classifying survivors and writing fix tests — not generating mutations." role: worker user-invocable: true --- diff --git a/plugins/dev-team/skills/plan/SKILL.md b/plugins/dev-team/skills/plan/SKILL.md index db0b100..eaf1b3f 100644 --- a/plugins/dev-team/skills/plan/SKILL.md +++ b/plugins/dev-team/skills/plan/SKILL.md @@ -1,11 +1,6 @@ --- name: plan -description: >- - Create a structured implementation plan with goal, acceptance criteria, - incremental TDD steps, and a pre-PR quality gate. Use this for tasks that - need a plan but not the full three-phase orchestration, or when the user - says "plan this", "make a plan", "break this down", or "how should I - implement this". +description: "Create a structured implementation plan with goal, acceptance criteria, incremental TDD steps, and a pre-PR quality gate. Use for tasks that need a plan but not the full three-phase orchestration, or when the user says \"plan this\", \"make a plan\", \"break this down\", or \"how should I implement this\"." argument-hint: " [--output ]" user-invocable: true allowed-tools: read, write, find, search, bash(mkdir *), bash(date *), bash(git branch *), ask diff --git a/plugins/dev-team/skills/pr/SKILL.md b/plugins/dev-team/skills/pr/SKILL.md index 3691389..dec30d7 100644 --- a/plugins/dev-team/skills/pr/SKILL.md +++ b/plugins/dev-team/skills/pr/SKILL.md @@ -1,10 +1,6 @@ --- name: pr -description: >- - Run a pre-PR quality gate (tests, typecheck, lint, code review) and then - create a pull request with a structured summary. Use when the user says - "create a PR", "open a PR", "submit for review", or "I'm done with this - feature". +description: "Run a pre-PR quality gate (tests, typecheck, lint, code review) then create a pull request with a structured summary. Use when the user says \"create a PR\", \"open a PR\", \"submit for review\", or \"I'm done with this feature\"." argument-hint: "[--skip-review] [--draft] [--base ]" user-invocable: true allowed-tools: read, write, edit, find, search, bash(git *), bash(gh *), bash(npm *), bash(npx *), bash(pnpm *), bash(yarn *), bash(make *), bash(pytest *), bash(go *), bash(cargo *), bash(dotnet *), skill(code-review *) diff --git a/plugins/dev-team/skills/review-agent/SKILL.md b/plugins/dev-team/skills/review-agent/SKILL.md index 135715a..d25dee2 100644 --- a/plugins/dev-team/skills/review-agent/SKILL.md +++ b/plugins/dev-team/skills/review-agent/SKILL.md @@ -1,12 +1,6 @@ --- name: review-agent -description: >- - Run a single named review agent against target files. Use this when the - user names a specific agent (e.g. "run security-review", "check for test - issues", "run js-fp-review on this file") rather than wanting the full - suite. Prefer this over /code-review when only one concern is relevant or - speed matters. Also used by the orchestrator for inline review checkpoints - during Phase 3 implementation. +description: "Run a single named review agent against target files. Use when the user names a specific agent (\"run security-review\", \"check for test issues\", \"run js-fp-review on this file\") rather than the full suite. Prefer over /code-review when only one concern is relevant or speed matters. Also used by the orchestrator for inline review checkpoints during Phase 3 implementation." argument-hint: " [--since ] [--path ]" user-invocable: true allowed-tools: read, search, find, bash(git diff *) diff --git a/plugins/dev-team/skills/review-summary/SKILL.md b/plugins/dev-team/skills/review-summary/SKILL.md index 64238e5..f9709f0 100644 --- a/plugins/dev-team/skills/review-summary/SKILL.md +++ b/plugins/dev-team/skills/review-summary/SKILL.md @@ -1,11 +1,6 @@ --- name: review-summary -description: >- - Generate a compact summary of the most recent code review results and - save it for future sessions. Use this at the end of a coding session after - /code-review has run, or when the user says "summarize the review", "save - the results", "generate a summary", or wants to preserve review context - before closing a session. +description: "Generate a compact summary of the most recent code-review results and save it for future sessions. Use at the end of a coding session after /code-review, or when the user says \"summarize the review\", \"save the results\", \"generate a summary\", or wants to preserve review context before closing a session." argument-hint: "[--from ]" user-invocable: true allowed-tools: read, write, find, bash(date *), bash(git rev-parse *), bash(git branch *), bash(mkdir *) diff --git a/plugins/dev-team/skills/review/SKILL.md b/plugins/dev-team/skills/review/SKILL.md index 63a3f58..cc612ae 100644 --- a/plugins/dev-team/skills/review/SKILL.md +++ b/plugins/dev-team/skills/review/SKILL.md @@ -1,10 +1,6 @@ --- name: review -description: >- - Alias for /code-review. Run all enabled review agents against target files. - Use this whenever the user asks for a code review, wants feedback on their - code, says "review my code", "check this before I PR", "what's wrong with - this", "run the agents", or has just finished implementing a feature. +description: "Alias for /code-review — run all enabled review agents against target files. Use whenever the user asks for a code review or feedback: \"review my code\", \"check this before I PR\", \"what's wrong with this\", \"run the agents\", or has just finished implementing a feature." argument-hint: >- [--agent ] [--since ] [--path ] [--all] [--json] [--force --reason ""] [--static-analysis|--no-static-analysis] diff --git a/plugins/dev-team/skills/semantic-duplication-scan/SKILL.md b/plugins/dev-team/skills/semantic-duplication-scan/SKILL.md index 5e1fc04..9f67be4 100644 --- a/plugins/dev-team/skills/semantic-duplication-scan/SKILL.md +++ b/plugins/dev-team/skills/semantic-duplication-scan/SKILL.md @@ -1,13 +1,6 @@ --- name: semantic-duplication-scan -description: >- - Detect business logic reimplemented in multiple architectural layers. Builds a - persistent computation-register.json by annotating non-trivial computation - functions with structured semantic descriptions, then clusters entries to - surface duplicate domain concepts. Runs in full-scan mode on first use, - incremental (git-diff-based) mode on subsequent runs. Use when the user wants - to find logical duplication that linters and diff-scoped review agents miss — - the same domain calculation independently reimplemented across layers. +description: "Detect business logic reimplemented across architectural layers. Annotates non-trivial computation functions into a persistent computation-register.json, then clusters entries to surface duplicate domain concepts (full scan on first use, git-diff incremental after). Use to find logical duplication that linters and diff-scoped review agents miss — the same domain calculation independently reimplemented across layers." role: worker user-invocable: true --- diff --git a/plugins/dev-team/skills/semantic-scan/SKILL.md b/plugins/dev-team/skills/semantic-scan/SKILL.md index 861032f..63a95e9 100644 --- a/plugins/dev-team/skills/semantic-scan/SKILL.md +++ b/plugins/dev-team/skills/semantic-scan/SKILL.md @@ -1,12 +1,6 @@ --- name: semantic-scan -description: >- - Build a computation register and detect semantic duplicates across architectural - layers. Finds business logic reimplemented multiple times in different layers — - the same domain calculation independently appearing in domain services, client - adapters, and presentation components. Runs incrementally (git-diff-based) after - the first scan. Produces a structured duplicate report with file:line references - and canonical location suggestions. +description: "Build a computation register and detect semantic duplicates across architectural layers — business logic reimplemented in domain services, client adapters, and presentation components. Runs incrementally (git-diff-based) after the first scan. Produces a structured duplicate report with file:line references and canonical-location suggestions." argument-hint: "[path] [--full] [--no-opus]" user-invocable: true --- diff --git a/plugins/dev-team/skills/semgrep-analyze/SKILL.md b/plugins/dev-team/skills/semgrep-analyze/SKILL.md index 816f19c..620f2c2 100644 --- a/plugins/dev-team/skills/semgrep-analyze/SKILL.md +++ b/plugins/dev-team/skills/semgrep-analyze/SKILL.md @@ -1,11 +1,6 @@ --- name: semgrep-analyze -description: >- - Run Semgrep static analysis on target files and return structured - findings. Use this when the user wants static analysis, SAST scanning, or - security scanning — phrases like "run semgrep", "scan for - vulnerabilities", "static analysis on this code", or as a pre-review gate - when security findings are needed before AI agents run. +description: "Run Semgrep static analysis on target files and return structured findings. Use when the user wants static analysis, SAST, or security scanning: \"run semgrep\", \"scan for vulnerabilities\", \"static analysis on this code\", or as a pre-review gate when security findings are needed before AI agents run." argument-hint: "[path] [--rules ]" user-invocable: true allowed-tools: read, search, find, bash(semgrep *) diff --git a/plugins/dev-team/skills/session-review/SKILL.md b/plugins/dev-team/skills/session-review/SKILL.md index 0a5518c..870925d 100644 --- a/plugins/dev-team/skills/session-review/SKILL.md +++ b/plugins/dev-team/skills/session-review/SKILL.md @@ -1,10 +1,6 @@ --- name: session-review -description: >- - Mine real Oh-My-Pi (OMP) session transcripts to suggest plugin improvements that - cut token spend, reduce re-work, and improve accuracy. Use when the user asks - to "review my sessions", "where am I wasting tokens", "why does this keep - re-doing work", or "/session-review". +description: "Mine real Oh-My-Pi (OMP) session transcripts to suggest plugin improvements that cut token spend, reduce rework, and improve accuracy. Use when the user asks to \"review my sessions\", \"where am I wasting tokens\", \"why does this keep re-doing work\", or runs /session-review." argument-hint: "[--cwd ] [--transcript ] [--out ]" user-invocable: true allowed-tools: >- diff --git a/plugins/dev-team/skills/setup/SKILL.md b/plugins/dev-team/skills/setup/SKILL.md index 6814b56..26a21eb 100644 --- a/plugins/dev-team/skills/setup/SKILL.md +++ b/plugins/dev-team/skills/setup/SKILL.md @@ -1,10 +1,6 @@ --- name: setup -description: >- - Detect a project's tech stack and auto-generate project-level CLAUDE.md, - PostToolUse hooks, and language-specific agent templates in one shot. Use - this when onboarding a new project, or when the user says "setup", - "bootstrap", "configure this project", or "detect my stack". +description: "Detect a project's tech stack and auto-generate project-level CLAUDE.md, PostToolUse hooks, and language-specific agent templates in one shot. Use when onboarding a new project, or when the user says \"setup\", \"bootstrap\", \"configure this project\", or \"detect my stack\"." argument-hint: "[--dry-run]" user-invocable: true allowed-tools: read, write, edit, find, search, bash(jq *), bash(ls *), bash(mkdir *), bash(cat *), bash(test *), bash(node *) diff --git a/plugins/dev-team/skills/specs/SKILL.md b/plugins/dev-team/skills/specs/SKILL.md index b305cfc..7d8704d 100644 --- a/plugins/dev-team/skills/specs/SKILL.md +++ b/plugins/dev-team/skills/specs/SKILL.md @@ -1,6 +1,6 @@ --- name: specs -description: Collaborative workflow for producing the three specification artifacts (intent, architecture notes, acceptance criteria) that describe a change and its goals before any implementation begins. Use when starting any new feature or behavior change — do not write code until artifacts pass the consistency gate. BDD/Gherkin scenarios are authored later, per slice, in /plan. +description: "Collaborative workflow producing the three specification artifacts (intent, architecture notes, acceptance criteria) that describe a change and its goals before implementation. Use when starting any new feature or behavior change — do not write code until artifacts pass the consistency gate. BDD/Gherkin scenarios are authored later, per slice, in /plan." role: worker user-invocable: true --- diff --git a/plugins/dev-team/skills/systematic-debugging/SKILL.md b/plugins/dev-team/skills/systematic-debugging/SKILL.md index 029806a..0d49ffb 100644 --- a/plugins/dev-team/skills/systematic-debugging/SKILL.md +++ b/plugins/dev-team/skills/systematic-debugging/SKILL.md @@ -1,6 +1,6 @@ --- name: systematic-debugging -description: Four-phase debugging protocol (reproduce, investigate, root-cause, fix) that prevents guess-and-fix thrashing. Use this skill whenever a test fails, a bug is reported, an error occurs during implementation, or any unexpected behavior is encountered. Prevents the common LLM failure mode of guessing at fixes without understanding the problem. +description: "Four-phase debugging protocol (reproduce, investigate, root-cause, fix) that prevents guess-and-fix thrashing. Use whenever a test fails, a bug is reported, an error occurs during implementation, or any unexpected behavior appears. Prevents the common LLM failure mode of guessing at fixes without understanding the problem." role: worker user-invocable: true --- diff --git a/plugins/dev-team/skills/telemetry/SKILL.md b/plugins/dev-team/skills/telemetry/SKILL.md index b1d8062..3ab8677 100644 --- a/plugins/dev-team/skills/telemetry/SKILL.md +++ b/plugins/dev-team/skills/telemetry/SKILL.md @@ -1,9 +1,6 @@ --- name: telemetry -description: >- - Manage and report the opt-in, privacy-clean usage telemetry beacon. Use when - the user asks to "enable/disable telemetry", "show telemetry", "usage stats", - "which commands do I use", or "how often is the commit gate bypassed". +description: "Manage and report the opt-in, privacy-clean usage telemetry beacon. Use when the user asks to \"enable/disable telemetry\", \"show telemetry\", \"usage stats\", \"which commands do I use\", or \"how often is the commit gate bypassed\"." argument-hint: "[on|off|status|report]" user-invocable: true allowed-tools: >- diff --git a/plugins/dev-team/skills/test-design-advisor/SKILL.md b/plugins/dev-team/skills/test-design-advisor/SKILL.md index 3c0d12a..eed6a0e 100644 --- a/plugins/dev-team/skills/test-design-advisor/SKILL.md +++ b/plugins/dev-team/skills/test-design-advisor/SKILL.md @@ -1,6 +1,6 @@ --- name: test-design-advisor -description: Advise on test design — assess testability, recommend the right test-pyramid layer and test-double strategy, and propose a behavior-preserving refactor sequence to make hard-to-test code testable. Use when the user says "how should I test this", "is this testable", "design tests for this", "what's the right test for X", or before writing tests for an untested module. +description: "Advise on test design — assess testability, recommend the right test-pyramid layer and test-double strategy, and propose a behavior-preserving refactor sequence for hard-to-test code. Use when the user says \"how should I test this\", \"is this testable\", \"design tests for this\", \"what's the right test for X\", or before writing tests for an untested module." role: worker user-invocable: true --- diff --git a/plugins/dev-team/skills/test-design-reviewer/SKILL.md b/plugins/dev-team/skills/test-design-reviewer/SKILL.md index dfa85b6..3b8909c 100644 --- a/plugins/dev-team/skills/test-design-reviewer/SKILL.md +++ b/plugins/dev-team/skills/test-design-reviewer/SKILL.md @@ -1,6 +1,6 @@ --- name: test-design-reviewer -description: Evaluate test quality using Dave Farley's 8 properties with a weighted Farley Score. Use when reviewing test suites, after writing tests, or when the user says "score my tests", "test quality", "Farley score", or "how good are my tests". +description: "Evaluate test quality using Dave Farley's 8 properties with a weighted Farley Score. Use when reviewing test suites, after writing tests, or when the user says \"score my tests\", \"test quality\", \"Farley score\", or \"how good are my tests\"." role: worker user-invocable: true --- diff --git a/plugins/dev-team/skills/test-design/SKILL.md b/plugins/dev-team/skills/test-design/SKILL.md index 0365204..500d77d 100644 --- a/plugins/dev-team/skills/test-design/SKILL.md +++ b/plugins/dev-team/skills/test-design/SKILL.md @@ -1,12 +1,6 @@ --- name: test-design -description: >- - Deep test-design review: dispatch test-review (tactical quality) and - test-smell-review (xUnit smells, double selection, pyramid placement) in - parallel, then run the test-design-advisor skill to recommend how to test - hard-to-test code. Use when the user says "review my tests", "how should I - test this", "is this testable", "test design review", or before writing a - suite for an untested module. Advisory — it recommends, it does not edit. +description: "Deep test-design review: dispatches test-review (tactical quality) and test-smell-review (xUnit smells, double selection, pyramid placement) in parallel, then runs test-design-advisor to recommend how to test hard-to-test code. Use when the user says \"review my tests\", \"how should I test this\", \"is this testable\", \"test design review\", or before writing a suite for an untested module. Advisory — it recommends, it does not edit." argument-hint: "[--path ] [--since ] [--advise]" user-invocable: true allowed-tools: read, search, find, bash(git diff *), task diff --git a/plugins/dev-team/skills/test-driven-development/SKILL.md b/plugins/dev-team/skills/test-driven-development/SKILL.md index 25ac10c..00c43b3 100644 --- a/plugins/dev-team/skills/test-driven-development/SKILL.md +++ b/plugins/dev-team/skills/test-driven-development/SKILL.md @@ -1,6 +1,6 @@ --- name: test-driven-development -description: Enforce RED-GREEN-REFACTOR cycle with hard gates. Use this skill whenever writing new code, fixing bugs, or adding features — any time implementation code will be written or modified. Prevents the common LLM failure mode of writing implementation first and tests later (or never). Also use when reviewing code to verify TDD discipline was followed. +description: "Enforce the RED-GREEN-REFACTOR cycle with hard gates. Use whenever implementation code will be written or modified — new code, bug fixes, features. Prevents the common LLM failure mode of writing implementation first and tests later (or never). Also use when reviewing code to verify TDD discipline." role: worker user-invocable: true --- diff --git a/plugins/dev-team/skills/test-health/SKILL.md b/plugins/dev-team/skills/test-health/SKILL.md index 8cbc5c6..c4bf299 100644 --- a/plugins/dev-team/skills/test-health/SKILL.md +++ b/plugins/dev-team/skills/test-health/SKILL.md @@ -1,6 +1,6 @@ --- name: test-health -description: Project-wide test-strategy audit — derive the suite's shape and shape-vs-architecture fit, map coverage to the Agile Testing Quadrants, roll up coverage + mutation health, flag flaky tests and automation maturity, and produce an ordered improvement plan. Delegates CD-determinism + pipeline assessment to cd-test-architecture. Use when the user says "audit our tests", "how healthy is our test suite", "test strategy review", or runs /test-health. Advisory — writes a report, does not edit. +description: "Project-wide test-strategy audit — derive the suite's shape and its fit to the architecture, map coverage to the Agile Testing Quadrants, roll up coverage + mutation health, flag flaky tests and automation maturity, and produce an ordered improvement plan. Delegates CD-determinism + pipeline assessment to cd-test-architecture. Use when the user says \"audit our tests\", \"how healthy is our test suite\", \"test strategy review\", or runs /test-health. Advisory — writes a report, does not edit." role: worker user-invocable: true argument-hint: "[--path ]" diff --git a/plugins/dev-team/skills/triage/SKILL.md b/plugins/dev-team/skills/triage/SKILL.md index 26e3896..5ecd0bf 100644 --- a/plugins/dev-team/skills/triage/SKILL.md +++ b/plugins/dev-team/skills/triage/SKILL.md @@ -1,10 +1,6 @@ --- name: triage -description: >- - Investigate a bug, find its root cause, and write a portable triage record to - .triage/.md with a TDD fix plan. Use when the user reports a bug and - wants it triaged, says "triage this", "investigate and write it up", or wants - a hands-off bug investigation that produces an actionable record. +description: "Investigate a bug, find its root cause, and write a portable triage record to .triage/.md with a TDD fix plan. Use when the user reports a bug and wants it triaged: \"triage this\", \"investigate and write it up\", or wants a hands-off bug investigation that produces an actionable record." argument-hint: "" user-invocable: true allowed-tools: read, find, search, bash, write, task diff --git a/plugins/dev-team/skills/ubiquitous-language/SKILL.md b/plugins/dev-team/skills/ubiquitous-language/SKILL.md index d1239bb..c35fe32 100644 --- a/plugins/dev-team/skills/ubiquitous-language/SKILL.md +++ b/plugins/dev-team/skills/ubiquitous-language/SKILL.md @@ -1,6 +1,6 @@ --- name: ubiquitous-language -description: Build or refresh the project's ubiquitous language glossary — one markdown file per business concept at `.plans/domain/.md` plus a `_index.md`. Mines grep-based signals (class names, enum values, interface names, domain-event names, BDD scenario names, validator rules) and applies a four-gate filter to keep only genuine business concepts. Optional interactive interview phase to refine definitions and capture behavior (state transitions, invariants, synonyms to avoid). Language-agnostic — works for JS/TS, C#, Java, Python, Go, or any mix. Use whenever the user says "build the glossary", "extract domain terms", "document the ubiquitous language", "what are the domain concepts", or when domain-review surfaces pervasive terminology inconsistency (3+ names for the same concept). +description: "Build or refresh the project's ubiquitous-language glossary — one markdown file per business concept at `.plans/domain/.md` plus `_index.md`. Mines grep signals (class/enum/interface/domain-event/BDD-scenario/validator names), applies a four-gate filter to keep genuine business concepts, with an optional interview phase to refine definitions and behavior. Language-agnostic. Use when the user says \"build the glossary\", \"extract domain terms\", \"document the ubiquitous language\", \"what are the domain concepts\", or when domain-review surfaces 3+ names for the same concept." role: worker user-invocable: true argument-hint: "[path-to-source-root]" diff --git a/plugins/token-diet/skills/yagni/SKILL.md b/plugins/token-diet/skills/yagni/SKILL.md index 5288513..2a6006b 100644 --- a/plugins/token-diet/skills/yagni/SKILL.md +++ b/plugins/token-diet/skills/yagni/SKILL.md @@ -1,10 +1,6 @@ --- name: yagni -description: >- - Write minimal code — the laziest-senior-dev / YAGNI discipline. Use when the - user says "yagni", "ponytail", "minimal code", "keep it simple", "don't - over-engineer", "fewer lines", or asks to review/trim a diff for bloat. Fewer - lines = fewer tokens over the whole session + less tech debt. +description: "Write minimal code — the laziest-senior-dev / YAGNI discipline. Use when the user says \"yagni\", \"ponytail\", \"minimal code\", \"keep it simple\", \"don't over-engineer\", \"fewer lines\", or asks to review/trim a diff for bloat. Fewer lines = fewer tokens over the session + less tech debt." --- # yagni — the laziest senior dev in the room