---
slug: "parcha-parable"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/miguelrios/unc-skills@main/README.md"
repo: "https://github.com/miguelrios/unc-skills"
source_file: "README.md"
branch: "main"
---
# unc-skills

Miguel's collection of portable Agent Skills for Claude Code, Codex, and pi.

[![skills.sh](https://skills.sh/b/miguelrios/unc-skills)](https://skills.sh/miguelrios/unc-skills)

| Skill | What it does | Cross-harness note |
|---|---|---|
| [`hands-free`](https://github.com/miguelrios/unc-skills/tree/HEAD/hands-free/) | Calls your phone when the coding agent needs an answer or approval. | Same Python/Vapi contract in all three harnesses. |
| [`parable`](https://github.com/miguelrios/unc-skills/tree/HEAD/parable/) | Plans implementation batches, routes work to cheaper executors, verifies, and reviews. | Claude/native subagents are used only when available; stock pi needs a configured CLI-backed executor. |
| [`cascade`](https://github.com/miguelrios/unc-skills/tree/HEAD/cascade/) | Runs large projects as bounded, evidence-gated development loops. | Falls back to a file-backed task graph when the harness has no task or wake primitives. |
| [`recall`](https://github.com/miguelrios/unc-skills/tree/HEAD/recall/) | Indexed local search over prior Claude Code and Codex sessions. | Runs from pi, but does not index pi's own transcripts yet. |
| [`recap`](https://github.com/miguelrios/unc-skills/tree/HEAD/recap/) | Reconstructs everything observable that happened in one exact coding-agent session. | Uses Recall's Claude/Codex evidence; pi can run it but is not yet an indexed source. |
| [`tether`](https://github.com/miguelrios/unc-skills/tree/HEAD/tether/) | Keeps Slack threads attached to the exact agents that created them. | Codex and Claude Code resume natively; stock pi publishes as a headless run. End-to-end routing also installs an external Hermes plugin/runtime. |
| [`desloppify`](https://github.com/miguelrios/unc-skills/tree/HEAD/desloppify/) | Turns whole-codebase slop into evidence-backed cleanup with Peter O'Malley's official engine. | One canonical workflow selects honest native or prepared-packet review routes per harness. |
| [`autoqa`](https://github.com/miguelrios/unc-skills/tree/HEAD/autoqa/) | Points at any repo, discovers how it runs, and QAs the live app end-to-end with a witnessed report. | Uses whatever browser tooling the harness has; API/CLI checks work everywhere. |

The skill payloads are canonical `skills/<name>/SKILL.md` directories. Harness-specific
manifests package those same files; there are no Claude/Codex/pi forks to drift apart.

## Instruction snippets

[`snippets/`](https://github.com/miguelrios/unc-skills/tree/HEAD/snippets/) contains small, harness-neutral blocks for always-loaded
agent instruction files. Unlike skills, snippets do not depend on discovery or
explicit invocation.

- [`effective-comms`](https://github.com/miguelrios/unc-skills/tree/HEAD/snippets/effective-comms/) makes responses answer-first,
  concrete, structured, and brief by default while preserving safety and
  completeness exceptions.

## Install with skills.sh

Browse all eight skills at [skills.sh/miguelrios/unc-skills](https://skills.sh/miguelrios/unc-skills),
or install interactively:

```bash
npx skills add miguelrios/unc-skills
```

Install one directly with `--skill`:

```bash
npx skills add miguelrios/unc-skills --skill hands-free
npx skills add miguelrios/unc-skills --skill parable
npx skills add miguelrios/unc-skills --skill cascade
npx skills add miguelrios/unc-skills --skill recall
npx skills add miguelrios/unc-skills --skill recap
npx skills add miguelrios/unc-skills --skill tether
npx skills add miguelrios/unc-skills --skill desloppify
```

Add `--global` for a user-level install or `--agent claude-code`, `--agent codex`, or
`--agent pi` to choose a destination explicitly. The skills.sh CLI discovers the same canonical
payloads used by the native installs below; npm publication of the individual packages is not
required.

Tether also needs its external Hermes runtime. Install the complete bridge with:

```bash
npx --yes --package=github:miguelrios/unc-skills#main tether setup --harness=both
```

## Install for Claude Code

```bash
claude plugin marketplace add miguelrios/unc-skills
claude plugin install hands-free@unc-skills
claude plugin install parable@unc-skills
claude plugin install cascade@unc-skills
claude plugin install recall@unc-skills
claude plugin install recap@unc-skills
claude plugin install tether@unc-skills
claude plugin install desloppify@unc-skills
```

Install only the skills you want. Start a new session after installation.

## Install for Codex

```bash
codex plugin marketplace add miguelrios/unc-skills
codex plugin add hands-free@unc-skills
codex plugin add parable@unc-skills
codex plugin add cascade@unc-skills
codex plugin add recall@unc-skills
codex plugin add recap@unc-skills
codex plugin add tether@unc-skills
codex plugin add desloppify@unc-skills
```

Codex uses the native `.agents/plugins/marketplace.json` and package
`.codex-plugin/plugin.json` manifests. Start a new session after installation.

## Install for pi

```bash
pi install git:github.com/miguelrios/unc-skills
```

The repository is one pi package that exposes all seven skills. In pi, invoke one explicitly
with `/skill:hands-free`, `/skill:parable`, `/skill:cascade`, `/skill:recall`, `/skill:recap`,
`/skill:tether`, or `/skill:desloppify`.

## Compatibility checks

The local gate runs all seven skills across the three harnesses for native installation,
discovery, and credential-free smoke checks. Raw test output stays local and is not committed.

Run the local gate with:

```bash
npm test
for package in hands-free parable cascade recall recap tether desloppify; do (cd "$package" && npm test); done
python3 scripts/prove_portability.py --output /tmp/unc-skills-portability
```