maicongambini/omp-harness-guide/harness-readable-workspace
Claude Code and agent skill by maicongambini/omp-harness-guide
- community
Checking that the SKILL.md file is still in the repository.
Audit fresh-session repository readability. Use when modifying the harness or when an agent cannot orient. Do NOT use for runtime health checks (use harness-status).
Install
npx vskill@latest install maicongambini/omp-harness-guide/harness-readable-workspaceSKILL.md
The same SKILL.md was published earlier as maicongambini/omp-harness-guide/harness-readable-workspace.
Harness Readable Workspace
Use when the harness has been modified or a session fails to orient correctly.
Fresh-Session Readability Test
Simulate a new session with zero chat history. Read only repo files. Answer each:
- What does this system do?
- How is it organized?
- How do I install and start it?
- How do I verify it works?
- What is the current progress?
- What is the next task?
If any question is unanswerable from files: that is a harness gap.
Common Gaps and Fixes
| Unanswerable Question | Root Cause | Fix | |
|---|---|---|---|
| What does this system do? | No AGENTS.md summary | Add 2-3 line summary to AGENTS.md top | |
| How do I start it? | No startup commands documented | Add Quick Start section to AGENTS.md | |
| What is current progress? | STATE.md stale or placeholder | Update Current Active Work section | |
| What is the next task? | No in_progress feature | Set one feature to in_progress in feature_list.json | |
| What decisions were made? | No decisions log | Add to STATE.md Decisions Log |
Output
For each of the 6 questions: [question] | answerable: yes/no | source file | gap if no
Then propose one fix per gap. Ask user to approve before writing.
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingomp/agent/skills/harness-readable-workspace/SKILL.md
Popularity
- 7-day trend score
- 5
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/maicongambini/omp-harness-guide/harness-readable-workspace)