Skip to content
Development
Agent

readme-reviewer

Audits README files to ensure all setup commands work and architecture pointers are accurate.

From plugin
agent-powerups
846 skills46 agents54 commands

Claude Code

> /plugin marketplace add yeaight7/agent-powerups

Agent definition

readme-reviewer.md
description: "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.

@yeaight7
Ships withagent-powerups

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

8114 skills46 agents
Get the whole plugin

Stars on GitHub

Momentum

stars in total
8
Star history of yeaight7/agent-powerups on GitHub, a chart by star-history.com

Other agents on agent-powerups.

codebase-mapper

codebase-mapper

Agent

Explores codebase and writes structured analysis documents. Spawned by map-codebase with a focus area (tech, arch, quality,…

intel-updater

intel-updater

Agent

Refresh codebase intelligence documents after meaningful repo changes and note what became stale or newly important.

codebase-cleaner

codebase-cleaner

Agent

Reviews code for quality, security, and performance. Detects code smells, identifies vulnerabilities, and recommends maintainable…

safe-refactorer

safe-refactorer

Agent

Specializes in restructuring code without changing observable behavior. Uses test-driven development principles to guarantee…

More agents from other plugins.

a11y-architect
Auto-invoked

a11y-architect

Agent

Accessibility Architect specializing in WCAG 2.2 compliance for Web and Native platforms. Use PROACTIVELY when designing UI…

ecc13d293k
@affaan-m@affaan-mInstall Agent
analyze-pass-impact

analyze-pass-impact

Agent

Analyzes how a specific topic affects a group of compiler passes. Used by the /plan-update skill to parallelize research across…

react2d252k
@facebook@facebookInstall Agent
orchestrator

orchestrator

Agent

- If the user makes a simple request (such as asking for the time) which you can fulfill by running a terminal command (such as…

codex2d135k
@openai@openaiInstall Agent
cavecrew-builder

cavecrew-builder

Agent

Surgical 1-2 file edit. Typo fixes, single-function rewrites, mechanical renames, comment removal, format-preserving tweaks. Hard…

caveman3d119k
@juliusbrussee@juliusbrusseeInstall Agent

Questions about readme-reviewer.

Which coding agents can use readme-reviewer?
readme-reviewer installs in Claude Code and Cursor: each loads subagents from .claude/agents, so copy the file there. Flowy's auto-invocation runs in Claude Code only.