Home / owenob1 / prompt-improver · CLAUDE.md · GitHub

CLAUDE.md claudeA

CLAUDE.md is agent-read markdown (claude) from owenob1/prompt-improver.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## What this is

A pure-Bash Agent Skill (no build step, no package manager, no compiled code), plus `mcp/`, a TypeScript Cloudflare Worker that serves the skill's rules over MCP, and `site/`, the Astro + shadcn/ui info page that worker serves at `/`. It takes a vague coding request and rewrites it into a structured XML spec by shelling out to a *separate* coding CLI (`claude`, `grok`, `codex`, `gemini`, …) headlessly, then hands the result back to the host agent to execute.

## Commands

```bash
bash tests/smoke-test.sh                          # full suite — this is what CI runs
bash skills/prompt-improver/scripts/smoke-test.sh # skill-package checks only (24 groups, offline stub CLIs)
cd mcp && npm ci && npm run typecheck && npm test  # hosted MCP server (CI job `mcp`)
```

There is no test-name filter. To iterate on one check, run the underlying script directly:

```bash
cd skills/prompt-improver
bash scripts/validate-prompt.sh examples/fixtures/valid-prompt.xml    # expect exit 0
…

Read the whole file at its exact version.

How to install

Latest version
mdr add owenob1/prompt-improver/CLAUDE.md@git:20260924.2c8dcc5
Exact content
mdr add owenob1/prompt-improver/CLAUDE.md@sha256:938755d1c936e299

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_7w3j4ojjx5g5kl65.svg)](https://markdownregistry.com/a/art_7w3j4ojjx5g5kl65)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260924.2c8dcc5 latest2026-09-24 2c8dcc5 10,571 BA view · diff
git:20260924.8a455d52026-09-24 8a455d5 10,499 BA view · diff
git:20260923.7b35ff72026-09-23 7b35ff7 9,603 BA view · diff
git:20260710.bac34ff2026-07-10 bac34ff 7,393 BA view

Audit of the latest version

A  14 of 14 checks passed. Deterministic, no model, same answer every run.
  • pass: Size between 200 bytes and 200 KB (10571 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

owenob1/prompt-improver · 6 stars · license MIT · pushed 2026-09-24 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_7w3j4ojjx5g5kl65
GET https://markdownregistry.com/api/v1/resolve?ref=owenob1/prompt-improver/CLAUDE.md
GET https://markdownregistry.com/api/v1/blob/938755d1c936e2990483e3aacec91c1a0a7d42667a840fd14386329e3e6450a2

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from owenob1/prompt-improver

AGENTS.md agents
owenob1/prompt-improver · AGENTS.md
git:20260709.313c8c1 · audit A · 6 stars
prompt-improver skill
owenob1/prompt-improver · mcp/skill/SKILL.md · Turn a vague coding request into a precise, verifiable XML spec, then execute it or show it for review. Use when the…
git:20260924.8a455d5 · audit A · 6 stars
prompt-improver skill
owenob1/prompt-improver · skills/prompt-improver/SKILL.md · Transform vague prompts into precise, verifiable structured XML prompts that coding agents execute reliably. Modes…
v1.1.0 · audit A · 6 stars

Every file in owenob1/prompt-improver

Other files named CLAUDE.md

CLAUDE.md claude
obra/superpowers · CLAUDE.md
git:20260919.5bf4e78 · audit B · 291,204 stars
CLAUDE.md claude
affaan-m/ecc · CLAUDE.md
git:20260528.04c68e4 · audit A · 266,832 stars
CLAUDE.md claude
firecrawl/firecrawl · CLAUDE.md
git:20260615.fe8d358 · audit A · 184,144 stars
CLAUDE.md claude
garrytan/gstack · CLAUDE.md
git:20260924.06ed920 · audit A · 134,082 stars
CLAUDE.md claude
juliusbrussee/caveman · CLAUDE.md
git:20260908.bb1cfc8 · audit B · 107,708 stars
CLAUDE.md claude
addyosmani/agent-skills · CLAUDE.md
git:20260720.8fd2081 · audit A · 98,554 stars
CLAUDE.md claude
nexu-io/open-design · CLAUDE.md
git:20260430.9b57c22 · audit B · 97,933 stars
CLAUDE.md claude
thedotmack/claude-mem · CLAUDE.md
git:20260723.e29d221 · audit A · 94,550 stars

Browse by kind, by grade A, or by owner.