mrkeyoor.com_
Tue 01 Sept 17:44 UTC
LLM Toolsevaluationupdated 19 Aug 2026

claude-code-system-prompts review

Claude Code System Prompts is an unofficial, versioned archive of prompt text extracted from Claude Code's compiled npm package. It separates hundreds of system instructions, tool descriptions, agent prompts, reminders, skills, and data blocks into searchable Markdown files so researchers and prompt authors can see what changed.

+82stars / 7d
Verdict

This is the best kind of unofficial reference: current, granular, diffable, and honest in its repository guidance about not being the real source code. Use it to investigate behavior and track prompt evolution, not as a vendor contract or a drop-in prompt library. The recent extraction fix and open coverage requests show why every important conclusion should be checked against the matching Claude Code version and, when possible, observed runtime behavior.

We ran it

Screenshot of claude-code-system-prompts (github.com/Piebald-AI/claude-code-system-prompts)

Answers from our run

Did you run claude-code-system-prompts yourself?

No. Its code is JavaScript, and it carries no manifest our lab installs from, and no Dockerfile, so there was nothing standard to install, build or test. This review is written from the repository's own documentation.

Who should not use claude-code-system-prompts?

Anyone requiring official Anthropic documentation or source code: the repository is maintained by Piebald AI, and its own CLAUDE.md says Claude Code's source is not publicly available.

What are the alternatives to claude-code-system-prompts?

Claude Code, tweakcc, Awesome Claude Code. This is the best kind of unofficial reference: current, granular, diffable, and honest in its repository guidance about not being the real source code.

Setup4/5Instant to browse, but regeneration is not a turnkey workflow
Docs4/5Huge indexed archive and changelog, with limited build guidance
Community4/5Strong adoption, rapid releases, and responsive extraction fixes
Maturity4/5Versioned automation is solid, though coverage gaps still surface

Who it’s for

Developers researching how Claude Code divides instructions among agents, tools, skills, reminders, and utility tasks.
Teams auditing behavioral changes between Claude Code releases before updating their own environment.
Prompt and agent-tool authors looking for concrete examples of instruction structure, conditional variables, and tool descriptions.
Claude Code users who want to identify a prompt before modifying a local installation with a separate patching tool.

Who it’s NOT for

Anyone requiring official Anthropic documentation or source code: the repository is maintained by Piebald AI, and its own CLAUDE.md says Claude Code's source is not publicly available.
Users expecting edits in this repository to change Claude Code: these Markdown files are reference material, not the application's modifiable source.
Auditors who need the exact prompt assembled for one live session: the README says sections are conditional, variables are interpolated at runtime, and token counts vary by context.
Tool-runtime implementers needing full JSON input schemas: issue #22 and related open pull requests show that the archive covers tool prose but not those schemas.
Researchers treating the word all as a completeness guarantee: issue #35 found omitted concatenated tool-description fragments, and issue #33 requests still-missing output-style prompts.
Teams wanting a self-contained reproduction pipeline: the tracked updater consumes already-extracted JSON and requires an Anthropic API key for token counting.

Setup reality

Reference use has almost no setup: browse the generated Markdown on GitHub, clone it for local search, or use the changelog and version tags. Reproducing an update is a different proposition. The included JavaScript updater expects a prompt JSON file produced by a separate extraction step, calls Anthropic's API to count changed prompts, fetches npm metadata, rewrites the README, and removes prompt files absent from the new input. There is no root package manifest or documented one-command build, so most readers should treat the published archive as the product rather than expect a turnkey extractor.

Claude Code has many prompts, not one

The useful insight behind this repository is that Claude Code cannot be understood by reading one master instruction. Its behavior is assembled from many pieces: core system guidance, descriptions for built-in tools, prompts for specialized agents, reminders injected under certain conditions, utility prompts for jobs such as compaction, and increasingly large skills and data references. Which pieces appear depends on the environment, configuration, available tools, and task.

Piebald AI extracts those strings from the compiled @anthropic-ai/claude-code npm package and writes each one to a Markdown file. The archive labels files by role and includes comment-based frontmatter with a name, description, Claude Code version, template variables, and agent metadata where available. The README acts as a generated index with token counts and short explanations. This turns a large minified JavaScript bundle into something humans can search, link to, and diff.

That organization is genuinely valuable. A tool author can examine the instruction shown to an editing tool. A prompt engineer can compare the planning agent with the exploration agent. A team considering an upgrade can open the changelog and see which instructions appeared, changed, or disappeared instead of guessing from user-visible release notes alone.

Version tracking is the standout feature

The repository follows Claude Code's version numbers. Version 2.1.235 of the archive was released on August 19, 2026, the same day as the latest repository push, and the README ties it to the corresponding npm package. Releases link directly to a commit diff and summarize newly added, changed, and removed prompt pieces. Even Claude Code releases with no prompt changes receive an explicit archive release saying so.

The changelog covers 260 versions since 2.0.14. That history makes the project more useful than a one-time prompt dump. You can trace how a tool description evolved, determine when an agent workflow appeared, or review sudden token growth. The Markdown files are also far easier to inspect with Git than copied terminal output or screenshots.

Token counts help identify unusually large instructions, but they are not measurements of one real session. The README says some files retain placeholders for tool names, agent lists, and other runtime values, and estimates that substitution can move counts slightly. More importantly, conditional files in the repository are not all loaded at once. Adding every listed number would misrepresent the context Claude Code actually sends for a given turn.

Exact text does not mean complete runtime context

The extraction method supports a strong claim: when a string is found and reconstructed, it comes from compiled Claude Code rather than a community rewrite. That does not make the archive an official specification. Piebald AI maintains it, not Anthropic, and the repository's CLAUDE.md explicitly says these files are extracted reference material. Editing them does nothing to an installed copy of Claude Code. The project points users to tweakcc for local patching and conflict handling.

Coverage also has edges. Issue #35 showed that the archive had only the second fragment of the ToolSearch description and missed related fragments for other tools. Pull request #36 fixed the extraction shape within a day, which reflects well on maintenance, but it also demonstrates that source strings can be present without the extractor recognizing how they combine at runtime. Open issue #33 asks for built-in output-style prompts that are not included.

Tool descriptions are only one half of a callable tool contract. Issue #22 and open pull requests #24 and #25 discuss adding JSON input schemas for built-in tools. Until that work is accepted, someone recreating a compatible runtime would have prose descriptions but not the full required fields, enums, and validation rules. This archive is excellent evidence, but it is not a complete protocol definition.

Reading is easy, reproduction is not

There is nothing to install for normal use. GitHub renders each prompt, cloning enables fast local search, and release tags preserve version snapshots. The 170 KB README is long because it lists hundreds of artifacts; browser search or repository search is more practical than scrolling. The 433 KB changelog needs the same targeted approach.

The tracked update tooling is aimed at maintainers. updatePrompts.js reads a JSON export containing prompt pieces and identifiers, reconstructs Markdown, carries forward unchanged token counts, and calls Anthropic's token-counting API for new or changed text. It then updates the index and removes stale generated files. An ANTHROPIC_API_KEY is mandatory for that counting step. The repository does not include a root package manifest or a documented command that produces the input JSON from a fresh Claude Code package, so cloning alone does not reproduce the entire extraction pipeline.

There are tests for Markdown filename and frontmatter utilities, which is good, but users must still trust the unpublished or separate extraction stage that finds the original strings. For research requiring repeatability, document the archive commit, matching Claude Code version, and any runtime capture used to confirm assembly.

Healthy maintenance with a narrow mission

On August 19, the open queue contained six issues and three pull requests. Some requests are intentionally adjacent to the project's mission, such as architecture diagrams, tool schemas, and prompts from another coding product. More telling is the response to actual archive defects: the missing ToolSearch fragments reported on August 13 were repaired and merged on August 14. Releases arrived repeatedly throughout the same week as upstream versions changed.

This is a mature reference workflow despite being less than a year old. Its best use is comparative research: find a prompt, read its variables and metadata, then inspect the version diff. Do not copy an isolated instruction and expect Claude Code's behavior, because tools, schemas, runtime substitutions, surrounding prompts, and model behavior all contribute. Used with that discipline, the archive saves hours of opaque bundle inspection and makes an otherwise hidden product surface meaningfully reviewable.

Alternatives

ProjectWhat it isPick it when
Claude Code gh↗Anthropic's official repository for Claude Code releases, documentation links, and issue tracking.pick this instead when you need authoritative product guidance, release notes, or a place to report behavior.
tweakccA separate customization tool that patches individual prompts and interface details in local Claude Code installations.pick this instead when your goal is to change local Claude Code behavior rather than only inspect extracted text.
Awesome Claude Code gh↗A curated directory of Claude Code skills, agents, plugins, hooks, and supporting tools.pick this instead when you want reusable community extensions rather than an archive of built-in instructions.

What people are saying

  1. [github-trending] Piebald-AI/claude-code-system-prompts

Sources

  1. Claude Code System Prompts repository
  2. Archive README and extraction notes
  3. Repository guidance for AI agents
  4. Versioned prompt changelog
  5. Prompt archive update script
  6. Missing ToolSearch fragment issue
  7. Missing output styles issue
  8. Built-in tool schema scope issue

More llm tools reviews

rig · open-knowledge · graphiti · cve-mcp-server · minimind · SillyTavern · the whole board →