Next

Analyze project state and suggest the most appropriate next action.

When to Use

• Finished a task, wondering what's next

• Not sure which skill to run

• Starting a session and want guidance

• Feel stuck or overwhelmed

Instructions

1. Check Project State

Run these checks to understand current state:

Git status

git status --short git branch --show-current

Are we ahead/behind main?

git rev-list --left-right --count main...HEAD 2>/dev/null || echo "no main branch"

Any uncommitted changes?

git diff --stat

Recent activity

git log --oneline -5

2. Check for Signals

Look for indicators of what needs attention:

Signal Suggests

Uncommitted changes on feature branch /refactor then commit

On main with no changes Check TODO.md or ask what to build

PR open for current branch /review-pr for final check

tmp/*.md files from previous reviews Review suggestions, decide what to address

Build errors in terminal /debug

TODO.md has unchecked items /todo

Package updates available /outdated

3. Check Files

TODO.md exists and has items?

[[ -f TODO.md ]] && grep -c "^- [ ]" TODO.md

tmp/ has review files?

ls tmp/*.md 2>/dev/null

Any error logs?

ls .log tmp/.log 2>/dev/null

4. Decision Tree

What's the current state? │ ├── Uncommitted changes on branch? │ └── Run /refactor → review and improve before committing │ ├── Changes committed but not pushed? │ └── Run /preflight → catch issues before PR │ ├── Ready to create PR? │ └── Run /review-pr on your own branch → final sanity check │ ├── PR exists and approved? │ └── Merge and deploy │ ├── On main, nothing in progress? │ ├── TODO.md has items? → /todo │ ├── Want to check dependencies? → /outdated │ └── Ask user what to build next │ ├── Something broken? │ └── /debug │ ├── Tests need review? │ └── /test-review │ └── Not sure? └── /skills to see all options

Output Format

What's Next?

Current State:

• Branch: {branch-name}
• Status: {clean / uncommitted changes / ahead of main by X commits}
• TODO.md: {X items remaining / not found}

Recommended Action:

/refactor

{Why this is recommended based on current state}

Other Options:

• /preflight - {when this would be useful}
• /todo - {when this would be useful}

Or tell me what you want to work on.

Skill Quick Reference

Skill Use When

/refactor

Review your branch, improve until 90+

/review-pr

Review someone's PR or final-check your own

/preflight

Quick issue scan before creating PR

/debug

Something's broken, find the cause

/test-review

Check test coverage and quality

/todo

Work through TODO.md tasks

/outdated

Check for major version upgrades

/scaffold-route

Create new Next.js feature

/zod-extract

Centralize inline Zod schemas

/prototype

Quick React demo

/infopage

Generate reference HTML page

/creative-design

Distinctive UI for landing pages

/mcp

Build MCP server

/skills

List all available skills

Notes

• This skill is for orientation, not automation

• It suggests, you decide

• If none of the suggestions fit, just say what you want to do

• Run /skills if you want the full list with descriptions