Skip to content
Back to search

claude-prompts

Model Context Protocol (MCP) server for versioned prompt templates, multi-step workflow chains, and quality gates. Symbolic syntax: >>prompt --> >>chain @framework :: 'gate'

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/minipuft/claude-prompts-mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/minipuft/claude-prompts-mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/minipuft--claude-prompts-mcp/badge.svg)](/listings/minipuft--claude-prompts-mcp)

HTML

<a href="/listings/minipuft--claude-prompts-mcp"><img src="/api/listings/minipuft--claude-prompts-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code (Recommended)

# Add marketplace (first time only)
/plugin marketplace add minipuft/minipuft-plugins

# Install
/plugin install claude-prompts@minipuft

# Try it
>>tech_evaluation_chain library:'zod' context:'API validation'

<details> <summary>Development setup</summary>

Load plugin from local source for development:

git clone https://github.com/minipuft/claude-prompts-mcp ~/Applications/claude-prompts-mcp
cd ~/Applications/claude-prompts-mcp/server && npm install && npm run build
claude --plugin-dir ~/Applications/claude-prompts-mcp

Edit hooks/prompts → restart Claude Code. Edit TypeScript → rebuild first.

</details>

<a id="codex-install"></a>

Codex (Experimental)

Codex hooks require Codex CLI 0.117 or later and are unavailable on Windows. See the [codex-prompts requirements](https://github.com/minipuft/codex-prompts#requirements) for Python and Node.js prerequisites.

Enable hooks in `~/.codex/config.toml`:

[features]
hooks = true

Then install the plugin:

codex plugin marketplace add https://github.com/minipuft/minipuft-plugins.git
codex plugin add codex-prompts@minipuft

Restart Codex, run `/hooks` to review the plugin hooks, then try `>>tech_evaluation_chain library:'zod' context:'API validation'`.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/plugin.json · Manifest · 19 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "claude-prompts",
  3. "description": "Model Context Protocol (MCP) server for versioned prompt templates, multi-step workflow chains, and quality gates. Symbolic syntax: >>prompt --> >>chain @framework :: 'gate'",
  4. "author": {
  5. "name": "minipuft"
  6. },
  7. "homepage": "https://github.com/minipuft/claude-prompts-mcp",
  8. "repository": "https://github.com/minipuft/claude-prompts-mcp",
  9. "license": "MIT",
  10. "keywords": [
  11. "mcp",
  12. "prompts",
  13. "templates",
  14. "gates",
  15. "chains",
  16. "workflows"
  17. ],
  18. "version": "5.1.1"
  19. }
README.md · README · 393 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <!-- maintainers: this README is governed by docs/portfolio/readme-charter.md — run `cd server && npm run validate:readme` before committing changes -->
  2. <div align="center">
  3. <img src="assets/brand/claude-prompts-avatar.svg" alt="Claude Prompts mascot, an asymmetric curled creature forming a C-shaped counter with two directional eyes" width="160" />
  4. <h1>Claude Prompts</h1>
  5. **The portable workflow layer beside your AI coding harness.**
  6. <p>Your client executes with its own tools, agents, and context.<br>
  7. Claude Prompts adds reusable prompt resources, composable chains, validation gates, and client-native skill export.</p>
  8. <p>
  9. <a href="#claude-code-recommended"><img src="https://img.shields.io/badge/Claude_Code-Set_up_plugin-D97757?style=flat-square&amp;logo=anthropic&amp;logoColor=white&amp;labelColor=111715" alt="Set up the Claude Code plugin"></a>
  10. <a href="#codex-install"><img src="https://img.shields.io/badge/Codex-Set_up_experimental-2A8F83?style=flat-square&amp;logo=openai&amp;logoColor=white&amp;labelColor=111715" alt="Set up the experimental Codex plugin"></a>
  11. </p>
  12. <p>
  13. <a href="https://www.npmjs.com/package/claude-prompts"><img src="https://img.shields.io/npm/v/claude-prompts.svg?style=flat-square&amp;logo=npm&amp;logoColor=white&amp;labelColor=111715&amp;color=2A8F83" alt="npm version"></a>
  14. <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-555E5A.svg?style=flat-square&amp;labelColor=111715" alt="MIT license"></a>
  15. </p>
  16. [Quick Start](#quick-start) · [What You Get](#what-you-get) · [Compose Workflows](#compose-workflows) · [Run Anywhere](#run-anywhere) · [Docs](#documentation)
  17. </div>
  18. ### What your AI client gives you — and what this server adds
  19. | Your client already does | This server adds |
  20. | -------------------------- | ------------------------------------------------------------------------------------- |
  21. | Run a prompt | Compose prompts with validation, reasoning guidance, and formatting in one expression |
  22. | Single-shot skills | Multi-step workflows that thread context between steps |
  23. | Execute subagents | Hand off mid-chain steps to agents with full workflow context |
  24. | Client-native skill format | Author once as YAML, export to any client with `skills:export` |
  25. | Manual prompt writing | Versioned templates with hot-reload, rollback, and history |
  26. | Trust the output | Validate output between steps: self-evaluation and shell commands |
  27. ### Is this for me?
  28. - **Use this if** you write the same prompts repeatedly, run multi-step workflows, or want to share reusable prompts with a team.
  29. - **Skip if** your client's built-in `/commands` already handle what you need, or you're looking for a no-code prompt library.
  30. - **Works with** Claude Code, Claude Desktop, Cursor, VS Code, OpenCode, Gemini CLI, Codex, and Windsurf. Hook coverage differs by client; the [client list](#every-client) shows it.
  31. ---
  32. <!-- diataxis: how-to -->
  33. ## Quick Start
  34. ### Claude Code (Recommended)
  35. ```bash
  36. /plugin marketplace add minipuft/minipuft-plugins # first time only
  37. /plugin install claude-prompts@minipuft
  38. >>tech_evaluation_chain library:'zod' context:'API validation'
  39. ```
  40. <a id="codex-install"></a>
  41. ### Codex (Experimental)
  42. Turn on hooks in `~/.codex/config.toml`, then install the plugin:
  43. ```toml
  44. [features]
  45. hooks = true
  46. ```
  47. ```bash
  48. codex plugin marketplace add https://github.com/minipuft/minipuft-plugins.git
  49. codex plugin add codex-prompts@minipuft
  50. ```
  51. Restart Codex, run `/hooks` to review and trust the plugin hooks, then try the same `>>tech_evaluation_chain` command. Needs Codex CLI 0.117 or later; not available on Windows ([requirements](https://github.com/minipuft/codex-prompts#requirements)).
  52. ---
  53. <!-- diataxis: how-to -->
  54. ## Every Client
  55. <!-- BEGIN GENERATED: client-matrix:setup (generated from docs/reference/clients.json: edit that file, run npm --prefix server run generate:client-matrix) -->
  56. <details>
  57. <summary><strong>All 8 clients: setup and hook coverage</strong><br><sub>2 full · 1 experimental · 1 partial · 4 MCP tools only</sub></summary>
  58. **Hooks** are what make `>>`, `-->`, and `::` work in conversation; "MCP tools only" means the three MCP tools without them. See [With Hooks](#with-hooks). Config locations and `--client` presets: [Client Capabilities Reference](docs/reference/client-capabilities.md).
  59. <details name="clients"><summary><picture><img src="https://img.shields.io/badge/Hooks-Full-2A8F83?style=flat-square&amp;labelColor=111715" alt="Hooks: Full" height="20"></picture> <strong>Claude Code</strong> <sub>Plugin</sub></summary>
  60. [Steps in Quick Start](#claude-code-recommended).
  61. </details>
  62. <details name="clients"><summary><picture><img src="https://img.shields.io/badge/Hooks-Full-2A8F83?style=flat-square&amp;labelColor=111715" alt="Hooks: Full" height="20"></picture> <strong>OpenCode</strong> <sub>npm installer</sub></summary>
  63. ```bash
  64. npm install -g opencode-prompts && opencode-prompts install
  65. ```
  66. For MCP tools without hooks, use the manual config in the [Client Integration Guide](docs/guides/client-integration.md).
  67. </details>
  68. <details name="clients"><summary><picture><img src="https://img.shields.io/badge/Hooks-Experimental-D97757?style=flat-square&amp;labelColor=111715" alt="Hooks: Experimental" height="20"></picture> <strong>Codex</strong> <sub>Plugin</sub></summary>
  69. [Steps in Quick Start](#codex-install). Hooks are off by default and need a one-time `/hooks` trust review.
  70. </details>
  71. <details name="clients"><summary><picture><img src="https://img.shields.io/badge/Hooks-Partial-B7892B?style=flat-square&amp;labelColor=111715" alt="Hooks: Partial" height="20"></picture> <strong>Gemini CLI</strong> <sub>Extension</sub></summary>
  72. ```bash
  73. gemini extensions install https://github.com/minipuft/gemini-prompts
  74. ```
  75. For MCP tools without hooks, use the manual config in the [Client Integration Guide](docs/guides/client-integration.md).
  76. </details>
  77. <details name="clients"><summary><picture><img src="https://img.shields.io/badge/Hooks-MCP_tools_only-555E5A?style=flat-square&amp;labelColor=111715" alt="Hooks: MCP tools only" height="20"></picture> <strong>Claude Desktop</strong> <sub>Desktop bundle or npx config</sub></summary>
  78. **Option A: GitHub Release** (recommended): download `claude-prompts-{version}.mcpb` from [Releases](https://github.com/minipuft/claude-prompts-mcp/releases/latest) and drag it into Claude Desktop Settings → MCP Servers. The `.mcpb` bundle is self-contained (~5MB); no npm required.
  79. **Option B: NPX** (auto-updates): add this to your config file (macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`, Windows: `%APPDATA%\Claude\claude_desktop_config.json`):
  80. ```json
  81. {
  82. "mcpServers": {
  83. "claude-prompts": {
  84. "command": "npx",
  85. "args": ["-y", "claude-prompts@latest", "--client", "claude-code"]
  86. }
  87. }
  88. }
  89. ```
  90. Restart Claude Desktop and test: `>>research_chain topic:'remote team policies'`
  91. </details>
  92. <details name="clients"><summary><picture><img src="https://img.shields.io/badge/Hooks-MCP_tools_only-555E5A?style=flat-square&amp;labelColor=111715" alt="Hooks: MCP tools only" height="20"></picture> <strong>Cursor, VS Code, Windsurf</strong> <sub>MCP config</sub></summary>
  93. **Cursor and Windsurf** (now Devin Desktop) use the same block. Add it to `~/.cursor/mcp.json` for Cursor, or to `~/.config/devin/mcp_config.json` for Windsurf (Windows: `%APPDATA%\devin\mcp_config.json`):
  94. ```json
  95. {
  96. "mcpServers": {
  97. "claude-prompts": {
  98. "command": "npx",
  99. "args": ["-y", "claude-prompts@latest", "--client=cursor"]
  100. }
  101. }
  102. }
  103. ```
  104. **VS Code** uses a different shape. Add this to `.vscode/mcp.json` in your project, or to your user profile's `mcp.json`:
  105. ```json
  106. {
  107. "servers": {
  108. "claude-prompts": {
  109. "type": "stdio",
  110. "command": "npx",
  111. "args": ["-y", "claude-prompts@latest", "--client=unknown"]
  112. }
  113. }
  114. }
  115. ```
  116. Restart the client after saving. Presets and verification: [Client Integration Guide](docs/guides/client-integration.md).
  117. </details>
  118. </details>
  119. <!-- END GENERATED: client-matrix:setup -->
  120. ---
  121. <!-- diataxis: reference -->
  122. ## What You Get
  123. Four primitives you author, version, and compose. The bundled set ships 52 prompts across 9 categories — a starting library, not the ceiling: your AI writes new prompts and chains through `resource_manager` as it works, so the set grows around what you actually do. All hot-reloadable, all versioned with rollback.
  124. | Primitive | Symbol | What it is | Example |
  125. | --------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------- |
  126. | Prompt template | `>>` | Versioned YAML with named arguments; hot-reload on save | `>>review target:'src/auth/'` |
  127. | Gate | `::` | Validation criterion the AI checks its own output against; blocking or advisory; can shell-verify | `:: 'cite sources'` · `:: verify:"npm test"` |
  128. | Framework | `^` | Reasoning framework that shapes how the AI works through the problem; plug in your own or use built-ins like `^ReACT`, `^5W1H`, or the project's own `^CAGEERF` scaffold ([Frameworks Guide](docs/guides/frameworks.md)) | `^ReACT` · `^your_framework` |
  129. | Style | `#` | Output formatting and tone | `#analytical` · `#procedural` |
  130. Prompts, gates, and frameworks are managed through the `resource_manager` tool. Your AI creates, edits, versions, and rolls them back through MCP, no file editing required. Styles are managed with the bundled `cpm` CLI. Failed gate checks can retry automatically or pause for your decision ([Gates Guide](docs/guides/gates.md)). Build your first primitive: [Prompt Authoring Tutorial](docs/tutorials/build-first-prompt.md).
  131. ### Your own prompts
  132. Your own prompts, gates and frameworks live in a workspace you choose. `--init=~/my-prompts` scaffolds a starter workspace: three example prompts plus `config.jsonc`. Edit them (YAML schema), or have your AI author new prompts, gates, and frameworks via `resource_manager`. Set `MCP_WORKSPACE` to that folder in your client's server `env` to use it, and name it with `cpm workspace add <label> <dir>` to switch between several. Resources that belong to one repository go in `.claude-prompts/` at its root (`cpm init --project` scaffolds it) and load above your workspace over STDIO. See [Custom Resources Guide](docs/guides/custom-resources.md).
  133. ### The Three Tools
  134. Everything above reaches your client through three MCP tools:
  135. | Tool | Purpose |
  136. | ------------------ | ------------------------------------------------ |
  137. | `prompt_engine` | Execute prompts with frameworks and validation |
  138. | `resource_manager` | Create, update, version, and roll back resources |
  139. | `system_control` | Status, analytics, framework switching |
  140. Most users invoke these via `>>` syntax in conversation; hooks construct the actual calls. For programmatic MCP clients calling tools directly, see [MCP Tools Reference](docs/reference/mcp-tools.md).
  141. ---
  142. <!-- diataxis: how-to -->
  143. ## Compose Workflows
  144. ### How to write a chain
  145. <!-- illustrative-prompts: security_scan implementation -->
  146. ```
  147. >>review target:'src/auth/' ^ReACT :: 'cite sources'
  148. --> security_scan :: verify:"npm test"
  149. ==> implementation
  150. ```
  151. Read top-to-bottom:
  152. - `>>review target:'src/auth/'` runs the `review` prompt against your auth folder.
  153. - `^ReACT` overlays the ReACT reasoning framework on this step.
  154. - `:: 'cite sources'` adds a gate the AI must satisfy (cite sources, or retry).
  155. - `--> security_scan :: verify:"npm test"` chains to step 2, which must pass `npm test` before producing output.
  156. - `==> implementation` hands the final step off to a client-native agent (a subagent in Claude Code).
  157. `review` ships with the server; `security_scan` and `implementation` stand in for prompts you write.
  158. Validation runs between steps, not only at the end. For the full operator grammar and examples, see [MCP Tools Reference](docs/reference/mcp-tools.md).
  159. <div align="center">
  160. <video src="https://github.com/user-attachments/assets/3123e6c5-e890-4e03-8e35-ebfc0467125b" width="720" autoplay loop muted playsinline controls title="One Claude Code session, with a side panel showing what the hooks and the server do: npm test fails, >>status is routed by the hook, resource_manager creates a prompt, a two-step chain runs it under ^ReACT, the server runs npm test as the gate, and the review step approves the result"></video>
  161. <details>
  162. <summary>No video player here? Open the GIF.</summary>
  163. <img src="assets/demos/hero-demo.gif" alt="One Claude Code session, with a side panel showing what the hooks and the server do: npm test fails, >>status is routed by the hook, resource_manager creates a prompt, a two-step chain runs it under ^ReACT, the server runs npm test as the gate, and the review step approves the result" width="720" />
  164. </details>
  165. <sub>Recorded live in Claude Code (Sonnet), sped up, nothing re-ordered or retyped. The side panel shows what each hook and the server's <code>npm test</code> gate did.</sub>
  166. </div>
  167. Two patterns extend the basic syntax. Chains also support context threading between steps and agent handoffs. See [Chains Lifecycle](docs/concepts/chains-lifecycle.md) and [MCP Tools Reference](docs/reference/mcp-tools.md).
  168. <details>
  169. <summary><strong>See the output</strong>: tech evaluation chain with context7 research</summary>
  170. <br>
  171. <img src="assets/demos/chain-workflow-demo.gif" alt="Tech evaluation chain researching Zod via context7, producing a scored assessment table with security, performance, DX, integration, and ecosystem ratings" width="720" />
  172. <sub>Context7 fetches live library docs mid-chain. The final output is a structured assessment with sources.</sub>
  173. </details>
  174. ### Verification Loops
  175. <!-- illustrative-prompts: implement-feature -->
  176. Ground-truth validation via shell commands. The AI keeps iterating until tests pass:
  177. ```
  178. >>implement-feature :: verify:"npm test" loop:true
  179. ```
  180. Implements, runs the test, reads failures, fixes, retries. Spawns a fresh context after repeated failures to avoid context rot.
  181. `implement-feature` stands for your own prompt: `:: verify` attaches to any of them.
  182. | Preset | Tries | Timeout | Use Case |
  183. | ----------- | ----- | ------- | ----------------- |
  184. | `:fast` | 1 | 30s | Quick check |
  185. | `:full` | 5 | 5 min | CI validation |
  186. | `:extended` | 10 | 10 min | Large test suites |
  187. For autonomous test-fix cycles with context-rot prevention: [Ralph Loops Guide](docs/guides/ralph-loops.md).
  188. ### Judge Mode
  189. Let the AI pick the right resources for the task:
  190. ```
  191. %judge Help me refactor this authentication module
  192. ```
  193. Analyzes available templates, reasoning frameworks, validation rules, and styles, then recommends the best combination. You confirm before it runs. For scoring and overrides see [Judge Mode Guide](docs/guides/judge-mode.md).
  194. ---
  195. <!-- diataxis: how-to -->
  196. ## Run Anywhere
  197. Author workflows as YAML templates. Export as native skills to your client.
  198. ```yaml
  199. # skills-sync.yaml — choose what to export
  200. registrations:
  201. claude-code:
  202. user:
  203. - prompt:development/review
  204. - prompt:development/validate_work
  205. ```
  206. ```bash
  207. npm run skills:export
  208. ```
  209. The `review` prompt becomes a `/review` Claude Code skill. `validate_work` becomes `/validate_work`. Same source, native experience; no MCP call required at runtime.
  210. Compiles to native skill packages for Claude Code, Cursor, Codex and OpenCode. `npm run skills:diff` flags when exports drift from source. Configuration, supported clients, and drift detection: [Skills Sync Guide](docs/guides/skills-sync.md).
  211. ---
  212. <!-- diataxis: explanation -->
  213. ## With Hooks
  214. Without hooks, you're calling the three MCP tools explicitly (the LLM constructs each call). With hooks, the operators work in conversation: `>>`, `-->`, `==>`, `::` feel native rather than mediated, and workflow state survives across LLM turns and context compaction.
  215. What hooks unlock:
  216. | Hook | Unlocks |
  217. | -------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
  218. | **Auto-routing** | `>>research_chain topic:'X'` in chat fires the right MCP tool call without you naming it |
  219. | **Chain continuity across compaction** | Multi-step chains preserve state when context compacts mid-execution; the chain doesn't restart from scratch |
  220. | **Cross-step verdict tracking** | Gate pass/fail verdicts thread across all chain steps without the LLM re-deriving them |
  221. | **Native agent handoffs** | `==>` routes to your client's subagent system automatically; no manual subagent invocation |
  222. | **Session persistence** | Workflow state preserved when context compacts mid-chain |
  223. Hooks ship with the plugin install; the [client list](#every-client) shows which clients have them. Detail: [hooks/README.md](hooks/README.md).
  224. ---
  225. <!-- diataxis: explanation -->
  226. ## How It Works
  227. Command with operators → server parses and injects resources (framework, gates, style) → client executes the rendered prompt and self-evaluates against the gates → router decides: next step on pass, retry on fail, return on done.
  228. Full request lifecycle, pipeline stages, and subsystem diagrams: [Architecture Overview](docs/architecture/overview.md).
  229. ---
  230. <!-- diataxis: reference -->
  231. ## Documentation
  232. Choose a guide based on what you want to do: learn by building, complete a task, look up syntax, or understand the design.
  233. → **[docs/README.md](docs/README.md)**
  234. Quick jumps: [Build your first prompt](docs/tutorials/build-first-prompt.md) · [Chains lifecycle](docs/concepts/chains-lifecycle.md) · [MCP Tools reference](docs/reference/mcp-tools.md) · [Architecture overview](docs/architecture/overview.md) · [Troubleshooting](docs/guides/troubleshooting.md)
  235. ---
  236. <!-- diataxis: how-to -->
  237. ## Contributing
  238. Run it from source, as a Claude Code plugin or for any other MCP client:
  239. ```bash
  240. git clone https://github.com/minipuft/claude-prompts-mcp.git && cd claude-prompts-mcp
  241. (cd server && npm install && npm run build) # esbuild bundles to server/dist/index.js
  242. claude --plugin-dir . # load it as a Claude Code plugin
  243. ```
  244. For any other MCP client, point its config at `server/dist/index.js`; transport is `--transport=stdio` (default) or `--transport=streamable-http`. Edit hooks or prompts → restart the client. Edit TypeScript → rebuild first.
  245. ```bash
  246. cd server
  247. npm test # Run test suite
  248. npm run validate:all # Full CI validation
  249. ```
  250. The build produces a self-contained bundle. `server/dist/` is gitignored, and CI builds fresh from source.
  251. See [CONTRIBUTING.md](CONTRIBUTING.md) for workflow details.
  252. ---
  253. <!-- diataxis: reference -->
  254. ## License
  255. [MIT](LICENSE)

Version history

  • v5.1.110/7/2026

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.