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 richfrem/agent-plugins-skills --skill managing-adrsgit clone --depth 1 https://github.com/richfrem/agent-plugins-skillsWrote 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/richfrem/agent-plugins-skills/managing-adrs)<a href="https://agentmods.dev/skills/richfrem/agent-plugins-skills/managing-adrs"><img src="https://agentmods.dev/badge/skills/richfrem/agent-plugins-skills/managing-adrs/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/richfrem/agent-plugins-skills/managing-adrs"><img src="https://agentmods.dev/badge/skills/richfrem/agent-plugins-skills/managing-adrs.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.00028 | $0.00509 |
| Opus 5.5 | $0.00011 | $0.00204 |
| Sonnet 5.5 | $0.00006 | $0.00102 |
| Haiku 4.5 | $0.00003 | $0.00051 |
Grade A, and why
managing-adrs 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.
What it actually says
Dependencies
Requires Python 3.8+ (standard library only).
Managing ADRs (managing-adrs)
Manages Architecture Decision Records to ensure significant technical and architectural choices are permanently documented.
Contents
Critical Constraints
- Fill All Sections: Never leave an ADR partially empty; extrapolate context, decision, consequences, and alternatives.
- Filename Convention: Always format filenames as
NNN-short-descriptive-title.md. - Status Lifecycle: Mark new records
ProposedorAccepted; mark superseded recordsSupersededwith links.
Quick start
Create a new ADR with an automatic sequential ID:
python3 scripts/adr_manager.py create "Title" --context "Context" --decision "Decision" --consequences "Consequences"
Workflow
- Scaffold Record: Run
adr_manager.py create "<Title>"to create the template file indocs/architecture/decisions/orADRs/. - Populate Content: Open the generated file and document technical context, rationale, consequences, and alternatives.
- Cross-Reference: Link related decisions by number (e.g.
ADR-003).
Querying ADRs
- View Record:
python3 scripts/adr_manager.py get <NUMBER> - Search Keywords:
python3 scripts/adr_manager.py search "<KEYWORD>" - Next Number:
python3 scripts/next_number.py --type adr
Verification
List existing ADRs and verify sequential indexing:
python3 scripts/adr_manager.py list
References
- adr-template.md — Template used by
adr_manager.py create. - acceptance-criteria.md — Acceptance criteria for ADR scaffolding and indexing.
What ships with it
7 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.
- 2d ago First seen · 66 lines · 28 tokens per session scan A 8dd450ac3a14
managing-adrs is a skill published in the GitHub repository richfrem/agent-plugins-skills (7 stars, last pushed yesterday), licensed MIT. It adds 28 tokens to every session and 509 once invoked, about $0.0001 per session on Opus 5.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-10-24.
Other skills, from other repositories
ap-sweeper
Report the compatibility redirect to ap-independent-checker; this retired role cannot perform new work.
knowledge-graph-management
Capture, validate, query, and sync architectural patterns and design decisions in the knowledge graph.
context-recovery
Automatically recover working context after session compaction or when continuation is implied but context is missing. Works across Discord, Slack, Telegram, Signal, and other supported channels.
iwe-restore
A recovery skill that restores an agent’s saved memory and instruction files from an exocortex backup when moving to a new computer or workspace. It shows what it found and asks for confirmation before copying files.
a2wave-memory
Progressively recall and maintain a2wave cross-session memory through a compact startup catalog, bounded topics, and searchable history.
memory-patterns
Persistent memory patterns for moflo agents — session memory, long-term knowledge, pattern learning, and cross-session context via moflo's node:sqlite + HNSW vector store. Use when building stateful agents or assistants that need to remember across runs.