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.
npx agentmods add commands/hmj1026/dhpk/doc-refactorgit clone --depth 1 https://github.com/hmj1026/dhpkWhat 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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00015 | $0.00303 |
| Opus 5 | $0.00008 | $0.00151 |
| Sonnet 5 | $0.00003 | $0.00061 |
| Haiku 4.5 | $0.00002 | $0.00030 |
Grade A, and why
doc-refactor 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 2d 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.
What it actually says
Contract
Use for a bounded documentation refactor; not for changing policy or source semantics. See the command contract. Stop when the input is missing or unsafe to rewrite; completion reports the preserved facts, output path, and before/after line counts.
Task
For the file specified by $ARGUMENTS:
-
Analyze original content
- Count lines
- Identify core information vs redundancy
-
Refactor
- Long paragraphs -> tables
- Steps -> sequenceDiagram
- Duplicates -> single source
-
Validate
- Key information preserved
- Line count reduced
Simplification Standards
| File Type | Target Lines |
|---|---|
| CLAUDE.md | < 50 |
| rules/*.md | < 30 |
| agents/*.md | < 50 |
| commands/*.md | < 40 |
Output
## Refactoring Result
- Original: X lines
- Simplified: Y lines (-Z%)
## Changes
- <summary>
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.
- 2d ago First seen · 56 lines · 15 tokens per session scan A 1da28f35b858
doc-refactor is a command published in the GitHub repository hmj1026/dhpk (2 stars, last pushed 3d ago), licensed MIT. It adds 15 tokens to every session and 303 once invoked, about $0.0001 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-08-31.
Other commands, from other repositories
delegate-review
Run OCR in delegation mode — OCR handles file selection and rules, the host agent performs the actual review.
OpenSpec: Apply
Implement an approved OpenSpec change and keep tasks in sync.
review
Run OpenCodeReview (OCR) to review code changes and autonomously apply fixes.
thoth:tui
Open or snapshot the read-only terminal dashboard backed by shared Thoth providers.
star
Use the roster below to route a research-workflow request to exactly one STAR skill.
harness-gate
Gate the agent setup on corpus-validated rules (gating tier). Fast, no LLM, exits nonzero on any finding. Suitable for CI and pre-commit.