unc-skills

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

Skill	What it does	Cross-harness note
hands-free	Calls your phone when the coding agent needs an answer or approval.	Same Python/Vapi contract in all three harnesses.
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	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	Indexed local search over prior Claude Code and Codex sessions.	Runs from pi, but does not index pi's own transcripts yet.
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	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	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	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/ contains small, harness-neutral blocks for always-loaded agent instruction files. Unlike skills, snippets do not depend on discovery or explicit invocation.

• 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, or install interactively:

npx skills add miguelrios/unc-skills

Install one directly with --skill:

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:

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

Install for Claude Code

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

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

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:

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