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/getmaat/maat/retrospectnpx skills add getmaat/maat --skill retrospectgit clone --depth 1 https://github.com/getmaat/maatWrote 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/getmaat/maat/retrospect)<a href="https://agentmods.dev/skills/getmaat/maat/retrospect"><img src="https://agentmods.dev/badge/skills/getmaat/maat/retrospect.svg" alt="Measured on agentmods" 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.00032 | $0.00865 |
| Opus 5 | $0.00016 | $0.00432 |
| Sonnet 5 | $0.00006 | $0.00173 |
| Haiku 4.5 | $0.00003 | $0.00086 |
Grade A, and why
maat-retrospect 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 5d 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.
This is a copy
100% identical to maat-retrospect — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.
How it starts
The opening of the file, as written. The whole thing — 76 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Retrospect: adopt Ma'at in an existing repository
Follow this procedure when maat init has run in an established repository
and the scaffolded documentation does not yet reflect the actual codebase.
You (the agent) supply the judgment; the maat CLI supplies deterministic
facts; the developer supplies the intent. Work in a pair-programming session —
this procedure is interactive by design.
Ground rules
- Never invent intent. Code tells you what; only the developer can confirm why. When context cannot be recovered, write "unknown — inferred from code" rather than a plausible fabrication.
- Never overwrite hand-written content without showing the developer the
change first. Files
maat initskipped are pre-existing and owned by the team. - Decisions derived after the fact are archaeology, not records. Give
them
status: retrospective, and only document decisions that still constrain the codebase today. Do not backfill superseded history. - Small steps: propose, confirm, write, re-check — one document at a time.
Procedure
- Inventory the gaps deterministically.
- Read the
create/skipoutput ofmaat init(re-run it if needed — it is idempotent and never overwrites).skiplines are pre-existing files to reconcile;createlines are scaffolds with placeholder content to fill. - Run
maat checkand collect every finding. This is your work list.
- Read the
- Explore the codebase before asking anything. Entry points, build and test commands, CI configuration, directory layout, recurring conventions, external dependencies. Form hypotheses to verify in the interview, not open questions the code already answers.
- Interview the developer. Cover at least:
- What does this project do, in one paragraph? (project summary)
- What must an agent never do here? What always? (update protocol, conventions)
- Which parts of the architecture are deliberate and constraining, and why? (candidate retrospective ADRs)
- Which existing docs/READMEs are trustworthy, which are stale?
- Reconcile AGENTS.md. If it pre-existed, merge Ma'at's expectations
(project overview, update protocol, links into
docs/) into the existing text — preserve the team's voice and rules. If it was scaffolded, replace the placeholders with interview results. - Fill the scaffolded docs under
docs/(architecture overview, guides, reference). Set honest front-matter:status: draftfor anything unverified,status: currentonly for reviewed content. Wire uprelated_codeso staleness tracking starts working. - Derive retrospective ADRs in
docs/decisions/from the interview — one per living constraint, using the ADR template, withstatus: retrospective. - Close the loop. Run
maat sync, thenmaat check; fix findings until green. Show the developer the final diff. - Ratchet the severities. Where
.maat.yml'schecksection was loosened for adoption, propose tightening (warn→error) now that the corresponding gaps are closed.
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.
- 5d ago First seen · 76 lines · 32 tokens per session scan A 43aae88a2fb1
maat-retrospect is a skill published in the GitHub repository getmaat/maat (4 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 32 tokens to every session and 865 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. It is 100% identical to maat-retrospect, differing in 0 lines, and is treated as a copy.
Other skills, from other repositories
code-review
Review code changes, pull requests, branches, commits, and diffs in the Terragrunt MCP Server. Use when asked for a code review, PR review, regression analysis, risk assessment, review comments, or merge-readiness check.
agents-md-improver
Audit or improve repository-scoped Codex AGENTS.md, AGENTS.override.md, configured fallback instructions, and companion codemap.md navigation. Use for effective-chain audits, nested conflicts, stale commands, scoped-guidance gaps, approved updates, 优化 AGENTS.md, 审计 Codex 项目指导, 更新 AGENTS.md, or 生成 codemap.md. Exclude…
talisman
Generate a polished, on-brand PDF guide/handbook/whitepaper from a codebase or project using LaTeX (.tex -> .pdf) or Markdown->pandoc->pdf, with a designed cover page, the product's real brand colors and logo, a subtle branded page background, and TikZ diagrams (domain models, flows, state machines). Use for any…
repo-audit
Audit a repository or prepare it for an open-source release. Audit mode reports whether the README matches the code and whether stated rules are actually enforced; launch mode walks a repo to release-ready with opt-in checklist packs and README templates. Use when asked to "audit this repo," "is this repo ready to go…
PRD Mastery: Context-Aware, Expert-Driven, and Token-Efficient Refinement
A skill that blends the wisdom of top industry experts, ensures token-efficient PRDs, and organizes outputs in a clear folder structure.
documentation-writer
Write clear, scannable documentation using a research-first, phase-separated workflow. Covers READMEs, doc sites, API references, migration guides, and technical markdown. Uses web search for up-to-date facts and delegates broad repo reads to an explore subagent before drafting. Use when the user asks for…