Borrowing it
Nothing to install: this file belongs to agno-agi/agentos-docker. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/agno-agi/agentos-docker/main/.agents/skills/review-and-improve/SKILL.mdgit clone --depth 1 https://github.com/agno-agi/agentos-dockerWrote 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/agno-agi/agentos-docker/review-and-improve)<a href="https://agentmods.dev/skills/agno-agi/agentos-docker/review-and-improve"><img src="https://agentmods.dev/badge/skills/agno-agi/agentos-docker/review-and-improve/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/agno-agi/agentos-docker/review-and-improve"><img src="https://agentmods.dev/badge/skills/agno-agi/agentos-docker/review-and-improve.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.00064 | $0.01338 |
| Opus 5 | $0.00032 | $0.00669 |
| Sonnet 5 | $0.00013 | $0.00268 |
| Haiku 4.5 | $0.00006 | $0.00134 |
Grade A, and why
review-and-improve scanned grade A with 1 finding 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 12d 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.
Makes network callslowCapability
Not a fault in itself. Listed so you know the mod talks to something, and to what.
`curl -sSf http://localhost:8000/health` returns 200 (Step 4 needs it). Suggest `git checkout -b review/$(date +%Y%m%d)`. Copies of this mod
2 near-identical copies found in the catalogue:
- review-and-improve — 98% identical, 2 lines differ
- review-and-improve — 98% identical, 2 lines differ
How it starts
The opening of the file, as written. The whole thing — 78 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Review and Improve
Coding-agent workflow: run as
/review-and-improveor by describing the task.
Sweep the repo for docs accuracy, reachability, and consistency. Fix mechanical drift in place; surface the rest. AGENTS.md is the source of truth (CLAUDE.md symlinks to it).
Auto-fix: stale doc paths; example.env entries missing for vars the code reads, or stale ones nothing reads (keep those a comment marks optional/future); a registered agent or workflow missing from an architecture diagram; an agent file on disk not imported in app/main.py; a missing app/config.yaml manifest entry (draft one and flag it); broken links between docs and skills; a single-line claim in one doc contradicted by another doc or by code (fix the doc).
Flag, don't fix: section-level rewrites; code beyond imports; pyproject.toml; anything in db/, compose.yaml, Dockerfile; failing evals or live agents.
0. Preconditions
curl -sSf http://localhost:8000/health returns 200 (Step 4 needs it). Suggest git checkout -b review/$(date +%Y%m%d).
1. Scope
Restate in a few lines: README.md, AGENTS.md, example.env; .agents/skills/*/SKILL.md; app/, agents/, teams/, workflows/, db/, evals/, scripts/; compose.yaml, compose.prod.yaml, Dockerfile, pyproject.toml. Skip .venv/, caches, .git/. Fold in any concern the user names.
2. Inventory
Read first, fix once. Build the picture: registered agents/teams/workflows in app/main.py; files on disk; what app/registry.py declares and imports; env vars read (getenv(, os.environ, plus env_flag/_int_env helpers); the manifest; eval cases; register_schedules() targets; what each script does.
3. Consistency pass
| Check | Where |
|---|---|
| Every agent/team/workflow file is registered | agents/, teams/, workflows/ ↔ app/main.py |
| Every registered component has a manifest entry | app/main.py ↔ app/config.yaml |
| Every env var in code is documented, and every documented var is read | code ↔ AGENTS.md table ↔ example.env (RUNTIME_ENV is deliberately absent from example.env) |
| Every path and script named in docs exists and does what's claimed | README.md, AGENTS.md, skills ↔ filesystem |
| Architecture diagram matches registrations | AGENTS.md |
| Eval cases reference real agents and tools | evals/cases.py |
| Every schedule hits a real workflow id | app/schedules.py ↔ workflows/ |
Registry inventory prose matches app/registry.py |
AGENTS.md |
| Key Files table matches the tree | AGENTS.md |
Skill name: equals its folder; ../../../ links resolve; .claude/skills symlink resolves |
.agents/skills/ |
.mcp.json servers agree with the docs |
.mcp.json |
MCP endpoint claims match mcp= in app/main.py; scripts/mcp_check.sh calls a registered agent |
docs ↔ code |
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.
- 12d ago First seen · 78 lines · 64 tokens per session scan A ef46731bffeb
review-and-improve is a skill published in the GitHub repository agno-agi/agentos-docker (7 stars, last pushed 11d ago), licensed Apache-2.0. It adds 64 tokens to every session and 1,338 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
lint
Lint and format Kurtosis Starlark files. Check syntax, validate docstrings, and auto-format .star files. Use when writing or reviewing Starlark packages to ensure code quality.
review-dependabot
Reviews a Dependabot PR and evaluates whether the dependency update is safe to merge. Use when a Dependabot PR is opened, when evaluating dependency updates, or when asked to check if a version bump is safe.
address-review
Read PR review comments from GitHub, evaluate, address, and reply.
review-pr
Reviews a pull request for production-readiness. Use when reviewing PRs, checking code changes before merge, or when asked to evaluate a PR.
fuck-over-engineering
Use when the user asks what could be deleted or reduced to simplify a codebase, says "simplify", "over-engineered", or wants a repo-, folder-, or file-wide audit for over-engineering — hunts dead code, reinvented stdlib, needless dependencies, and single-implementation abstractions, reports ranked cuts, applies only…
code-quality
Comprehensive code review for Java - clean code principles, API contracts, null safety, exception handling, and performance. Use when user says "review code", "refactor", "check API", or before merging changes.