88 added, 68 removed. Audit A to A.
---
name: find-prompt
- description: Route a coding or Claude Code task to the exact prompt(s) in this library. Use when the user names a task ("add OAuth", "set up hooks", "review this PR", "pick a model") and wants to know which prompt to load, or when an agent enters this repo and needs to orient without reading every file.
- argument-hint: [task description]
+ description: Route the current task to the right prompt(s) in this library, load them, and adopt them as your operating instructions for the rest of the conversation. Use when the user names a task ("add OAuth", "set up hooks", "review this PR", "pick a model"), asks which prompt to use, or says to "use the right prompt". Also use when you enter this repo and need to orient without reading every file.
+ argument-hint: [task description — optional; defaults to the current task in the conversation]
---
- # Find the right prompt
+ # Find the right prompt and run with it
- You are the router for this prompt library. Given a task, name the one or two files to load and stop. Do not read every file. Do not summarize the whole repo.
+ You route the current task to the right file(s) in this library, **read them yourself**, and then **continue the existing work** under those instructions — not from scratch, but picking up the conversation and any task already in progress.
- ## How to route
+ `${CLAUDE_SKILL_DIR}` is this skill's own directory (`<library-root>/.claude/skills/find-prompt/`). The library root is `${CLAUDE_SKILL_DIR}/../../..`. All prompt files are under `${CLAUDE_SKILL_DIR}/../../../prompts/english/`. Never hardcode an absolute path — always build it from `${CLAUDE_SKILL_DIR}` so this works for anyone who clones the library, wherever they put it.
- 1. Read the task in `$ARGUMENTS` (or ask for it in one line if empty).
- 2. Match it against the table below. Pick the **base** prompt plus **at most one** specialist or project-type prompt.
- 3. Output only: the file path(s), one line on why, and the exact APEI starting instruction.
- 4. If nothing matches cleanly, point at `prompts/english/INDEX.md` and say which section.
+ If `${CLAUDE_SKILL_DIR}` is not substituted (it shows up literally), fall back: the skill sits next to `SKILL.md`; run `ls` up the tree from your working directory to find the folder containing `prompts/english/agents/claude-agent-system-prompt.md`.
+ ## Steps
+
+ 1. **Determine the task.** Use `$ARGUMENTS` if given. Otherwise use the task already being worked on in this conversation (the user's last real request, the in-progress work, the files open). If genuinely unclear, ask one short question and stop.
+
+ 2. **Match the task** to the routing table below. Pick the **base** prompt plus **at most one** specialist or project-type prompt. Note any second optional prompt.
+
+ 3. **Read the file(s)** with the Read tool, using paths built from `${CLAUDE_SKILL_DIR}`:
+ - base: `${CLAUDE_SKILL_DIR}/../../../prompts/english/agents/claude-agent-system-prompt.md`
+ - specialist: `${CLAUDE_SKILL_DIR}/../../../prompts/english/<path from the table>`
+ If a path does not exist, tell the user to run `/update-prompts` and stop.
+
+ 4. **Adopt them and continue.** Treat the base prompt as your operating system prompt and the specialist as the domain protocol for this task. Then:
+ - Restate the current task in one line (from the conversation, not invented).
+ - State the success criteria you'll hold yourself to.
+ - Carry over every session constraint already established (no git, no server start, static-only, don't touch X, etc.).
+ - Pick up the work where it stands — continue the in-progress task under the new protocol. Do not restart, do not re-ask what was already answered, do not re-explore what was already explored.
+
+ 5. **Confirm in one short block** which prompts you loaded and what you're now doing, then proceed.
+
## Routing table
- ### Running Claude Code itself
+ Paths are relative to `prompts/english/`.
- | Task contains… | Load |
+ ### Running Claude Code itself (base prompt not needed — the Claude Code prompt is enough alone)
+
+ | Task is about… | Load |
|---|---|
- | "skill", "SKILL.md", write/debug a skill | `prompts/english/agents/agent-skills-prompt.md` |
- | "MCP", connect a database/browser/API/tool | `prompts/english/agents/mcp-integration-prompt.md` |
- | "plugin", "marketplace", bundle/share config | `prompts/english/agents/claude-code-plugins-prompt.md` |
- | "hook", run something on edit/commit/stop, block a command | `prompts/english/agents/hooks-automation-prompt.md` |
- | "subagent", "parallel agents", "workflow", "/batch", audit whole codebase, writer/reviewer | `prompts/english/agents/multi-agent-orchestration-prompt.md` |
- | "CLAUDE.md", "settings.json", ".claude/rules", permissions | `prompts/english/agents/claude-code-workflow-prompt.md` |
- | "effort", "ultrathink", "plan mode", how much to think | `prompts/english/agents/claude-code-modes-prompt.md` |
- | "which model", "Opus vs Sonnet", "Haiku", "Fable", pricing | `prompts/english/workflows/model-selection-guide.md` |
- | "what can Claude Code do", plan mode / rewind / headless / surfaces | `prompts/english/workflows/claude-code-native-features-guide.md` |
- | "Agent SDK", build an agent in Python/TS, `query()` | `prompts/english/workflows/agent-sdk-guide.md` |
- | "AGENTS.md", make one config work across Cursor/Codex/Aider, "primary source for X" | `prompts/english/workflows/reference-resources.md` |
+ | writing / debugging a skill, `SKILL.md` | `agents/agent-skills-prompt.md` |
+ | connecting a DB / browser / API / tool via MCP | `agents/mcp-integration-prompt.md` |
+ | a plugin, a marketplace, bundling/sharing config | `agents/claude-code-plugins-prompt.md` |
+ | a hook, running something on edit/commit/stop, blocking a command | `agents/hooks-automation-prompt.md` |
+ | subagents, parallel agents, dynamic workflows, `/batch`, whole-codebase audit, writer/reviewer | `agents/multi-agent-orchestration-prompt.md` |
+ | CLAUDE.md, settings.json, `.claude/rules`, permissions | `agents/claude-code-workflow-prompt.md` |
+ | effort levels, `ultrathink`, plan mode, how much to think | `agents/claude-code-modes-prompt.md` |
+ | which model to use, Opus vs Sonnet vs Haiku vs Fable, pricing | `workflows/model-selection-guide.md` |
+ | what a current Claude Code build can do — plan mode, rewind, headless, surfaces | `workflows/claude-code-native-features-guide.md` |
+ | building an agent in Python/TS, the Agent SDK, `query()` | `workflows/agent-sdk-guide.md` |
+ | AGENTS.md, one config across Cursor/Codex/Aider, the primary source for a claim | `workflows/reference-resources.md` |
- ### Building software
+ ### Building software (base = Agent System + the one specialist below)
- | Task contains… | Base + specialist |
+ | Task is about… | Specialist |
|---|---|
- | web frontend, React/Vue/Angular/Svelte, a page, a component | Agent System + `project-types/web-development-prompt.md` |
- | REST/GraphQL/gRPC API, an endpoint, a contract | Agent System + `project-types/api-development-prompt.md` (+ `agents/api-design-graphql-prompt.md` for schema design) |
- | end-to-end app, frontend + backend together | Agent System + `agents/fullstack-development-prompt.md` |
- | iOS/Android/React Native/Flutter/KMP | Agent System + `project-types/mobile-development-prompt.md` |
- | desktop app, Tauri/Electron/MAUI/Qt | Agent System + `project-types/desktop-development-prompt.md` |
- | data pipeline, ETL, streaming, Kafka, Airflow | Agent System + `agents/data-engineering-prompt.md` |
- | ML model, training, RAG, an LLM feature | Agent System + `project-types/data-science-ml-prompt.md` (+ `agents/ai-llm-integration-prompt.md` for app integration) |
- | Kubernetes, CI/CD, Terraform/OpenTofu, Docker, Cloudflare | Agent System + `project-types/devops-cicd-prompt.md` (+ `agents/cloud-infrastructure-prompt.md` for multi-region/IaC) |
- | database schema, SQL, indexing, a slow query | Agent System + `agents/database-optimization-prompt.md` (+ `project-types/database-sql-prompt.md` for modeling) |
- | game, Unity/Unreal/Godot/Bevy, netcode | Agent System + `project-types/game-development-prompt.md` |
- | firmware, embedded, IoT, MCU, RTOS | Agent System + `project-types/embedded-iot-prompt.md` |
- | smart contract, Solidity, web3, L2 | Agent System + `project-types/blockchain-web3-prompt.md` |
- | other / language-agnostic | Agent System + `project-types/general-software-development-prompt.md` |
+ | web frontend — React/Vue/Angular/Svelte, a page, a component | `project-types/web-development-prompt.md` |
+ | a REST/GraphQL/gRPC API, an endpoint, a contract | `project-types/api-development-prompt.md` (+ `agents/api-design-graphql-prompt.md` for schema-first design) |
+ | an end-to-end app, frontend + backend together | `agents/fullstack-development-prompt.md` |
+ | iOS / Android / React Native / Flutter / KMP | `project-types/mobile-development-prompt.md` |
+ | a desktop app — Tauri / Electron / MAUI / Qt | `project-types/desktop-development-prompt.md` |
+ | a data pipeline — ETL, streaming, Kafka, Airflow, dbt | `agents/data-engineering-prompt.md` |
+ | an ML model, training, RAG, an LLM feature | `project-types/data-science-ml-prompt.md` (+ `agents/ai-llm-integration-prompt.md` for app-side integration) |
+ | Kubernetes, CI/CD, Terraform/OpenTofu, Docker, Cloudflare | `project-types/devops-cicd-prompt.md` (+ `agents/cloud-infrastructure-prompt.md` for multi-region / IaC depth) |
+ | a database schema, SQL, indexing, a slow query | `agents/database-optimization-prompt.md` (+ `project-types/database-sql-prompt.md` for data modeling) |
+ | a game — Unity / Unreal / Godot / Bevy, netcode | `project-types/game-development-prompt.md` |
+ | firmware, embedded, IoT, an MCU, an RTOS | `project-types/embedded-iot-prompt.md` |
+ | a smart contract, Solidity, web3, an L2 | `project-types/blockchain-web3-prompt.md` |
+ | anything else / language-agnostic | `project-types/general-software-development-prompt.md` |
- ### Improving existing code
+ ### Improving existing code (base = Agent System + the one specialist below)
- | Task contains… | Base + specialist |
+ | Task is about… | Specialist |
|---|---|
- | review this PR / change set | Agent System + `agents/code-review-prompt.md`. Add `agents/ui-design-systems-prompt.md` if the change touches UI, or `agents/security-audit-prompt.md` if it touches auth/data. If git is available and the diff is visible, also mention Claude Code's bundled `/code-review`. |
- | security, vulnerability, threat, auth, secrets | Agent System + `agents/security-audit-prompt.md` |
- | production incident, "it's broken", root cause, a bug | Agent System + `agents/debugging-troubleshooting-prompt.md` |
- | reduce complexity, technical debt, clean up | Agent System + `agents/refactoring-prompt.md` |
- | add tests, test strategy, coverage, flaky test | Agent System + `agents/testing-strategies-prompt.md` |
- | slow, latency, throughput, cost, memory, bundle size | Agent System + `agents/performance-optimization-prompt.md` |
- | migrate a framework/runtime/DB, upgrade a major version | Agent System + `agents/migration-upgrade-prompt.md` |
- | logs, metrics, traces, alerting, observability | Agent System + `agents/monitoring-observability-prompt.md` |
- | fault tolerance, retries, circuit breaker, resilience | Agent System + `agents/error-handling-resilience-prompt.md` |
- | accessibility, WCAG, screen reader, a11y | Agent System + `agents/accessibility-audit-prompt.md` |
+ | reviewing a PR or change set | `agents/code-review-prompt.md`. Also load `agents/ui-design-systems-prompt.md` if the change touches UI, or `agents/security-audit-prompt.md` if it touches auth/data. If git is available and you can see the diff, `/code-review` (the bundled skill) is an option too. |
+ | security — a vulnerability, threat model, auth, secrets | `agents/security-audit-prompt.md` |
+ | a production incident, "it's broken", root cause, a bug | `agents/debugging-troubleshooting-prompt.md` |
+ | reducing complexity or technical debt, cleaning up | `agents/refactoring-prompt.md` |
+ | adding tests, a test strategy, coverage, a flaky test | `agents/testing-strategies-prompt.md` |
+ | slowness — latency, throughput, cost, memory, bundle size | `agents/performance-optimization-prompt.md` |
+ | migrating a framework/runtime/DB, a major version bump | `agents/migration-upgrade-prompt.md` |
+ | logs, metrics, traces, alerting, observability | `agents/monitoring-observability-prompt.md` |
+ | fault tolerance — retries, circuit breakers, resilience | `agents/error-handling-resilience-prompt.md` |
+ | accessibility — WCAG, screen readers, a11y | `agents/accessibility-audit-prompt.md` |
- ### Deciding
+ ### Deciding (base = Agent System + the one specialist below)
- | Task contains… | Load |
+ | Task is about… | Specialist |
|---|---|
- | system design, architecture, a pattern, trade-offs | Agent System + `agents/architecture-patterns-prompt.md` |
- | choose a tool/library, "what should I use for X" | Agent System + `agents/technology-stack-prompt.md` |
- | GDPR/HIPAA/SOC 2/PCI, regulated scope | Agent System + `agents/compliance-governance-prompt.md` |
- | branching, commits, release process | Agent System + `agents/git-version-control-prompt.md` |
- | DX, linting, onboarding, dev environment | Agent System + `agents/developer-experience-tooling-prompt.md` |
- | monorepo, multi-package, Turborepo/Nx | Agent System + `agents/monorepo-complex-projects-prompt.md` |
- | write docs, README, API reference | Agent System + `agents/documentation-prompt.md` |
- | design system, tokens, component library, theming | Agent System + `agents/ui-design-systems-prompt.md` |
+ | system design, an architecture pattern, trade-offs | `agents/architecture-patterns-prompt.md` |
+ | choosing a tool or library — "what should I use for X" | `agents/technology-stack-prompt.md` |
+ | GDPR / HIPAA / SOC 2 / PCI, regulated scope | `agents/compliance-governance-prompt.md` |
+ | branching, commits, the release process | `agents/git-version-control-prompt.md` |
+ | DX, linting, onboarding, the dev environment | `agents/developer-experience-tooling-prompt.md` |
+ | a monorepo, multi-package coordination, Turborepo/Nx | `agents/monorepo-complex-projects-prompt.md` |
+ | writing docs, a README, API reference | `agents/documentation-prompt.md` |
+ | a design system, tokens, a component library, theming | `agents/ui-design-systems-prompt.md` |
## Rules
- - **One base + at most one specialist.** If the task seems to need two specialists, name the primary one and say the second is optional.
- - The base is always `prompts/english/agents/claude-agent-system-prompt.md` unless the task is purely about running Claude Code (then the Claude Code prompt is enough on its own).
- - For a tiny task (typo, rename, one-line fix) say: skip the library, just do it.
- - Do not paste prompt contents. Name the path; the caller loads it.
- - Carry any session constraints (no git, no server start, static-only) into the `Start:` instruction so the loaded prompt respects them.
+ - **One base + at most one specialist.** If two specialists seem to fit, load the primary and name the second as optional.
+ - The base is always `agents/claude-agent-system-prompt.md`, except for a task purely about running Claude Code (then the single Claude Code prompt is enough).
+ - Tiny task (typo, rename, one-line fix): don't load anything — say so and do it.
+ - **Continue, don't restart.** After loading, resume the conversation's in-progress work under the new instructions. Keep every fact, decision, and constraint already established.
+ - If nothing matches cleanly, read `${CLAUDE_SKILL_DIR}/../../../prompts/english/INDEX.md` and route from its task table.
- ## Output format
+ ## Confirmation block (output this, then keep working)
```
- Load: <path>[ + <path>]
- Why: <one sentence>
- Start: paste the base prompt, then "Task: <restated>. Success criteria: <…>. Begin with Analyze."
+ Loaded: agents/claude-agent-system-prompt.md + <specialist path> [+ <optional second>]
+ Task (continuing): <one line, from the conversation>
+ Success criteria: <measurable>
+ Constraints carried over: <list, or "none">
```
+ Then proceed with the task under the loaded protocol — from where it stands, not from zero.