gpd-suggest-next

Suggests prioritized next actions by scanning project phases, plans, blockers, and todos.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics --skill gpd-suggest-next-michaelsengineering
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gpd-suggest-next
Source: https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics/tree/main/.agents/skills/gpd-suggest-next
Command: npx skills add https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics --skill gpd-suggest-next-michaelsengineering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When working on a multi-phase project, it is hard to know what to work on next without manually reading progress reports, roadmaps, and todo lists. This Skill answers "what should I do next?" by analyzing the current project state and returning a prioritized action list. ## Core Features & Use Cases - Prioritized Suggestions: Runs the GPD CLI suggest command to produce actions sorted by priority, each with a command and reason. - Project Context Summary: Displays current phase, progress percentage, status, and paused position alongside suggestions. - Blocker Highlighting: Surfaces active blockers before suggestions so they can be resolved first. - Use Case: After returning to a project mid-phase, run this Skill to immediately see the highest-priority pending task and any blockers, instead of reading through STATE.md and ROADMAP.md manually. ## Quick Start Ask the assistant to suggest the most impactful next action based on the current project state.

Frequently Asked Questions about gpd-suggest-next

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find out what to work on next in a GPD project?▼

Run the suggest-next workflow, which executes the GPD CLI suggest command to scan phases, plans, verification status, blockers, and todos. It returns a prioritized list of actions with commands and reasons, sorted with priority 1 highest.

What project information does the suggest command analyze?▼

The suggest command scans project phases, plans, verification status, active blockers, and todos. It returns context including current phase, status, progress percentage, paused position, and active blockers alongside the suggestion list.

Why does the suggest-next command fail with an error?▼

Failures typically occur when the GPD CLI is invoked incorrectly. Use the pinned runtime invocation with the venv Python path, codex runtime flag, and local config directory rather than the ambient gpd binary on PATH.

Can I use this Skill without the GPD CLI installed?▼

No, the Skill depends on the GPD runtime CLI to generate suggestions. If the CLI is unavailable or fails, the Skill recommends checking manual project status through the progress reporting workflow instead.

How are blockers handled in the suggestion output?▼

When active blockers exist, they are highlighted before the suggestion list with a count and description. This ensures blockers are resolved before continuing with lower-priority suggested actions.