harness-status

Checks harness readiness by reporting git state, PREVC phase, handoff presence, and context budget.

Updated Jul 29, 2026
One-click install
npx skills add https://github.com/MaiconGambini/opencode-harness-guide --skill harness-status-maicongambini
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harness-status
Source: https://github.com/MaiconGambini/opencode-harness-guide/tree/main/skills/harness-status
Command: npx skills add https://github.com/MaiconGambini/opencode-harness-guide --skill harness-status-maicongambini

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When working across multiple OpenCode sessions, it is hard to know whether the harness is in a safe state before handing off work, opening a PR, or resuming a session. This Skill runs a single status script that consolidates the key readiness signals in one place. ## Core Features & Use Cases - Readiness Check: Runs node .opencode/scripts/harness-status.mjs to report git state, current PREVC phase, and handoff presence. - Security & Budget Commands: Surfaces the security scan command and the context budget command so you can verify them before delivery. - Use Case: Before creating a PR or resuming a paused session, run the status check to confirm the harness state is consistent and no handoff or validation step is missing. ## Quick Start Ask the agent to check the harness status before handoff so it runs the harness-status script and reports the current readiness state.

Frequently Asked Questions about harness-status

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

FAQPage Schema
How do I check harness readiness before a handoff in OpenCode?

Run the harness-status script with `node .opencode/scripts/harness-status.mjs`. It reports git state, the current PREVC phase, and handoff presence so you can confirm the harness is ready before handing off work.

What does the harness status check report?

It reports the git state, the current PREVC phase, whether a handoff exists, the security scan command, and the context budget command. Use these signals before PRs and when resuming sessions.

When should I run the harness status check?

Run it before handoffs, before opening pull requests, and when resuming a session. These are the transition points where an inconsistent harness state is most likely to cause problems.

Why does the harness-status script fail to run?

The script requires Node.js and the file `.opencode/scripts/harness-status.mjs` in the project. If the OpenCode configuration was not installed or the path differs, the command will fail with a module-not-found error.