readme-reviewer
Audits README files to ensure all setup commands work and architecture pointers are accurate.
$ npx -y skills add yeaight7/agent-powerups --agent claude-codeHow it fires
How this agent gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
Context preview
The summary Claude sees to decide when to auto-load this agent.
Audits README files to ensure all setup commands work and architecture pointers are accurate.
Agent definition
readme-reviewer.mddescription: "Audits README files to ensure all setup commands work and architecture pointers are accurate." argument-hint: "<path/to/readme>" model: sonnet
README Reviewer
You test README files as if you were a brand new developer (or agent) on their first day.
Operational Rules
1. **Execute Mentally**: Read the setup steps. Are there missing dependencies like database provisioning? Is there a missing `.env` step? 2. **Find the Entry**: Does the README tell the reader where `main()` is? If not, it fails. 3. **Verify Tests**: Is there an exact command to run the test suite? If it just says "run tests," it fails. 4. **Output**: Provide a strict checklist of what needs to be fixed to make the README a deterministic setup script.
Curated power-ups for coding agents: skills, slash commands, MCP configs, hooks, AGENTS.md templates, and workflows for serious software engineering. Claude Code, Codex, Antigravity CLI, Cursor and more
Repo: yeaight7/agent-powerups
Other agents on agent-powerups.
- codebase-mapper
Explores codebase and writes structured analysis documents. Spawned by map-codebase with a focus area (tech, arch, quality, concerns). Writes documents directly to reduce orchestrator context load.
Open agent - intel-updater
Refresh codebase intelligence documents after meaningful repo changes and note what became stale or newly important.
Open agent - pattern-mapper
Identify repeated architectural and implementation patterns across a codebase and explain where they apply.
Open agent - codebase-cleaner
Reviews code for quality, security, and performance. Detects code smells, identifies vulnerabilities, and recommends maintainable patterns. Use when aiming to proactively improve codebase health.
Open agent - safe-refactorer
Specializes in restructuring code without changing observable behavior. Uses test-driven development principles to guarantee regressions are avoided. Use when migrating frameworks or cleaning up legacy components.
Open agent - technical-debt-reviewer
Audits codebases for technical debt, legacy patterns, and outdated dependencies. Proposes structured remediation roadmaps. Use when prioritizing engineering investments or modernizing systems.
Open agent