PRO-2684

setup-matt-pocock-skills

Sets up an `## Agent skills` block in AGENTS.md/CLAUDE.md and `docs/agents/` so the engineering skills know this repo's issue tracker (GitHub or local markdown), triage label vocabulary, and domain doc layout. Run before first use of `to-issues`, `to-prd`, `triage`, `diagnose`, `tdd`, `improve-codebase-architecture`, or `zoom-out` — or if those skills appear to be missing context about the issue tracker, triage labels, or domain docs.

Data & Documents Listed

handoff

Compact the current conversation into a handoff document for another agent to pick up.

grill-with-docs

Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.

improve-codebase-architecture

Find deepening opportunities in a codebase, informed by the domain language in CONTEXT.md and the decisions in docs/adr/. Use when the user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, or make a codebase more testable and AI-navigable.

Code & Development Listed

cyber-mysophobia

Use when Codex should modernize aggressively: prefer ideal architecture and API design, remove legacy/unused code, disregard compatibility, avoid outdated dependencies, reject lint/type errors, avoid suppression hacks, and replace silent fallbacks with explicit failures. Trigger on Cyber Mysophobia, uncompromising cleanup, modernization, API redesign, dependency refresh, legacy removal, lint/type strictness, explicit error handling, or compatibility-disregarding refactors.

debate

Use when the user explicitly invokes debate, or when the agent materially disagrees with the user's premise, interpretation, proposal, or conclusion and resolving the disagreement would improve the outcome.

DevOps & Infrastructure Listed

dependency-archaeology

Resolve dependency conflicts and make project environments reproducible by discovering existing Docker, Conda, pip, uv, Poetry, PDM, npm/yarn/pnpm, or other environment/dependency files; pin exact package versions; regenerate or verify lockfiles; protect git-untracked environment/code changes by warning and asking before editing them; and ask the user before creating a new environment specification when none exists. Use when Codex is asked to fight local environment problems, investigate dependency history, fix dependency installation failures, pin versions, repair broken lockfiles, or make setup repeatable across machines, containers, or CI.

search-papers

Use when finding academic papers, AI conference publications, literature, or arXiv preprints.

long-wait

Defer unattended work until time passes or a command reaches a terminal result, then continue the same primary Codex thread. Use when waiting would otherwise leave the agent idle or polling for a substantial period. Do not use when brief polling is simpler, intermediate output needs attention, or from subagents, ephemeral threads, or transient execution environments.

Data & Documents Listed

download-papers

Download IEEE Xplore publisher PDFs by document ID through institutional or subscriber access, especially when inherited proxies or browser-only entitlement cookies defeat direct downloads. Not for general literature search.