# Chief — Skills Registry

> **Full repo catalog:** [`docs/ai-skills-repos.md`](../../../../docs/ai-skills-repos.md) (130+ repos, categorized, machine-readable)

Chief's skills are **familiar-with, not expert**. Each is authored here (self-owned, so no
license risk) but draws on public work. This file lists the upstream sources so OpenClaw
(Claw) can install the permissively-licensed ones and check them for updates.

## Skills
| Skill | Purpose |
|-------|---------|
| [`decide-and-scope`](./decide-and-scope/SKILL.md) | Pressure-test a decision, then turn it into a delegable spec |
| [`verify-work`](./verify-work/SKILL.md) | Check specialist output against the spec + our source of truth |
| [`report-to-sam`](./report-to-sam/SKILL.md) | Report to Sam: decision-first, dense, no slop |
| [`pressure-test-opportunity`](./pressure-test-opportunity/SKILL.md) | Go/no-go on a business opportunity |
| [`scope-to-business`](./scope-to-business/SKILL.md) | Route each work item to the correct SNS entity; catch scope bleed (self-authored, SnS-specific) |

## Upstream sources & updates

**Legend:** ✅ = explicit permissive license, safe to install/redistribute · ⚠️ = license
**not specified** upstream (treat as *all rights reserved*) — we do NOT install these; the
principle is authored into our own SKILL.md. Link kept only to watch for updates/ideas.

| Repo | License | Use | Install / update |
|------|---------|-----|------------------|
| [mattpocock/skills](https://github.com/mattpocock/skills) | ✅ MIT | `/grill-me`, `/diagnose`, `/to-prd` | `npx skills add mattpocock/skills` |
| [Anbeeld/WRITING.md](https://github.com/Anbeeld/WRITING.md) | ✅ MIT | anti-slop writing rules (Mini) | `npx skills add Anbeeld/WRITING.md` |
| [yzhao062/agent-style](https://github.com/yzhao062/agent-style) | ✅ CC BY 4.0 | "Elements of Agent Style" | clone + copy `SKILL.md` |
| [Kappaemme-git/codex-startup-pressure-test-skill](https://github.com/Kappaemme-git/codex-startup-pressure-test-skill) | ✅ MIT | opportunity pressure-test | `npx skills add Kappaemme-git/codex-startup-pressure-test-skill` |
| [nateherkai/AIS-OS](https://github.com/nateherkai/AIS-OS) | ✅ MIT | solo-operator leverage (`/audit`, `/level-up`) | `npx skills add nateherkai/AIS-OS` |
| [forrestchang/andrej-karpathy-skills](https://github.com/forrestchang/andrej-karpathy-skills) | ⚠️ unspecified | decision-hygiene principles | reference only — principle authored in `decide-and-scope` |
| [Rimagination/good-question](https://github.com/Rimagination/good-question) | ⚠️ unspecified | scope/requirements before acting | reference only |
| [fivetaku/fablize](https://github.com/fivetaku/fablize) | ⚠️ unspecified | evidence-as-procedure verification | reference only — authored in `verify-work` |
| [amElnagdy/guard-skills](https://github.com/amElnagdy/guard-skills) | ⚠️ unspecified | 14 AI failure modes | reference only — authored in `verify-work` |
| [golbin/agent-skills](https://github.com/golbin/agent-skills) | ⚠️ unspecified | review-implementation vs spec | reference only |
| [ronikobrosly/RigorLoop](https://github.com/ronikobrosly/RigorLoop) | ⚠️ unspecified | work as reviewable artifact | reference only |
| [shreyashankar/plain-writing-skill](https://github.com/shreyashankar/plain-writing-skill) | ⚠️ unspecified | plain-language writing | reference only — authored in `report-to-sam` |
| [yetone/kill-ai-slop](https://github.com/yetone/kill-ai-slop) | ⚠️ unspecified | anti-slop | reference only |

### Coding Standards / Software Principles (to evaluate)

| Repo | License | Use | Install / update |
|------|---------|-----|------------------|
| [JordanCoin/codingskills](https://github.com/JordanCoin/codingskills) | ⚠️ check | KISS, DRY, SOLID, YAGNI, SoC, Law of Demeter, Boy Scout Rule — language-agnostic agent skills + stack detection | evaluate — closest to what we want |
| [AsyrafHussin/agent-skills](https://github.com/AsyrafHussin/agent-skills) | ⚠️ check | Clean code principles as agent skills — SOLID, naming, error handling | evaluate |
| [ramziddin/solid-skills](https://github.com/ramziddin/solid-skills) | ⚠️ check | SOLID + TDD + clean architecture — "senior-engineer quality" agent skills | evaluate |
| [MickeyKay/agent-standards](https://github.com/MickeyKay/agent-standards) | ⚠️ check | Shared coding standards + reusable workflows + agent-facing instructions | evaluate |
| [obra/superpowers](https://github.com/obra/superpowers) | ⚠️ check | Full agentic skills framework + dev methodology (design → plan → TDD → YAGNI/DRY) | evaluate — more opinionated/workflow-based |
| [msitarzewski/AGENT-ZERO](https://github.com/msitarzewski/AGENT-ZERO) | ⚠️ check | Single AGENTS.md canonical guide — architecture-first, repeatable, auditable delivery | evaluate |

### Install / update notes for Claw
- **Install a ✅ skill:** `npx skills add <owner>/<repo>` (drops it into the skills dir),
  or clone and copy its `SKILL.md` into `skills/<name>/`.
- **Check for updates:** re-run `npx skills add <owner>/<repo>`, or if cloned,
  `git -C <clone> pull` and diff before adopting changes.
- **⚠️ repos:** do **not** install or redistribute until they add an OSI-approved license.
  Watch the repo for updates/ideas; if a license appears, promote it to ✅ here.
- **Optional later — self-improvement:** [openclaw self-improving-agent](https://github.com/openclaw/skills/blob/main/skills/pskoett/self-improving-agent/SKILL.md),
  [Kulaxyz/self-learning-skills](https://github.com/Kulaxyz/self-learning-skills) — let Chief log corrections and promote patterns to rules. Add only when we want compounding.
