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/hculap/better-code/generategit clone --depth 1 https://github.com/hculap/better-codeWhat 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.00007 | $0.01779 |
| Opus 5 | $0.00003 | $0.00890 |
| Sonnet 5 | $0.00001 | $0.00356 |
| Haiku 4.5 | $0.00001 | $0.00178 |
Grade A, and why
generate 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 yesterday.
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.
How it starts
The opening of the file, as written. The whole thing — 290 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Documentation Generator
Generate documentation for a specific feature, component, or module using the appropriate specialized agent.
Arguments
-
feature(required): What to document- Feature name: "user authentication", "payment processing"
- Component path: "./src/components/Button"
- Module: "api/users"
-
--type(optional): Document type to generatetutorial: Learning-oriented walkthroughhowto: Task-oriented guidereference: Technical reference documentationexplanation: Conceptual explanation- If omitted: Generate appropriate type based on context
-
--output(optional): Output path for generated documentation- Default: Suggests appropriate location based on project structure
Process
Step 1: Load Configuration
Read .claude/doc-master.local.md for:
- Documentation standard (Diátaxis/Traditional/Custom)
- Custom rules (if applicable)
- Project-specific notes
Step 2: Analyze Feature
-
Locate feature code:
- Search for related files
- Read main implementation
- Identify dependencies
-
Understand feature:
- What does it do?
- How is it used?
- What are the public interfaces?
- What are common use cases?
-
Identify domain:
- Backend → Use backend-docs agent
- Frontend → Use frontend-docs agent
- API → Use api-docs agent
- Database → Use database-docs agent
- Architecture → Use architecture-docs agent
- Tests → Use test-docs agent
- User-facing → Use user-guide-docs agent
- Compliance → Use compliance-docs agent
- Mobile → Use mobile-docs agent
Step 3: Determine Document Type
If --type not specified, determine based on:
- Feature nature (new feature → tutorial, existing API → reference)
- User needs (ask if unclear)
- Existing documentation gaps
Step 4: Gather Information
Collect all information needed for documentation:
- Code signatures, parameters, return types
- Usage examples from tests or existing code
- Related documentation
- Error cases and edge cases
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.
- yesterday First seen · 290 lines · 7 tokens per session scan A d2af2c0b0504
generate is a command published in the GitHub repository hculap/better-code (2 stars, last pushed 7mo ago), licensed MIT. It adds 7 tokens to every session and 1,779 once invoked, about $0.0000 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
resume_handoff
Resume work from handoff document with context analysis and validation.
teach-me-testing
Teach testing progressively through structured sessions. Use when user says ""lets learn testing"" or ""I want to study test practices"".
retrospective
Post-epic review to extract lessons and assess success. Use when the user says ""run a retrospective"" or ""lets retro the epic [epic]"".
correct-course
Manage significant changes during sprint execution. Use when the user says ""correct course"" or ""propose sprint change"".
doc
Use this command to create a new feature doc, how-to, concept, reference, or troubleshooting guide — it scaffolds the file, frontmatter, structure, and sidebar entry.
grill-me
Run an interactive one-question-at-a-time oral drill for research defence or active-recall study, escalating around weak answers and ending with a study sheet. Use when the user asks to be grilled, quizzed, or prepared for a viva, job talk, seminar, or exam. Not for a written critique; use $devils-advocate or a review…