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 skills/adamw7/tools/doc-contractnpx skills add adamw7/tools --skill doc-contractgit clone --depth 1 https://github.com/adamw7/toolsWhat 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.00081 | $0.01131 |
| Opus 5 | $0.00041 | $0.00566 |
| Sonnet 5 | $0.00016 | $0.00226 |
| Haiku 4.5 | $0.00008 | $0.00113 |
Grade A, and why
doc-contract 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.
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.
Doc Contract Skill
In this repository the documentation is a build artifact: CLAUDE.md,
AGENTS.md and README.md are validated by the claude-code-enforcer rules,
and a -DenforceClaudeMd build fails when they drift. Edit them with the rules
in mind rather than discovering them in CI.
Who is the source of truth
AGENTS.md is the single source of truth. CLAUDE.md is a quick-reference
summary that defers to it — it is loaded into every session, so
contextBudget caps it at 32 KB. New detail belongs in AGENTS.md or in a
skill, not in CLAUDE.md.
Required structure
| Document | Title | Required ## sections |
|---|---|---|
CLAUDE.md |
# CLAUDE.md |
Project · Java version · Maven · Principles for Java Development · Testing · Dependencies |
AGENTS.md |
# AGENTS.md |
Project overview · Module layout · Environment & toolchain · Build, test, and run · Code style & conventions · Releasing · Pull requests & commits |
Also checked: the title must be the first non-blank line; a required section
must have a non-empty body (a heading with nothing under it fails);
CLAUDE.md must reference AGENTS.md; and memoryImports validates the
@-import graph.
The consistency rules — what must change together
moduleMapConsistency— every<module>in the rootpom.xmlmust be mentioned in bothCLAUDE.mdandAGENTS.md. Adding a module means editing three files in one commit: the pom, the module map inCLAUDE.md, and Module layout inAGENTS.md.crossDocConsistency— theJava (\d+)pattern must read the same inCLAUDE.mdandAGENTS.md. A JDK bump touches both.readmeConsistency— theproto(\d)pattern must agree betweenREADME.mdandAGENTS.md.contextBudget—CLAUDE.md≤ 32 KB.noSecrets— no credentials in.claude/settings.json,.mcp.json, or.claude/hooks.
Skills, settings and hooks are checked too
skillFilesExist— each directory under.claude/skillsneeds a non-emptySKILL.mdopening with YAML front matter carryingnameanddescription. Thenamemust be lower-case kebab-case, ≤ 64 chars, and equal to the directory name; an unknown front-matter key is reported (it catchesdescripton).uniqueNames/uniqueDescriptions— two definitions may not share a name or a description (compared case- and whitespace-insensitively). Claude routes by description, so duplicates make one skill shadow another. Write a description that says what it covers and when to use it, with the trigger phrases.settingsJsonValid,permissionsFormat,hookCommandsValid,hooksFormat,localSettingsIgnored—.claude/settings.json, the hook scripts, and the.claude/settings.local.jsonentry in.gitignore(removing that entry fails the build).
What ships with it
1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
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 · 82 lines · 81 tokens per session scan A db83fbcbd861
doc-contract is a skill published in the GitHub repository adamw7/tools (11 stars, last pushed 5d ago), licensed MIT. It adds 81 tokens to every session and 1,131 once invoked, about $0.0004 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-30.
Other skills, from other repositories
kfl
KFL2 (Kubeshark Filter Language) reference. This skill MUST be loaded before writing, constructing, or suggesting any KFL filter expression. KFL is statically typed — incorrect field names or syntax will fail silently or error. Do not guess at KFL syntax without this skill loaded. Trigger on any mention of KFL, CEL…
build-with-tinybase
Scaffold, extend, and verify reactive local-first JavaScript or TypeScript applications with TinyBase. Use when choosing TinyBase for in-memory tabular or key-value state, generating an app with create-tinybase, adding schemas or UI bindings, configuring browser or database persistence, configuring MergeableStore…
Workspace Data Analyst
Analyze CSV files in the workspace and summarize insights.
data-formats
Working with diverse data formats: binary, text, structured, and custom.
veo-3.2-prompter
Expert prompt engineering for Google Veo 3.2 (Artemis engine). Use when the user wants to generate a video with Veo 3.2, needs help crafting cinematic prompts, or mentions Veo, Google video generation, or Artemis engine.
data_analyst
Analyses datasets with professional rigour — statistical summaries, clear narratives, and well-chosen visualisations.