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 WaterplanAI/agentic-config --skill ac-tools-improve-agents-mdgit clone --depth 1 https://github.com/WaterplanAI/agentic-configWrote 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/waterplanai/agentic-config/ac-tools-improve-agents-md)<a href="https://agentmods.dev/skills/waterplanai/agentic-config/ac-tools-improve-agents-md"><img src="https://agentmods.dev/badge/skills/waterplanai/agentic-config/ac-tools-improve-agents-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/waterplanai/agentic-config/ac-tools-improve-agents-md"><img src="https://agentmods.dev/badge/skills/waterplanai/agentic-config/ac-tools-improve-agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.00072 | $0.01006 |
| Opus 5 | $0.00036 | $0.00503 |
| Sonnet 5 | $0.00014 | $0.00201 |
| Haiku 4.5 | $0.00007 | $0.00101 |
Grade A, and why
ac-tools-improve-agents-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 — 120 lines — stays where its author put it; the contents beside it link to each section on GitHub.
improve-agents-md
Compatibility Note
This pi wrapper preserves the original setup/update workflow while expressing any confirmation points as explicit manual checkpoints in the current chat instead of assuming a runtime interactive-question primitive.
Generate and manage AGENTS.md (rendered as CLAUDE.md) using a single base
template with dynamic tooling values from tooling.yml.
Architecture
assets/
AGENTS.md.template # Single base template with {{VAR}} placeholders
tooling.yml # Per-type tooling values (package_manager, linter, etc.)
extras/pep723.md # Optional section injected for Python types
templates/shared/ # Shared templates (.gitignore)
tools/
bootstrap.py # Entrypoint: setup, update, validate
template_engine.py # Reads tooling.yml, renders template, injects extras
project_type.py # Auto-detect project type from file indicators
preserve_custom.py # Backup + CLAUDE.md migration detection
Modes
setup
Generate AGENTS.md for a project:
- Detect project type (or accept
--typeoverride) - Back up existing files if
--force - Load tooling values from
tooling.ymlfor detected type - Render
AGENTS.md.templatewith tooling substitution - Inject extras (e.g., PEP 723 section for Python types)
- Write rendered AGENTS.md to project root
- Create CLAUDE.md and GEMINI.md as symlinks to AGENTS.md
update
Re-render AGENTS.md with latest template:
- Re-detect project type (or accept
--typeoverride) - Preserve customizations if
--force - Re-render AGENTS.md with current tooling values
validate
Check AGENTS.md content:
- Verify AGENTS.md exists
- Check for unresolved
{{VAR}}placeholders - Verify required sections present
- Check CLAUDE.md is a symlink to AGENTS.md
- Warn if legacy PROJECT_AGENTS.md is present
- Check template assets exist
Flags
| Flag | Default | Description |
|---|---|---|
--dry-run |
false | Print actions without executing |
--force |
false | Force overwrite (backup + re-render) |
--type |
auto | Override project type detection |
What ships with it
8 files 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.
- 10d ago First seen · 120 lines · 72 tokens per session scan A 074a1e7fe145
ac-tools-improve-agents-md is a skill published in the GitHub repository WaterplanAI/agentic-config (30 stars, last pushed 1mo ago), licensed MIT. It adds 72 tokens to every session and 1,006 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
vfx-text-cursor
A video or hero-frame effect where a cursor reveals a sentence character by character with coloured trails, light streaks, and a final shimmer.
migrate-skills-between-libraries
Use when moving skills between library workspaces or upgrading from a personal library to a team library. Export from one workspace, import into another.
review-a-skill
Use when evaluating whether a skill belongs in a library. Preview content, check frontmatter, validate structure, and decide whether to keep, curate, or remove.
audit-library-health
Use when checking the overall health of a skills library. Run doctor, validate, check for stale skills, and verify generated docs are in sync.
browse-and-evaluate
Use when exploring the ai-agent-skills catalog to find, compare, and evaluate skills before installing. Always use --fields to limit output size and --dry-run before committing to an install.
install-from-remote-library
Use when installing skills from a shared ai-agent-skills library repo. Inspect with --list first, prefer --collection, and preview with --dry-run before installing.