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 skills add dgilford/ai-science-toolkit --skill evolve-claude-mdgit clone --depth 1 https://github.com/dgilford/ai-science-toolkitWrote 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.
[](https://agentmods.dev/skills/dgilford/ai-science-toolkit/evolve-claude-md)<a href="https://agentmods.dev/skills/dgilford/ai-science-toolkit/evolve-claude-md"><img src="https://agentmods.dev/badge/skills/dgilford/ai-science-toolkit/evolve-claude-md/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.
<a href="https://agentmods.dev/skills/dgilford/ai-science-toolkit/evolve-claude-md"><img src="https://agentmods.dev/badge/skills/dgilford/ai-science-toolkit/evolve-claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector pass
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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00059 | $0.00755 |
| Opus 5 | $0.00030 | $0.00378 |
| Sonnet 5 | $0.00012 | $0.00151 |
| Haiku 4.5 | $0.00006 | $0.00076 |
Grade A, and why
evolve-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 10d 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 — 51 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Review the current session and update the project's canonical agent-guidance file with anything durable that it doesn't yet know.
Target file
CLAUDE.md by default — but some repos keep a thin CLAUDE.md stub that redirects to a canonical AGENTS.md (the cross-tool convention scaffolded by /repo-init). Resolve the target before editing:
A redirect stub is a CLAUDE.md whose only content is the redirect to AGENTS.md plus pointer lines (the shape /repo-init scaffolds) — nothing project-specific. A stray substantive line in an otherwise-stub file is residue: migrate it into AGENTS.md as part of this run and leave the stub clean.
| Repo state | Edit |
|---|---|
CLAUDE.md substantive, no AGENTS.md (the most common state) |
CLAUDE.md |
CLAUDE.md is a redirect stub |
AGENTS.md — leave the stub untouched (create AGENTS.md if the stub points at a missing file) |
No CLAUDE.md, but AGENTS.md exists |
AGENTS.md |
| Both exist with substantive content | CLAUDE.md, and flag the split-brain to the user so they can consolidate |
| Neither exists | Create CLAUDE.md |
What belongs in the canonical file
Promote only knowledge that is:
- Permanent — true beyond this session (not current task state)
- Project-level — relevant to anyone working in this repo
- Non-obvious — not derivable from reading the code directly
Good candidates: renamed or new variables, corrected definitions, newly understood warn patterns, confirmed pipeline behavior, resolved ambiguities about data schema, architectural decisions with non-obvious rationale.
Good: Pipeline requires --baseline to be passed explicitly; there is no default. — permanent code behavior that would surprise any future developer.
Bad: Dataset coverage is 1981-09-01 through 2026-05-16 (16,329 zarrs). — describes the current data artifact being processed, not the codebase. Belongs in HANDOFF.md.
The test: if removing this fact would cause a future developer to misunderstand how the pipeline works, it belongs here. If it describes the data being processed this session, it belongs in the handoff.
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.
- 10d ago First seen · 51 lines · 59 tokens per session scan A d0282830e3ab
evolve-claude-md is a skill published in the GitHub repository dgilford/ai-science-toolkit (62 stars, last pushed 21d ago), licensed MIT. It adds 59 tokens to every session and 755 once invoked, about $0.0003 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
metforge-analysis
Perform reproducible atmospheric-science calculations and statistical diagnostics. Use when the agent needs to calculate established or custom climate indices, derive meteorological variables, compute trends, detrend or filter time series, perform EOF/PCA, regression, correlation, composites, bootstrap or significance…
metforge-model-diagnose
Diagnose atmospheric-model and dynamical-core experiments. Use for idealized tests, balanced flow, hydrostatic rest, density currents, advection, gravity/acoustic waves, mountain waves, baroclinic instability, conservation and budget closure, error growth, convergence, timestep/resolution/domain/MPI sensitivity…
metforge-data
Acquire and prepare atmospheric, climate, and Earth-system datasets reproducibly. Use when the agent needs to find an authoritative dataset, choose among ERA5/CMIP/GPM/MERRA-2/NOAA or similar products, download or subset NetCDF/GRIB/Zarr data, write CDS/Earthdata/ESGF/OPeNDAP acquisition code, inspect coordinates and…
metforge-figure
Design, create, revise, and audit atmospheric-science figures. Use for maps, map differences, vertical sections, Hovmöller diagrams, profiles, spectra, budgets, convergence plots, conservation/error-growth diagnostics, ensemble comparisons, and publication multi-panel figures from NetCDF/xarray or tabular data. Also…
opencli-sitemap-author
Use when creating or maintaining OpenCLI site sitemaps: agent-facing navigation, page-state, action, workflow, API-reference, pitfall, and fallback knowledge for a website. Use after browser exploration discovers durable site context, when a sitemap is stale, or when promoting local site knowledge into the repo.
omh-code-review
This is a Hermes-native code-review workflow skill.