ark-skills

Ark Skills Plugin

Claude Code plugin providing 6 shared skills to all ArkNode projects, built around two co-equal cores: a workflow consultant that plans and routes each task to one execution ecosystem, and a conventions layer that converges projects onto shared OKF knowledge bundles + GitHub-Issues task management. A context-discovery pattern adapts every skill to the active project at runtime.

Installation

# Add the marketplace
/plugin marketplace add HelloWorldSungin/ark-skills

# Install the plugin (user-scoped — available in all projects)
/plugin install ark-skills@ark-skills

# Verify skills are available
/ark-health

Prerequisites

Required for all skills: None — skills are instruction-only.

Optional — enhances task tracking, retrieval, and routing:

Dependency	Skills Enhanced	Install
gh CLI	/ark-consult, /ark-onboard (GitHub-Issues task management)	brew install gh + gh auth login
mattpocock/skills	/ark-consult (issue machinery + a routing destination)	npx skills@latest add mattpocock/skills + /setup-matt-pocock-skills
NotebookLM CLI	/notebooklm-vault (synthesized recall)	pipx install notebooklm-cli + notebooklm login

Routing destinations for /ark-consult (install per your workflow): superpowers, gstack, oh-my-claudecode.

Available Skills

Skill	Core	Description
/ark-consult	Workflow consultant	Stateless planning phase for any non-trivial task: triages, recommends exactly ONE execution ecosystem from a routing matrix, files a GitHub epic as the plan of record, and hands off.
/vault	Conventions	Write-side OKF knowledge ops for the bundle at vault/: end-of-session distillation, document ingestion, log.md append, index regen.
/notebooklm-vault	Conventions	Synthesized-recall backend: syncs the OKF bundle to NotebookLM and answers factual/historical queries.
/ark-onboard	Conventions	Interactive setup wizard: OKF bundle init, label bootstrap, mattpocock setup, CLAUDE.md rows.
/ark-health	Conventions	Diagnostic scorecard for the v2 invariants.
/ark-update	Conventions	Version-driven migration framework; converges downstream projects onto the current target profile (execution deferred per-project).

Skill Documentation

/ark-consult — Given a non-trivial task, triages it, asks at most two clarifying questions, and recommends exactly ONE execution ecosystem (gstack / superpowers / mattpocock / oh-my-claudecode) from a 12-archetype routing matrix with reasoning. Files a GitHub epic (epic + component + priority labels; children as task-list checkboxes, optionally cut via mattpocock /to-tickets), then invokes the chosen ecosystem's entry skill and stops. Never chains two ecosystems, never orchestrates post-handoff, never writes local state — the GitHub epic is the only state (resume = gh issue view <epic>).

/vault — Write-side knowledge operations for the OKF bundle: distills durable insights from a session (knowledge only — no session logs, no task tracking), ingests external documents, appends work-record lines to log.md, and always finishes by regenerating the index and passing okf_lint.py. Reading the vault is script-based (okf_cli.py) or via NotebookLM.

/notebooklm-vault — Bridges the OKF bundle with Google NotebookLM for synthesized cross-session recall. Sub-commands: setup, ask, session-continue (resumes from the log.md tail + the referenced GitHub epic), bootstrap, audio, report, conflict-check, status.

/ark-onboard — Interactive setup wizard converging a project onto the v2 conventions: OKF bundle init, GitHub-Issues label taxonomy + docs/agents/ conventions, mattpocock setup, and CLAUDE.md rows. Handles greenfield, migration, repair, and healthy states. Exempt from context-discovery.

/ark-health — Runs the v2 invariant checks across five areas (routing-destination ecosystems, the 6-skill roster, OKF conventions, GitHub-Issues conventions, NotebookLM recall) and produces a scored scorecard with fixes. No auto-fix — points to /ark-onboard for remediation. Exempt from context-discovery.

/ark-update — Version-driven migration framework. Converges downstream projects onto the current target profile; its v2.0.0 profile declares two pending migrations (OKF conversion + GitHub-Issues adoption), executed per-project later. Distinct from /ark-onboard repair (failure-driven).

Context-Discovery Pattern