| name | devsquad-status |
| description | Shows squad health, token usage, and delegation compliance stats |
| version | 1.0.0 |
DevSquad Status Skill
Displays current squad health metrics including token usage, budget zone, delegation compliance, and agent availability.
When to Use
Invoke when the user wants to check:
- Current token budget and zone status (green/yellow/red)
- Live usage percentages from Claude, Gemini, and Codex CLIs
- Delegation compliance statistics
- Squad availability (which agents are installed)
- Capacity-aware delegation recommendations
Capacity-Aware Delegation
Status reads from a local capacity cache (.devsquad/capacity.json) populated by /devsquad:capacity.
Users report their current CLI usage percentages by checking:
- Claude:
/status → "Current session" percentage
- Gemini:
/stats → "Usage left" (subtract from 100)
- Codex:
/status → "5h limit" and "Weekly limit" (subtract from 100)
The cache expires after 30 minutes, after which status shows a "STALE" warning and recommends re-running /devsquad:capacity.
Zone Thresholds
- 🟢 Green: < 50% usage — normal operation
- 🟡 Yellow: 50-75/80% — enforce delegation
- 🔴 Red: > 75/80% — critical, delegate everything
Usage
bash "${CLAUDE_PLUGIN_ROOT}/skills/devsquad-status/scripts/show-status.sh"
For machine-readable output:
bash "${CLAUDE_PLUGIN_ROOT}/skills/devsquad-status/scripts/show-status.sh" --json
Output Format
Human-Readable (default)
=== DevSquad Status ===
Token Budget:
Zone: GREEN (42% used)
Input tokens: 84,000
Output tokens: 12,000
Total: 96,000 / 200,000
Squad Usage (this session):
Gemini: 5 invocations, ~12,400 chars response
Codex: 2 invocations, ~3,200 chars response
Self: 8 calls
Delegation Compliance:
Suggestions made: 3
Overrides (advisory): 1
Compliance rate: 67%
Squad Availability:
Gemini CLI: available
Codex CLI: available
JSON Format (with --json)
Returns the raw JSON output from get_usage_summary function.
Dependencies
- lib/state.sh - State management
- lib/usage.sh - Usage tracking and zone calculation
- .devsquad/logs/delegation.log - Delegation suggestions log
- .devsquad/logs/compliance.log - Compliance override log
