ark-skills

Stateless workflow consultant — the planning phase for any non-trivial task. Recommends exactly ONE execution ecosystem (gstack / superpowers / mattpocock / oh-my-claudecode) and hands off. Triggers on "what workflow should I use", "route this task", "plan this work", "start a task", "new feature", "fix bug", "consult", "which ecosystem", "how should I approach this". Replaces the retired chain-orchestration skill. Do NOT use for trivial single-file edits with no ambiguity — just do them.

Write-side knowledge operations for the OKF vault bundle at vault/. Triggers on "update the vault", "save this knowledge", "ingest this doc", "distill", "end of session knowledge", "regenerate index". Writes durable insights, research, decisions, and reference pages only — NOT session logs and NOT task tracking. Reading the vault is a separate concern (use NotebookLM or okf_cli.py).

Diagnostic check for the ark-skills v2 invariants — routing-destination ecosystems, the 6-skill roster, OKF conventions, GitHub-Issues conventions, and NotebookLM recall

Interactive setup wizard — converges a project onto the ark-skills v2 conventions (OKF knowledge bundle + GitHub-Issues task management + mattpocock issue machinery). Handles greenfield, migration, repair, and healthy states.

Version-driven migration framework — replays pending destructive migrations then converges downstream project to the current ark-skills target profile. Runs when plugin bumps add new conventions. Distinct from /ark-onboard repair (failure-driven) and /ark-health (diagnostic-only).

Upstream-dependency healing for ark-skills. Inventories the external plugins/CLIs ark-skills integrates with, diffs each upstream changelog/releases/commits against a last-seen snapshot, and surfaces required changes, new-feature opportunities, and retire-able workarounds as a ranked ADVISORY report plus staged patches. Project-level skill (not distributed). Invoke via /ark-skill-healer. Triggers on "heal skills upstream", "check upstream deps", "what upstream changed", "did upstream fix our workaround".

Synthesized-recall backend for the OKF knowledge bundle at vault/, synced to Google NotebookLM. Use this skill whenever starting a fresh session and needing project history, when asking "what's the current project state", "has this been tried before", "why did we decide X", or when generating audio/reports from vault content. Triggers on bootstrap, vault context, conflict check, or any question about past decisions/research. Warm-start triggers for session-continue: "resume from last session", "continue where I left off", "warm start", "pick up where I left off". Do NOT use for writing to the vault — that is the /vault skill. Do NOT use for general NotebookLM operations unrelated to the vault — use the global notebooklm skill for those.