skill-status

Displays current workflow phase, roadmap progress, blockers, and next-action suggestions from project state files.

Updated Aug 15, 2026
One-click install
npx skills add https://github.com/GongYuanCaiJi/dsh-claude-octopus --skill skill-status-gongyuancaiji
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-status
Source: https://github.com/GongYuanCaiJi/dsh-claude-octopus/tree/main/.claude/skills/skill-status
Command: npx skills add https://github.com/GongYuanCaiJi/dsh-claude-octopus --skill skill-status-gongyuancaiji

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When working on multi-phase projects, it is easy to lose track of where you are in the workflow, what blockers exist, and what to do next. This Skill reads the project's state files and presents a clear status dashboard with intelligent routing to the appropriate next command. ## Core Features & Use Cases - Status Dashboard: Reads STATE.md and ROADMAP.md from the .octo/ directory to display current phase, position, status, and blockers with visual progress markers. - Intelligent Routing: Maps workflow status (ready, in_progress, blocked, complete, shipped, etc.) to concrete next-step suggestions such as /octo:develop or /octo:issues. - Cross-Session Activity Summary: Summarizes recent git commits, tags, branches, and orchestration results when asked "what have I been working on", and suggests durable CLAUDE.md updates. - Use Case: After returning to a project mid-week, ask for a status check to see that you are in Phase 2 (Define), view remaining roadmap phases, and get directed to /octo:prd to continue requirements work. ## Quick Start Ask the assistant to show the current project status and what to do next.

Frequently Asked Questions about skill-status

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

FAQPage Schema
How do I check my project workflow status?▼

Ask for a status check and the Skill reads STATE.md and ROADMAP.md from the .octo/ directory, then displays your current phase, position, blockers, and a suggested next action based on your workflow state.

How to see what phase I am in during a multi-stage project?▼

The dashboard shows all four phases (Discover, Define, Develop, Deliver) with completion markers and highlights your current position. It reads the current_phase and current_position values via the octo-state.sh read_state command.

What happens if the project is not initialized yet?▼

If no .octo/ directory exists, the Skill reports that no project is initialized and suggests running /octo:embrace with a project description to set up the state files and begin the Discover phase.

Can I get a summary of recent work across sessions?▼

Yes. When asked what you have been working on, the Skill gathers recent git commits, tags, branches, and orchestration results, then groups them into a themed activity summary and can suggest durable CLAUDE.md updates.

Why does the status check fail with confusing errors?▼

Failures usually occur when the .octo/ directory does not exist or STATE.md is parsed manually instead of through octo-state.sh. Always verify initialization first and use the provided state script for reliable key-value parsing.