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 SteveVitali/agent-skills --skill build-memorygit clone --depth 1 https://github.com/SteveVitali/agent-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/stevevitali/agent-skills/build-memory)<a href="https://agentmods.dev/skills/stevevitali/agent-skills/build-memory"><img src="https://agentmods.dev/badge/skills/stevevitali/agent-skills/build-memory/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/stevevitali/agent-skills/build-memory"><img src="https://agentmods.dev/badge/skills/stevevitali/agent-skills/build-memory.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.00101 | $0.02368 |
| Opus 5 | $0.00051 | $0.01184 |
| Sonnet 5 | $0.00020 | $0.00474 |
| Haiku 4.5 | $0.00010 | $0.00237 |
Grade A, and why
build-memory 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 — 179 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Build Memory
The owner of the build-memory layer that decompose-spec, orchestrate-build,
implement-spec, synthesize-spec and reconcile-build all read and write. It owns one
contract file, one set of templates, one validator and one migration tool, so build memory
is defined in exactly one place.
Precedent.
agent-docsowns the shared Doc Authoring Guidelines other skills cite;build-memoryowns the layout the same way. The contract islayout.md— the tree, the modes, the machine-state ledger, the manifest / ticket / marker / tail shapes, the deferrals / ADR / index / gate rules, who writes what, the validator, and the compatibility policy. Read it before any mode below; every other skill cites it and does not restate the tree.
Build memory is committed (the record of a multi-session build is audit-valuable and git
is the artifact store); only regenerable bulk (logs/) is gitignored. A repo opts in with
the marker <!-- build-memory: v2 --> in docs/build/README.md. A repo without it runs in
legacy scratch mode — byte-for-byte the pre-0.2.0 behaviour (see layout.md §
Compatibility and README.md).
Resolve the root first (every mode)
// turbo
bash scripts/memory-root.sh # prints: mode=<committed|scratch> root=<abs path>
Committed mode → the root is <worktree>/docs/build, resolved from the current worktree
(a sibling build worktree reads its own chain tip). Scratch mode → the legacy gitignored
dir. $BUILD_MEMORY_ROOT overrides both.
Mode: check (default)
Validate the layout. Read-only; exit-code gated; runnable in CI.
// turbo
bash scripts/check-build-memory.sh . # exit 0 clean · 1 violations · 2 not a build-memory repo
It checks everything the skills derive (layout allowlist + logs/.gitignore; ticket filename
grammar + unique sequence; manifest ↔ files both ways; backward Depends on; skeletons carry
no run line; markers referenced; DEFERRALS ids unique + valid statuses; no OPEN row past a
PASSED gate; ADR files ↔ generated index; every ADR has ## Revisit trigger; spec ADR
appendix == file set when present; LEDGER.md key set + order and nextTicket; PHASE-LOG
"done" ↔ BUILD_INDEX row + runs/<ID>.md; REQ→ticket coverage when the spec and
req_id_pattern resolve; size + secret scans). The human summary lists each violation; the
JSON at /tmp/build-memory-check.json mirrors it. A failure is a real block — the caller
does not proceed past it.
What ships with it
60 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.
- layout.md 20 KB
- README.md 5.1 KB
- scripts/adr-index.sh 4.5 KB runs code
- scripts/check-build-memory.sh 19 KB runs code
- scripts/memory-root.sh 2.7 KB runs code
- scripts/migrate-legacy-scratch.sh 9.4 KB runs code
- templates/adr-TEMPLATE.md 933 B
- templates/AGENTS-build-memory.md 1.8 KB
- templates/BACKLOG.csv 612 B
- templates/BUILD_INDEX.md 509 B
- templates/build-README.md 1.2 KB
- templates/COVERAGE_MATRIX.csv 536 B
- templates/DEFERRALS.md 1.7 KB
- templates/docs-README.md 1.9 KB
- templates/GATE.md 1.1 KB
- templates/HUMAN.md 1.3 KB
- templates/LEDGER.md 2.0 KB
- templates/MANIFEST.md 2.9 KB
- templates/research-CONVENTIONS.md 1.3 KB
- templates/research-ledger.md 2.1 KB
- templates/spec-front-matter.md 2.0 KB
- templates/tail/CAP.1__capstone-gap-analysis.md 3.9 KB
- templates/tail/CAP.2__capstone-composed-verification.md 3.0 KB
- templates/tail/CAP.3__capstone-closure.md 2.9 KB
- templates/tail/DOC.1__repo-docs-refresh.md 2.4 KB
- templates/tail/DOC.2__agent-docs-refresh.md 2.3 KB
- templates/tail/GATE-ACCEPT.md 1.7 KB
- templates/tail/REC.1__backlog-and-readiness.md 2.8 KB
- templates/tail/REC.2__spec-reconciliation.md 2.8 KB
- templates/tail/REC.3__integration-plan.md 2.4 KB
- templates/ticket-skeleton.md 860 B
- templates/ticket.md 2.0 KB
- tests/legacy-scratch/.agents/scratch/implement-spec_devin-p19-3-composed_20260115.md 103 B
- tests/legacy-scratch/.agents/scratch/implement-spec_final-notes_20260101.md 85 B
- tests/legacy-scratch/.agents/scratch/implement-spec_P19.2.md 80 B
- tests/legacy-scratch/.agents/scratch/implement-spec_p20-3_20260909.md 80 B
- tests/legacy-scratch/.agents/scratch/implement-spec_scratchpad.md 82 B
- tests/legacy-scratch/.agents/scratch/logs/run.log 33 B
- tests/legacy-scratch/.agents/scratch/pr/pr_1.md 41 B
- tests/legacy-scratch/.agents/scratch/sig-postbuild-build-ledger.md 766 B
- tests/legacy-scratch/.agents/scratch/tools/gen.sh 52 B runs code
- tests/run-tests.sh 7.3 KB runs code
- tests/v2-clean/docs/adr/_TEMPLATE.md 219 B
- tests/v2-clean/docs/adr/ADR-001-seed-schema-shape.md 509 B
- tests/v2-clean/docs/adr/README.md 379 B
- tests/v2-clean/docs/build/BUILD_INDEX.md 386 B
- tests/v2-clean/docs/build/LEDGER.md 1.4 KB
- tests/v2-clean/docs/build/logs/.gitignore 14 B
- tests/v2-clean/docs/build/README.md 288 B
- tests/v2-clean/docs/build/runs/T1.md 598 B
- tests/v2-clean/docs/tickets/_TEMPLATE.md 602 B
- tests/v2-clean/docs/tickets/00_MANIFEST.md 1.6 KB
- tests/v2-clean/docs/tickets/01_T1__seed-schema.md 863 B
- tests/v2-clean/docs/tickets/02_T2__wire-consumers.md 899 B
- tests/v2-clean/docs/tickets/DEFERRALS.md 1.1 KB
- tests/v2-violations/docs/adr/_TEMPLATE.md 219 B
- tests/v2-violations/docs/adr/ADR-001-seed-schema-shape.md 509 B
- tests/v2-violations/docs/adr/ADR-002-hasty-decision.md 326 B
- tests/v2-violations/docs/adr/README.md 474 B
- tests/v2-violations/docs/build/BACKLOG.md 59 B
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 · 179 lines · 101 tokens per session scan A 421c9d27aae3
build-memory is a skill published in the GitHub repository SteveVitali/agent-skills (12 stars, last pushed yesterday), licensed MIT. It adds 101 tokens to every session and 2,368 once invoked, about $0.0005 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-09-10.
Other skills, from other repositories
neat-freak
Knowledge and governance closeout: reconcile project docs, rule files (CLAUDE.md/AGENTS.md), authorized agent memory, and workspace residue with what the code and runtime actually do, so the next session or the next person starts from one current answer. Trigger when the user names "neat-freak", "洁癖", or "/neat" — and…
state
Use when the user says 'update state', 'project state', 'where was I', or at session start to load current context.
handoff
Use when work is changing sessions, agents, or machines and the next pass needs a compact handoff document with current state, open questions, and next steps instead of raw chat history.
mastermind-project-history
Retrieve and reason from durable project decisions, failed approaches, audits, reports, and lessons without treating provenance, search rank, or user approval as technical proof. Use when asking why a design exists, whether an approach was tried, what supersedes an older decision, what prior evidence should constrain…
project-context
Resume, handoff, and long-running repo work by keeping durable context across threads or agents: task briefs, logs, and reusable reference notes.
continue
Use when you need the Codex Copilot equivalent of Claude Copilot /continue: resume paused or previous work from tc tasks, work products, memory, and stream context.