review-and-plan
Use when the user asks Codex to review a repository for improvement opportunities, feature inspiration, roadmap ideas, or implementation candidates before planning changes; exclude direct implementation-only, factual/explanation, trivial, or explicit no-plan requests.
npx skills add Optim-Agent/optim-plans --skill review-and-plan --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Review And Plan Discover opportunities first; implementation still goes through `../optim-plans/SKILL.md`. ## Required Flow 1. Inspect the target Git repo before asking product questions. Read the app shape, docs, tests, dependency files, entry points, recent change notes, and any obvious UX or safety-critical paths. 2. Search GitHub open-source projects for feature inspiration before ranking opportunities. Use `gh search repos` / `gh search code` when available; if `gh` is unavailable or unauthenticated, use the GitHub REST/search API or web search constrained to GitHub repository pages. Record sources either way. 3. Produce a ranked opportunity list grouped exactly by: - Documentation - Efficiency/cost - Feature completeness - UX - Safety/recoverability 4. For each opportunity, include stable fields: - `id`: stable ID such as `OPP-001` - `category`: one group above - `rank`: rank within category or overall list - `title` - `repo_evidence`: local file/behavior evidence - `repository_url`: GitHub source repository URL - `supported_claim`: concise claim supported by that source - `source_tool`: `gh`, `github-api`, or `web` 5. Ask one case-by-case opportunity question at a time bef
- Required Flow
- Hard Boundaries
What does the review-and-plan skill do?
Use when the user asks Codex to review a repository for improvement opportunities, feature inspiration, roadmap ideas, or implementation candidates before planning changes; exclude direct implementation-only, factual/explanation, trivial, or explicit no-plan requests.
How do I install it?
Run `npx skills add Optim-Agent/optim-plans --skill review-and-plan --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From Optim-Agent/optim-plans, a repository with 288 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.