[#313] refactor: trigger-oriented descriptions for all 35 skills (task T3)

.claude/skills/pair-capability-analyze-code-quality/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pair-capability-analyze-code-quality
-description: "Analyzes code quality using resolution cascade (Argument > Adoption > Assessment). Applies quality score formula from code-metrics guidelines. Produces quality report with complexity, size, coverage, and maintainability metrics (output-only, writes nothing). Idempotent: detects existing report, checks staleness. Invocable independently or composed by /pair-process-review."
+description: "Produces an objective code quality report — complexity, size, coverage, duplication, maintainability score — for a repo or package, with actionable recommendations. Composed by /pair-process-review; invoke directly for a report on demand ('code quality report', 'how maintainable is this'). Output-only: writes nothing, never blocks."
 version: 0.5.0
 author: Foomakers
 ---

.claude/skills/pair-capability-analyze-debt/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pair-capability-analyze-debt
-description: "Analyzes technical debt using resolution cascade (Argument > Adoption > Assessment). Categorizes debt (code, design, test, documentation, infrastructure), applies prioritization formula (impact x effort), proposes remediation priority. Output-only: returns a report, writes no files, creates no backlog items, never blocks. Idempotent. Invocable independently or composed by /pair-process-review."
+description: "Produces a technical debt report — categorized items (code, design, test, documentation, infrastructure), prioritized by impact x effort. Composed by /pair-process-review; invoke directly to catalog and prioritize debt on demand. Output-only: writes no files, creates no backlog items, never blocks a PR."
 version: 0.5.0
 author: Foomakers
 ---

.claude/skills/pair-capability-assess-ai/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pair-capability-assess-ai
-description: "Assess AI development tools using resolution cascade (Argument > Adoption > Assessment). Reads AI development guidelines, proposes AI tool choices with versions and emits rendered adoption content + target (output-only, writes nothing); the caller persists via /pair-capability-record-decision. Idempotent."
+description: "Evaluates and recommends AI development tools — coding assistants (Copilot, Claude Code, Cursor), agent frameworks, MCP integrations, models — when the choice is open. Output-only: emits a proposal + target for /pair-capability-record-decision to persist."
 version: 0.5.0
 author: Foomakers
 ---

.claude/skills/pair-capability-assess-architecture/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pair-capability-assess-architecture
-description: "Assess architecture pattern using resolution cascade (Argument > Adoption > Assessment). Reads architecture guidelines, proposes a pattern and emits rendered adoption content + target (output-only, writes nothing); the caller persists via /pair-capability-record-decision. Idempotent."
+description: "Evaluates and recommends an architecture pattern (layered, hexagonal, microservices, modular monolith, etc.) when the choice is open. Output-only: emits a proposal + target for /pair-capability-record-decision to persist."
 version: 0.5.0
 author: Foomakers
 ---

.claude/skills/pair-capability-assess-infrastructure/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pair-capability-assess-infrastructure
-description: "Assess infrastructure strategy using resolution cascade (Argument > Adoption > Assessment). Reads infrastructure guidelines, proposes cloud/CI/CD/deployment choices and emits rendered adoption content + target (output-only, writes nothing); the caller persists via /pair-capability-record-decision. Idempotent."
+description: "Evaluates and recommends infrastructure strategy — cloud provider, CI/CD pipeline, deployment pattern, IaC, environments — when the choice is open. Output-only: emits a proposal + target for /pair-capability-record-decision to persist."
 version: 0.5.0
 author: Foomakers
 ---

.claude/skills/pair-capability-assess-methodology/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pair-capability-assess-methodology
-description: "Assess development methodology using resolution cascade (Argument > Adoption > Assessment). Reads methodology guidelines, proposes Scrum/Kanban/Lean/etc. and emits rendered adoption content + target (output-only, writes nothing); the caller persists via /pair-capability-record-decision. Idempotent."
+description: "Evaluates and recommends the development methodology (Scrum, Kanban, Lean, SAFe, hybrid) — iterations, ceremonies, flow — when the choice is open. Output-only: emits a proposal + target for /pair-capability-record-decision to persist."
 version: 0.5.0
 author: Foomakers
 ---

.claude/skills/pair-capability-assess-observability/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pair-capability-assess-observability
-description: "Assess observability strategy using resolution cascade (Argument > Adoption > Assessment). Reads observability guidelines, proposes monitoring/logging/tracing choices and emits rendered adoption content + target (output-only, writes nothing); the caller persists via /pair-capability-record-decision. Idempotent."
+description: "Evaluates and recommends the observability strategy — monitoring, logging, tracing, alerting, telemetry — when the choice is open. Output-only: emits a proposal + target for /pair-capability-record-decision to persist."
 version: 0.5.0
 author: Foomakers
 ---

.claude/skills/pair-capability-assess-pm/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pair-capability-assess-pm
-description: "Assess project management tool using resolution cascade (Argument > Adoption > Assessment). Reads PM tool guidelines, proposes a tool choice and emits rendered adoption content + target (output-only, writes nothing); persistence via /pair-capability-setup-pm or the caller's /pair-capability-record-decision. Idempotent."
+description: "Evaluates and recommends which project management tool fits this project (Jira, Linear, GitHub Projects, etc.) when the choice is still open — proposes a choice, doesn't configure anything. /pair-capability-setup-pm configures the tool once picked; otherwise the caller persists the proposal via /pair-capability-record-decision."
 version: 0.5.0
 author: Foomakers
 ---

.claude/skills/pair-capability-assess-stack/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pair-capability-assess-stack
-description: "Assess tech stack using resolution cascade (Argument > Adoption > Assessment). Lifecycle-spanning: bootstrap (full eval), implementation (add dependency), review (detect unlisted). Version tracking. Output-only: emits rendered adoption content + target; the caller persists via /pair-capability-record-decision. Idempotent."
+description: "Evaluates and recommends the tech stack — languages, frameworks, database, libraries, versions — when the choice is open: full evaluation at bootstrap, a single new dependency during implementation ('should we add Redis', 'is this new dependency consistent with our stack'), or composed by /pair-process-review when it finds an unlisted dependency in code. Doesn't audit code already written (that's /pair-capability-verify-adoption). Output-only: emits a proposal + target for /pair-capability-record-decision to persist."
 version: 0.5.0
 author: Foomakers
 ---

.claude/skills/pair-capability-assess-testing/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pair-capability-assess-testing
-description: "Assess testing strategy using resolution cascade (Argument > Adoption > Assessment). Reads testing guidelines, proposes framework and strategy and emits rendered adoption content + target (output-only, writes nothing); the caller persists via /pair-capability-record-decision. Idempotent."
+description: "Evaluates and recommends the testing strategy — framework, pyramid distribution, coverage targets, TDD approach — when the choice is open. Doesn't write tests itself. Output-only: emits a proposal + target for /pair-capability-record-decision to persist."
 version: 0.5.0
 author: Foomakers
 ---

.claude/skills/pair-capability-checkpoint/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pair-capability-checkpoint
-description: "Writes and resumes a self-contained progress checkpoint (story, branch, tasks done, decisions, remaining todos) so work survives context resets. Write mode persists state to .pair/working/checkpoints/<story-id>.md, one file per story; resume mode locates and parses it. Invocable independently; composed by a future closing phase of /pair-process-implement and a future /pair-capability-publish-pr (planned — #255) as a handoff."
+description: "Writes and resumes a self-contained progress checkpoint (story, branch, tasks done, decisions, remaining todos) so work survives a context reset. Invoke directly to save or resume progress ('save our progress on #313', 'resume story #256'); composed by a future closing phase of /pair-process-implement and a future /pair-capability-publish-pr (planned — #255)."
 version: 0.4.1
 author: Foomakers
 ---

.claude/skills/pair-capability-design-manual-tests/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pair-capability-design-manual-tests
-description: "Designs a manual test suite for post-release validation by analyzing the project's artifacts, architecture, and deployment targets. Generates critical path files (CP*.md) and a suite README following manual-testing guidelines and the manual-test-case-template. Invocable independently or as a prerequisite of /pair-capability-execute-manual-tests."
+description: "Designs a manual test suite — critical path files + suite README — for post-release validation, by analyzing released artifacts, architecture, and deployment targets. Not for planning the automated-testing approach (use /pair-capability-assess-testing). Prerequisite for /pair-capability-execute-manual-tests."
 version: 0.4.1
 author: Foomakers
 ---

.claude/skills/pair-capability-estimate/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pair-capability-estimate
-description: "Estimates a refined user story using the adopted estimation methodology. Reads estimation framework from guidelines and methodology from way-of-working. Idempotent: detects existing estimate, confirms rather than re-estimating. Invocable independently or composed by /pair-process-refine-story."
+description: "Estimates story points for a refined user story using the project's adopted estimation methodology; confirms rather than re-estimating if already sized. Composed by /pair-process-refine-story; invoke directly to size a story on demand ('estimate story #87')."
 version: 0.4.1
 author: Foomakers
 ---

.claude/skills/pair-capability-execute-manual-tests/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pair-capability-execute-manual-tests
-description: "Executes a project's manual test suite against released artifacts, producing a structured report. Resolves test variables, iterates through critical paths, records PASS/FAIL per test case, and generates the report from the manual-test-report template. Invocable independently or composed by /pair-process-review (post-merge validation)."
+description: "Executes a project's manual test suite against released or deployed artifacts, producing a structured PASS/FAIL report per critical path. Not for running the automated test suite (use /pair-capability-verify-quality). Composed by /pair-process-review for post-merge validation."
 version: 0.4.1
 author: Foomakers
 ---

.claude/skills/pair-capability-grill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pair-capability-grill
-description: "Reusable interview engine: one question at a time, always with a recommendation, exploring KB/codebase before asking. sync mode drives systematic AI-human alignment on every story aspect until explicit shared understanding is confirmed. Write-free by design — returns the synthesis to the caller, never writes adoption or issues. Invocable standalone or composed by /pair-process-brainstorm (phase 1, planned — #230) and /pair-process-refine-story (phase 0)."
+description: "Interviews one question at a time, always with a recommendation, after exploring the KB/codebase first; sync mode drives systematic AI-human alignment on a story until shared understanding is confirmed. Invoke directly to interview on any topic ('grill me on the requirements'). Composed by /pair-process-refine-story and a future /pair-process-brainstorm (planned — #230). Write-free — returns the synthesis, never writes adoption or issues."
 version: 0.4.1
 author: Foomakers
 ---

.claude/skills/pair-capability-manage-flags/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pair-capability-manage-flags
-description: "Manages feature flag lifecycle: creation, activation, deactivation, and cleanup. Follows feature-flags guidelines. Idempotent: detects existing flags, shows current state, offers lifecycle actions rather than re-creating."
+description: "Manages a feature flag's lifecycle — creation, activation, deactivation, cleanup — per the feature-flags guidelines. Invoke directly to create/retire a flag or check its current state; idempotent."
 version: 0.4.1
 author: Foomakers
 ---

.claude/skills/pair-capability-map-contexts/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pair-capability-map-contexts
-description: "Maps subdomains to DDD bounded contexts, scoped to the caller's touched items. Assesses each relationship on integration strength, socio-technical distance and volatility to derive the integration pattern and gate unbalanced+volatile relationships at approval. Falls back to 'system areas' when no DDD artifacts exist yet. Produces/updates files in adoption/tech/boundedcontext/ using bounded-context-template.md. Composed by /pair-process-refine-story, /pair-process-plan-tasks, /brainstorm — full scope only via /pair-process-bootstrap. Idempotent."
+description: "Maps subdomains to DDD bounded contexts and derives the integration pattern between them (integration strength, socio-technical distance, volatility), scoped to items just touched. Composed by /pair-process-refine-story, /pair-process-plan-tasks, a future /pair-process-brainstorm (planned — #230); full-scope re-mapping only via /pair-process-bootstrap."
 version: 0.4.1
 author: Foomakers
 ---

.claude/skills/pair-capability-map-subdomains/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pair-capability-map-subdomains
-description: "Classifies business capabilities into DDD subdomains (core/supporting/generic) with a Volatility rating, scoped to the caller's touched items. Falls back to 'system areas' when no DDD artifacts exist yet. Produces/updates files in adoption/product/subdomain/ using subdomain-template.md. Composed by /pair-process-refine-story, /pair-process-plan-initiatives, /pair-process-plan-epics, /brainstorm — full scope only via /pair-process-bootstrap. Idempotent."
+description: "Classifies business capabilities into DDD subdomains (core, supporting, generic) with a volatility rating, scoped to items just touched. Composed by /pair-process-refine-story, /pair-process-plan-initiatives, /pair-process-plan-epics, a future /pair-process-brainstorm (planned — #230); full-scope re-mapping only via /pair-process-bootstrap."
 version: 0.4.1
 author: Foomakers
 ---

.claude/skills/pair-capability-record-decision/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pair-capability-record-decision
-description: "Records an architectural, non-architectural, or domain decision and is the SOLE writer of adoption files. Architectural decisions produce an ADR; non-architectural decisions produce an ADL entry; domain decisions meeting the 3-criteria gate produce a DDR and sync the context map. All always update the relevant adoption/context files. Accepts pre-rendered {content, target} from assess-* proposals (generic persister — no per-domain rendering). Invocable independently or composed by /pair-process-implement and /pair-process-review."
+description: "Records a decision — ADR (architectural), ADL (non-architectural), or DDR (domain, 3-criteria gate) — and is the sole writer of adoption/context-map files. Invoke directly to record or backfill a decision already made ('write that down as an ADR'). Composed by /pair-process-implement and /pair-process-review."
 version: 0.5.0
 author: Foomakers
 ---

.claude/skills/pair-capability-setup-gates/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pair-capability-setup-gates
-description: "Configures CI/CD quality gates per quality-assurance guidelines, producing pipeline configuration for the adopted tech stack. Provisions shared lint/format config packages and husky pre-commit/pre-push hooks. Reads existing gate config from way-of-working. Idempotent: detects existing configuration, confirms rather than re-configuring."
+description: "Configures CI/CD quality gates — pipeline config, shared lint/format packages, husky hooks — for the adopted tech stack. Invoke directly to set up or reconfigure gates; idempotent — confirms existing configuration rather than re-configuring."
 version: 0.4.1
 author: Foomakers
 ---

.claude/skills/pair-capability-setup-pm/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pair-capability-setup-pm
-description: "Configures the project management tool by guiding selection from supported options, applying the implementation guide, updating way-of-working adoption, and recording the decision via /pair-capability-record-decision. Idempotent — detects existing configuration."
+description: "Configures the project management tool — creates/wires it up, applies its implementation guide, updates way-of-working, records the decision — whether the tool was already chosen or picked here. Invoke directly to set up a tracker ('configure Jira', 'set up GitHub Projects'). Composed by /pair-process-bootstrap; /pair-capability-assess-pm delegates here once a tool is picked."
 version: 0.4.1
 author: Foomakers
 ---

.claude/skills/pair-capability-verify-adoption/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pair-capability-verify-adoption
-description: "Checks code and configuration against project adoption files for a given scope. Detection-only: returns conformity/non-conformity list per area without resolving issues. Caller decides resolution. Invocable independently or composed by /pair-process-review and /pair-process-implement."
+description: "Detects conformity/non-conformity of already-written code and configuration against the project's adopted decisions (architecture, tech-stack, infrastructure, etc.), for a given scope — a compliance audit, not a new-choice evaluation (that's /pair-capability-assess-stack and siblings). Detection-only; resolution is the caller's. Composed by /pair-process-review and /pair-process-implement; invoke directly to audit a scope on demand."
 version: 0.4.1
 author: Foomakers
 ---

.claude/skills/pair-capability-verify-done/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pair-capability-verify-done
-description: "Checks Definition of Done criteria against a PR or work item. Reads universal DoD from quality-standards guidelines and project-specific criteria from adoption files. Already-passing criteria are skipped. Invocable independently or composed by /pair-process-review."
+description: "Checks a PR or work item against Definition of Done criteria (universal + project-specific), skipping already-passing criteria. Composed by /pair-process-review; invoke directly to check DoD on demand ('is PR #42 actually done')."
 version: 0.4.1
 author: Foomakers
 ---

.claude/skills/pair-capability-verify-quality/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pair-capability-verify-quality
-description: "Checks quality gates against the current codebase. Reads project-specific quality gate command from way-of-working adoption and universal standards from quality-standards guidelines. Gates already passing are skipped. Invocable independently or composed by /pair-process-implement and /pair-process-review."
+description: "Checks whether the codebase currently passes its quality gates (lint, tests, type-check, coverage) — pass/fail per gate, skipping gates already passing. Composed by /pair-process-implement and /pair-process-review; invoke directly before pushing to check gates on demand."
 version: 0.4.1
 author: Foomakers
 ---

.claude/skills/pair-capability-write-issue/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pair-capability-write-issue
-description: "Creates or updates issues in the adopted PM tool using template-driven formatting. Reads way-of-working for tool choice and type-specific templates for body structure. Supports topical labels (e.g. tech-debt) for deliberate promotion. Invocable independently or composed by /pair-process-refine-story, /pair-process-plan-tasks, /pair-process-plan-initiatives, /pair-process-plan-epics, and /pair-process-plan-stories."
+description: "Creates or updates an issue in the adopted PM tool from a type-specific template (bug, story, epic, etc.), including topical labels (e.g. tech-debt) for deliberate promotion. Invoke directly to create/update one issue on demand. Composed by /pair-process-refine-story, /pair-process-plan-tasks, /pair-process-plan-initiatives, /pair-process-plan-epics, /pair-process-plan-stories."
 version: 0.5.0
 author: Foomakers
 ---