modscape-spec-status

Reports spec work folder phase, file checklist, task progress, and next recommended command.

Updated Feb 25, 2026
One-click install
npx skills add https://github.com/yujikawa/modscape --skill modscape-spec-status-yujikawa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: modscape-spec-status
Source: https://github.com/yujikawa/modscape/tree/main/src/templates/gemini/modscape-spec-status
Command: npx skills add https://github.com/yujikawa/modscape --skill modscape-spec-status-yujikawa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When managing spec-driven data modeling changes in Modscape, it is hard to know where a given spec stands — which files exist, how many tasks remain, and what to do next. This Skill inspects a spec work folder and produces a clear status report with the recommended next command. ## Core Features & Use Cases - Phase Detection: Determines the current lifecycle phase (requirements, design, implement, ready to archive) from CLI output and file existence. - Task Progress Tracking: Counts completed and remaining tasks in tasks.md, broken down by phase section. - Next-Action Recommendation: Applies priority rules to suggest the exact next command, flagging unresolved questions or pending model changes. - Detail Mode: A detail subcommand summarizes the Why, What Changes, Decisions, Non-Goals, and remaining tasks for handoff or onboarding. - Use Case: After returning to a project, run the status command on your spec to instantly see that design is done, 3 of 8 tasks remain, and the next step is @modscape-spec-implement. ## Quick Start Ask the AI to show the status of your spec by running @modscape-spec-status with your spec name, adding "detail" for a full handoff summary.

Frequently Asked Questions about modscape-spec-status

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

FAQPage Schema
How do I check the status of a Modscape spec change?▼

Run @modscape-spec-status followed by the spec name. It shows the current phase, which files exist (spec.md, design.md, tasks.md), task completion counts, and the next recommended command.

How do I get a handoff summary for a spec in progress?▼

Use the detail subcommand: @modscape-spec-status <name> detail. It appends an overview from spec.md, key decisions and non-goals from design.md, and all remaining tasks grouped by phase.

What happens if I run spec status without a spec name?▼

The skill runs modscape spec list. If no specs exist it tells you to create one, if exactly one exists it uses it automatically, and if multiple exist it asks you to choose.

How is the next recommended command determined?▼

Priority rules are applied in order: unresolved model changes in design.md findings, open questions in _questions.yaml, missing spec.md, design.md, or tasks.md, incomplete tasks, then archive readiness.

Can spec status output in a language other than English?▼

Yes. If .modscape/modscape-spec.custom.md contains a Communication section with a language directive, all status output follows that language; otherwise it defaults to English.