- Home
- Skills
- Prompt & Skill Engineering
- CLAUDE.md Writer
More screenshots
Works with the AI Agents you already use
CLAUDE.md Writer
Write, audit and fix CLAUDE.md, AGENTS.md and .claude/rules from facts in your repository, with a linter that checks them against the code.
Free
CLAUDE.md Writer
Example session with this skill installed
Our CLAUDE.md is a year old and Claude keeps running commands that don't exist. Fix it.
- Read your context and instructions
- Compiled the claude md writer
CLAUDE.md audited and rewritten
I ran the linter against the repo first
$ python lint_claude_md.py
WARN CLAUDE.md:1 [shouting] 6 uses of IMPORTANT/MUST/NEVER/ALWAYS in caps
ERROR CLAUDE.md:6 [commands] `pnpm run e2e`: no package.json script named 'e2e'
ERROR CLAUDE.md:7 [commands] `make deploy`: there is no Makefile
WARN CLAUDE.md:10 [paths] `src/checkout/` does not exist in the repo
WARN CLAUDE.md:13 [vague] "write clean code" cannot be verified
WARN CLAUDE.md:14 [conflicts] says both use and do not use 'moment'
ERROR CLAUDE.md:16 [secrets] looks like a connection string with password
3 error, 4 warning, 0 info
What I changed
| Problem | Fix |
|---|---|
pnpm run e2e and make deploy do not exist | Replaced with the commands CI runs: pnpm test, pnpm lint, pnpm typecheck |
src/checkout/ was removed in a refactor | Removed; the file now names src/orders/ and src/payments/ |
| "Never use moment" and "use moment for timezones" | Kept one rule: dates are ISO 8601 in UTC at the API |
| A staging database URL with password | Removed; it now names DATABASE_URL. Rotate that password, it has been in git |
| Six rules in capitals | Plain, specific instructions |
Added what was missing: how to run one test (pnpm vitest run src/orders/service.test.ts) and a "before saying a task is done" line.
$ python lint_claude_md.py
Checked CLAUDE.md (16 lines)
0 error, 0 warning, 0 info
Next step
Add python lint_claude_md.py to CI so the file fails the build when it drifts from the code again.
Connects securely to your tools. The creator never sees your data.
About this skill
What it does
The instruction file is read at the start of every agent session. Most are generated once and never checked, or grow into generic advice the agent stops following. This skill writes one from verified facts and keeps it honest.
Two scripts, standard library only
repo_facts.py reports what the repo actually contains: every defined command (package.json per workspace, Makefile, justfile, Taskfile, pyproject, tox, nox, composer), what CI really runs, toolchain and versions, lint/test/type tools, layout, existing agent files for Claude, Codex, Cursor, Copilot, Gemini and Windsurf, commit style, and env var names (never values).
lint_claude_md.py checks the instruction file against the repo:
- commands that do not exist (
pnpm run e2e,make deploy), with dependency binaries likepnpm vitestunderstood - paths that moved, broken or too-deep
@imports - secrets, vague rules nobody can verify, contradictions, too much shouting
- oversized files, rules frontmatter that silently fails, an AGENTS.md Claude Code ignores, a CLAUDE.local.md about to be committed
- non-zero exit on errors, so it runs in CI and pre-commit
The workflow
Collect facts, verify the commands, ask only what files cannot answer (at most five questions), write under 200 lines, put area-specific rules in path-scoped .claude/rules/, lint until clean. Includes a writing guide with before/after examples, a template, and a complete example file.
Tested on real repositories (a Python library and a large pnpm monorepo) and with 19 automated tests.
Built by Nex AI, nex-ai.be
How to use
Skills on Agensi run inside your AI agent. Copy the prompt, paste it into your agent, and it connects to Agensi and installs this skill for you. If a payment is needed, your agent shows it to you first.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill passes our trust checks below.
Security scanned
Passed our 8-point scan before listing
Fresh listing
Recently published to Agensi
Free forever
No account required to browse
Trust & safety
Security scanned
Verified clean 1 day ago
- Free to download with an account
Requires