sw-status

Display Specwright state with work units, task progress, gate results, and lock status.

9|1|Updated Feb 9, 2026
One-click install
npx skills add https://github.com/Obsidian-Owl/specwright --skill sw-status
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sw-status
Source: https://github.com/Obsidian-Owl/specwright/tree/main/skills/sw-status
Command: npx skills add https://github.com/Obsidian-Owl/specwright --skill sw-status

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a clear overview of the Specwright agent's current operational status, including active tasks, progress, and any potential issues, helping users stay informed and in control.

Core Features & Use Cases

  • Status Display: Shows the current work unit, task progress, and gate results.
  • Lock Status: Indicates if the system is locked and by whom.
  • Reset Functionality: Allows users to abandon work in progress with the --reset flag.
  • Use Case: After a long coding session, you can quickly run this skill to see exactly which task the AI is working on, how far along it is, and if any previous steps have failed, before deciding on the next action.

Quick Start

Run the sw-status skill to see the current Specwright state.

Frequently Asked Questions about sw-status

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

FAQPage Schema
How do I check the current workflow status and task progress of my agent?

To check agent workflow status, run a status command that reads workflow.json and config.json to display active work units, task progress, and gate results. This provides immediate visibility into the agent's current operational state.

What does agent lock status indicate when monitoring task progress?

Agent lock status indicates whether the workflow system is currently locked and identifies the specific process holding the lock. This information helps diagnose potential bottlenecks or conflicts during active task execution.

Can I reset agent state and abandon work in progress during a workflow?

Yes, you can reset agent state and abandon work in progress by passing the --reset argument to the status command. This clears the current active work units and task progress tracked in workflow.json.

How do I view gate results and active work units for my current workflow session?

View gate results and active work units by executing the status skill, which reads configuration and state files to present a comprehensive overview of your current workflow session, including any failed validation steps.

Why does my workflow status show a locked state when checking task progress?

A locked workflow status indicates an active process is holding the system lock, preventing concurrent modifications to the agent state. The status display identifies which process or work unit currently holds this lock.

When should I reset agent state instead of continuing with the current task progress?

Reset agent state when previous workflow steps have failed or the active work unit is stuck, as shown in the status display. The --reset argument abandons the current progress tracked in workflow.json to start fresh.