How does the Suggest skill determine what I should work on?

It uses a three-tier priority cascade: first checking your tasklist for immediate items, then scanning the codebase for technical debt or TODOs, and finally reviewing your project vision to identify missing features.

What documentation files does the Suggest skill use?

The skill looks for standard project files including docs/progress.md, docs/tasklist.md, and docs/vision.md to understand the state of your project.

Can Suggest automatically start a task for me?

Yes, it provides specific commands (like /arc:ideate or /arc:build) for each suggestion. Once you choose a recommendation, you can invoke the provided command to begin work immediately.

Does this skill perform code reviews or run tests?

No, the Suggest skill is a project compass, not a map. It identifies *what* to do next, but does not perform the actual code review or test execution itself.

Project Suggestion & Prioritization

Name: Project Suggestion & Prioritization
Author: howells

byhowells

•

Productivity & Workflow

Provides opinionated recommendations for the next coding tasks by analyzing project documentation, technical debt, and codebase health.

The Suggest skill serves as an intelligent project compass for Claude Code, designed to eliminate decision paralysis by identifying the most impactful next steps. By implementing a priority cascade, it evaluates existing task lists, scans the codebase for technical debt and TODOs, and compares the current implementation against the overall project vision. This skill is particularly useful at the start of a session or after completing a major milestone, offering actionable suggestions paired with direct commands to transition immediately into building, ideating, or refactoring.