What problem does it solve? Documentation drifts out of sync with code as a repository evolves: env vars go undocumented, agents get added but never registered, doc paths break, and architecture diagrams go stale. This Skill sweeps the whole repo for that drift, fixes the mechanical issues in place, and flags everything that needs a human decision. ## Core Features & Use Cases - Consistency sweep: Cross-checks agent/team/workflow registrations in app/main.py against files on disk, the app/config.yaml manifest, env vars against example.env and AGENTS.md, and doc paths against the filesystem. - Auto-fix with guardrails: Repairs stale doc paths, missing env var entries, broken links, and missing manifest entries, while explicitly refusing to touch db/, compose.yaml, Dockerfile, or pyproject.toml. - Live smoke testing: Verifies the running container serves this repo's components, smokes every code agent and team via the AgentOS HTTP API, and runs scripts/mcp_check.sh. - Use Case: Before tagging a public release of an Agno-based agent repo, run the sweep to catch an agent file that was never imported in app/main.py and an env var missing from example.env, then commit the fixes as one chore commit. ## Quick Start Ask the agent to run the review-and-improve sweep across the repo and report what it fixed and what needs your decision.
