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 instructions/hculap/better-code/claude-mdgit 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.00668 | $0.00668 |
| Opus 5 | $0.00334 | $0.00334 |
| Sonnet 5 | $0.00134 | $0.00134 |
| Haiku 4.5 | $0.00067 | $0.00067 |
Grade A, and why
better-code CLAUDE.md 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 — 82 lines — stays where its author put it; the contents beside it link to each section on GitHub.
CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Project Overview
This is a monorepo of Claude Code plugins focused on code quality and developer productivity. The marketplace name is better-code and contains 5 plugins: tdd-dev, n1-optimizer, readme-writer, doc-master, and code-standards.
Development Commands
# Test a plugin locally
claude --plugin-dir plugins/<plugin-name>
# Install from marketplace (for users)
/plugin marketplace add hculap/better-code
/plugin install <plugin-name>
Repository Structure
.claude-plugin/marketplace.json # Plugin registry for marketplace
plugins/
tdd-dev/ # TDD enforcement with hooks
n1-optimizer/ # Parallel performance analysis (4 agents)
readme-writer/ # README generation/auditing
doc-master/ # Documentation toolkit (9 agents)
code-standards/ # Code quality enforcement
Plugin Architecture
Each plugin follows this structure:
plugin-name/
├── .claude-plugin/plugin.json # Manifest: name, version, description, agents array
├── agents/*.md # Autonomous agents with YAML frontmatter
├── commands/*.md # Slash commands with YAML frontmatter
├── skills/<topic>/SKILL.md # Knowledge skills with references/ and examples/
├── hooks/hooks.json # (optional) Hook configuration
└── README.md
Key File Conventions
- Agent frontmatter:
name,description(with<example>blocks),model,color,tools - Command frontmatter:
description,allowed-tools,argument-hint - Skill frontmatter:
name,description(trigger phrases),version - Use lowercase with hyphens for directories/files (except
SKILL.md) - Settings files:
.claude/plugin-name.local.mdwith YAML frontmatter
Plugin Patterns
tdd-dev: Uses hooks for enforcement. State stored in .claude/.tdd-mode-active. PreToolUse hooks intercept Write/Edit based on strictness level.
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 · 82 lines · 668 tokens per session scan A 16b4fe1e12f1
better-code CLAUDE.md is an instructions file published in the GitHub repository hculap/better-code (2 stars, last pushed 7mo ago), licensed MIT. It adds 668 tokens to every session, about $0.0033 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 instructions, from other repositories
Skill_Seekers CLAUDE.md
Instructions for yusufkaraaslan/Skill_Seekers, covering claude.md, project overview, essential commands, required before running tests or cli (src/ layout) and run all tests (never skip - all must pass before commits).
claude-code CLAUDE.md
Instructions for PaulDuvall/claude-code, covering claude.md, project overview, core philosophy, key principles and repository structure.
ailinter AGENTS.md
Instructions for ailinter/ailinter, covering agents.md, agent tl;dr, sub-agent delegation (ailinter scans), when to invoke @ailinter and what @ailinter does.
ailinter copilot-instructions.md
Instructions for ailinter/ailinter, covering ailinter code quality & security, before every code change, the refactoring loop (mandatory), after every code change and security.
pituitary AGENTS.md
AGENTS.md instructions for nantobv/pituitary, covering agents.md, project, org-wide policy (nantobv-shared), coding standards and architecture rules.
pituitary CLAUDE.md
Claude Code instructions for nantobv/pituitary, covering agents.md, project, coding standards, architecture rules and workflow.