docs: skill inventory and classification matrix for all 38 upstream skills

This commit is contained in:
haylan committed 2026-10-14 11:46:37 +02:00
1 parent d190ded022
commit 03e8e0391a
5 files changed
+191 -15

No files matched your search

+16 -10
View File
@@ -4,21 +4,23 @@ Updated: 2026-10-14 (phase 0 — analysis)
## Current phase
Phase 0 (analysis) — nearly complete. Phase 1 (plugin package) not started.
Phase 0 (analysis) — COMPLETE. Phase 1 (plugin package) ready to start at TODO 1.1.
## Done
- Repo bootstrapped (was empty; Gitea remote `haylan/mattpocock-skills-opencode` configured, no commits yet).
- Repo bootstrapped (was empty; Gitea remote `haylan/mattpocock-skills-opencode` configured).
- Studied reference repos (cloned to temp, not vendored):
- `fastcrw-opencode-websearch` — V2 plugin shape, Gitea release script/workflows, test style
(`node --test` on .ts), prettier/tsconfig conventions.
- `mcdays94/pocock-agents` — proven orchestrator/worker agent pair (V1-era, tracks upstream v1.3
`d81f3a1`), drift-check script, Docker smoke test.
- `mattpocock/skills` @ `49dd158` (2026-10-09, v1.3.1) — full inventory: engineering 20,
productivity 7, misc 4, in-progress 7 (excluded), deprecated 0.
- Verified OpenCode V2 API surface against docs + `anomalyco/opencode@dev` source (see AGENTS.md
"Key V2 facts").
- Wrote: AGENTS.md, state files, TODO.md, docs/architecture.md, docs/skill-mapping.md.
- `mattpocock/skills` @ `49dd158` (2026-10-09, v1.3.1) — all 38 SKILL.md files read in full by a
subagent: frontmatter census (only name/description/disable-model-invocation×23/argument-hint×4/
metadata.credits×1), dependency graph, subagent census, 17 pending patch changesets.
- Verified OpenCode V2 API surface against docs + `anomalyco/opencode@dev` source + installed
`@opencode/plugin@2.0.29` typings (see AGENTS.md "Key V2 facts").
- Wrote: AGENTS.md, state files (upstream/decisions D1–D8/classification.json), TODO.md,
docs/architecture.md, docs/skill-mapping.md (31 vendored + 7 excluded skills classified).
## Known gaps / risks
@@ -35,6 +37,10 @@ Phase 0 (analysis) — nearly complete. Phase 1 (plugin package) not started.
## Next steps (exact)
1. Finish docs/skill-mapping.md classification matrix (subagent analysis of every SKILL.md).
2. Commit phase-0 docs: `docs: phase 0 analysis and migration plan`.
3. Start TODO.md Phase 1.1: scaffold package (package.json, tsconfig, prettier, src/index.ts stub).
1. Phase 1.1: scaffold package (package.json `@haylan/opencode-pocock` — confirm scope with owner,
tsconfig, prettier, .gitignore, MIT LICENSE + upstream attribution, README stub).
2. Phase 1.2: scripts/sync-upstream.ts + vendor upstream/ @49dd158 (strip non-skill files: keep
skills/{engineering,productivity,misc}/** minus agents/openai.yaml; write UPSTREAM.json).
3. Phase 1.6 note: agent templates = port pocock.md/pocock-worker.md from mcdays94/pocock-agents
(temp clone path in status history) to V2-native frontmatter + add pocock-reviewer; update
stack-skills table to be user-editable; worker skill allow-list from classification.json.