# Harness Skills

> From a natural-language request to reviewed, verified work.

Harness Skills is a set of owned us-* skills for Oh My Pi, Claude Code, OpenCode and Codex that take a natural-language request to reviewed, verified work.

## What does Harness Skills do?

- **Research before edits.** us-research inspects current source, callers, conventions and applicable memory, using a read-only worker when research is enabled.
- **A plan with one approval.** us-plan drafts a plan with concrete acceptance and ownership, then asks for one approval.
- **Classified implementation workers.** us-implement runs authorized implementation and repairs, inline for a focused fix or through classified workers.
- **Fresh reviews.** us-review and us-check-security give independent, evidence-based correctness and security reviews.
- **Focused audits.** Security, performance and code-quality audits, plus architecture and test-coverage improvements. Audits default to read-only.
- **Delivery.** us-open-pr and us-approve-work deliver reviewed work as a feature-branch pull request, only when you explicitly authorize it.
- **Memory.** Agent-invoked memory for durable facts alongside code relationships. us-use-harness-memory pairs with the separate Harness Memory MCP tools.
- **A fast lane.** A repository switch or us-ignore-workflow skips the workflow for a request. Small, bounded fixes can use focused repair.

## Which harnesses and tools does Harness Skills support?

| Harness | Support |
| --- | --- |
| Oh My Pi (OMP) | Marketplace plugin harness-useful-skills@harness-useful-skills. Needs OMP with marketplace support and Node.js 22+. |
| Claude Code | Marketplace plugin with 21 namespaced skills and seven native agents. Needs Node.js 22+. |
| OpenCode | Supports OpenCode v1.x and v2.x through one installed plugin. Needs Node.js 22+. |
| Codex | Plugin gives the 21 skills. The full install also adds seven agents and the memory MCP server. Needs Node.js 22+ and the codex CLI. |

## Which platforms does Harness Skills run on?

- macOS
- Linux
- Windows (PowerShell installer for OpenCode and Codex)

## How do I install Harness Skills?

### Oh My Pi

```sh
omp plugin marketplace add MSpiechowicz/harness-useful-skills
omp plugin install harness-useful-skills@harness-useful-skills --scope user
```

### Claude Code

```sh
claude plugin marketplace add MSpiechowicz/harness-useful-skills
claude plugin install harness-useful-skills@harness-useful-skills --scope user
```

### OpenCode (macOS and Linux)

```sh
curl --proto '=https' --tlsv1.2 -fsSL https://raw.githubusercontent.com/MSpiechowicz/harness-useful-skills/main/install.sh | sh
```

### Codex

```sh
codex plugin marketplace add MSpiechowicz/harness-useful-skills
codex plugin add harness-useful-skills@harness-useful-skills
```

## Is it safe? What stays under your control?

- No Anvil dependency, custom workflow executor, model router, phase database or stop-hook continuation loop.
- The skills are instructions your harness reads. They are prompt instructions, not enforced stage transitions.
- The OpenCode and Codex install scripts download the release tarball over HTTPS, run safety checks and install nothing when a check fails.
- Audits default to read-only local investigation: no production probing and no automatic fixes.

## Frequently asked questions

### What is Harness Skills?

Harness Skills is a set of owned us-* skills for Oh My Pi, Claude Code, OpenCode and Codex. These harnesses discover the skill descriptions, and the model follows the relevant instructions with its own native tools and workers. It takes a request to reviewed, verified work.

### Which coding agents does Harness Skills support?

Oh My Pi, Claude Code, OpenCode and Codex. Each has its own install section. Claude Code gets 21 namespaced skills and seven native agents. OpenCode v1.x and v2.x are supported. Codex needs the codex CLI. All adapters need Node.js 22 or newer.

### How do I install Harness Skills?

Use the commands for your harness. Oh My Pi, Claude Code and Codex install a marketplace plugin with a short command. OpenCode, and the full Codex install, use a curl script on macOS and Linux or an irm script in PowerShell on Windows. Restart the harness afterwards.

### Does the workflow run automatically and can I turn it off?

Natural development requests go through us-run-workflow, which inspects the code and explains the selected lane. The skills are prompt instructions, not enforced stage transitions. In OMP, run /useful-skills workflow disabled in a repository to switch it off there, or invoke us-ignore-workflow for one request.

### Does Harness Skills include memory?

Yes. Claude Code, OpenCode and Codex get a separate local memory server with memory_status, memory_search, memory_save, graph_build and graph_query tools, with project-scoped private files. The us-use-harness-memory skill works with the separate Harness Memory MCP tools.

### Is Harness Skills free and open source?

Yes. This repository is under GPL-3.0-only. Third-party portions keep their stated licenses, recorded in the repository’s attribution table. It has no custom workflow executor, model router or phase database.

## Links

- Page: https://harness-useful.com/skills
- GitHub: https://github.com/MSpiechowicz/harness-useful-skills
- Releases: https://github.com/MSpiechowicz/harness-useful-skills/releases
- License: GPL-3.0-only
- Harness Useful home: https://harness-useful.com/
- FAQ: https://harness-useful.com/faq