writing-commands-review

writing-commands-review is a command for Claude Code from axiomantic/spellbook. It costs 35 tokens per session (1,241 once invoked), scanned A, original, MIT.

A checklist and testing process for reviewing the quality of an agent command before it is used.

In plain words
What is it for?
It is for checking command files against requirements, scoring their quality, finding anti-patterns, and proposing concrete fixes.
Why use it?
It exposes missing structure, unclear instructions, weak safeguards, and other patterns that can make commands unreliable under pressure.

Command for Claude Code

Written for Claude Code: a Claude Code command (commands/*.md).

Good fit It is for checking command files against requirements, scoring their quality, finding anti-patterns, and proposing concrete fixes.

Compare 6 commands from other repositories ↓
Install with agentmods
npx agentmods add commands/axiomantic/spellbook/writing-commands-review
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/axiomantic/spellbook

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for writing-commands-review

README.md
[![agentmods](https://agentmods.dev/badge/commands/axiomantic/spellbook/writing-commands-review/github.svg)](https://agentmods.dev/commands/axiomantic/spellbook/writing-commands-review)
Your own site
<a href="https://agentmods.dev/commands/axiomantic/spellbook/writing-commands-review"><img src="https://agentmods.dev/badge/commands/axiomantic/spellbook/writing-commands-review/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for writing-commands-review

Your own site · 80×15
<a href="https://agentmods.dev/commands/axiomantic/spellbook/writing-commands-review"><img src="https://agentmods.dev/badge/commands/axiomantic/spellbook/writing-commands-review.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 35 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,241 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00035 $0.01241
Opus 5 $0.00017 $0.00620
Sonnet 5 $0.00007 $0.00248
Haiku 4.5 $0.00003 $0.00124

Measured 8d ago against content hash bd6310c55468, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

writing-commands-review scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

commands/writing-commands-review.md · 128 lines

How it starts

The opening of the file, as written. The whole thing — 128 lines — stays where its author put it; the contents beside it link to each section on GitHub.

MISSION

Evaluate a command against the full quality checklist, identify anti-patterns, and run the testing protocol. Produce a scored review report with actionable fixes.

Invariant Principles

  1. Structure enables scanning: Agents under pressure skim. Sections, tables, and code blocks catch the eye.
  2. FORBIDDEN closes loopholes: Every command needs explicit negative constraints. Each rationalization needs a counter.
  3. Reasoning tags force deliberation: <analysis> before action, <reflection> after. Without these, agents skip to output.

Quality Checklist

Run every item. No shortcuts.

Structure

  • YAML frontmatter with description field
  • # MISSION section with clear single-paragraph purpose
  • <ROLE> tag with domain expert persona and stakes
  • ## Invariant Principles with 3-5 numbered rules
  • Execution sections with clear steps (numbered, not prose)
  • ## Output section defining what agent produces
  • <FORBIDDEN> section with explicit prohibitions
  • <analysis> tag (pre-action reasoning)
  • <reflection> tag (post-action verification)

Content Quality

  • Steps are imperative ("Run X", "Check Y"), not suggestive ("Consider X", "You might Y")
  • Tables used for structured data, not prose paragraphs
  • Code blocks for every shell command and code snippet
  • Every conditional has both branches specified (if X, do Y; if not X, do Z)
  • No undefined failure modes (what happens when things go wrong?)
  • Cross-references use correct paths (verify targets exist)
  • Dev-only guards specified where applicable

Behavioral

  • Agent knows exactly what to do at every step (no ambiguity)
  • Invariant principles are testable, not aspirational
  • FORBIDDEN section addresses likely shortcuts the agent would take
  • Reflection tag asks specific verification questions, not generic "did I do well?"
  • Output section has a concrete format (not "display results")

Read the full file on GitHub · 128 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 128 lines · 35 tokens per session scan A bd6310c55468

Subscribe to this mod's changes

writing-commands-review is a command published in the GitHub repository axiomantic/spellbook (10 stars, last pushed yesterday), licensed MIT. It adds 35 tokens to every session and 1,241 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.