Skip to content

OpenCode: HTTP skills catalog for checkout-less installs - #238

Merged
st0nefish-ci[bot] merged 1 commit into
masterfrom
feat-skills-catalog
Nov 11, 2026
Merged

st0nefish-ci[bot] merged 1 commit into
masterfrom
feat-skills-catalog

Conversation

@St0nefish

Copy link
Copy Markdown
Owner

Follow-up to #237's install story. Plugins already install from GitHub (github:St0nefish/agent-toolkit#master::path:plugins-opencode/<name> — live-verified against 2.2.6), but OpenCode's skills config accepts only local dirs or HTTP catalogs, so machines without a checkout couldn't load the skills. This adds the repo-hosted catalog.

What ships

  • utils/skills-catalog.py — generates skills-catalog/ in the spec layout (index.json + <skill>/<files>), versions = content hashes so OpenCode's cache refreshes on any skill edit. --check mode mirrors sync.sh's drift culture. Hidden dirs / node_modules skipped; exec bits are irrelevant (all skills invoke bash scripts/...).
  • skills-catalog/ — the committed render: 7 skills, 21 files, byte-identical copies.
  • validate-opencode.sh check 8 — catalog freshness gate in CI (self-scoping so synthetic fixture trees skip it).
  • tests/opencode/test-skills-catalog.sh — 18 tests: generate, clean check, drift in all four directions (tampered / missing / stray / source-changed), version bumping, new-skill pickup, exclusion rules, committed-catalog byte-identity.
  • READMEs — no-checkout install snippets: plugins via git specs, skills via https://raw.githubusercontent.com/St0nefish/agent-toolkit/master/skills-catalog/.

Verification

  • Full suite green (993 + 18 new), validate-opencode 33 checks, shell lint, CI-parity, rumdl all pass.
  • GitHub plugin-spec install live-verified (both plugins load from ~/.cache/opencode/npm/git-agent-toolkit-*, all commands register). Catalog URL fetch will be smoke-tested against master right after merge.

OpenCode's skills config accepts local dirs or an HTTP catalog — no git
spec — so machines without an agent-toolkit checkout had no way to load
the OpenCode skills. skills-catalog/ is the repo-hosted answer, served
straight from raw.githubusercontent.com/master.

- utils/skills-catalog.py generates the spec layout (index.json with
  content-hash versions + <skill>/<files> tree) from the two OpenCode
  skill dirs; --check mode for CI, mirroring sync.sh's drift culture.
  Hidden dirs/node_modules skipped; exec bits irrelevant since every
  skill invokes scripts via 'bash scripts/...'.
- validate-opencode.sh gains check 8 (catalog freshness; self-scoping so
  synthetic fixture trees skip it).
- tests/opencode/test-skills-catalog.sh: 18 tests — generate, clean
  check, drift in all four directions (tampered/missing/stray/source
  change), version bumping, new-skill pickup, exclusion rules, and
  byte-identity of the committed catalog against its sources.
- READMEs document the no-checkout install: plugins via
  github:...::path: specs (live-verified against opencode 2.2.6) and
  skills via the catalog URL.
@st0nefish-ci
st0nefish-ci Bot enabled auto-merge November 11, 2026 00:49
@st0nefish-ci
st0nefish-ci Bot merged commit af0fa5d into master Nov 11, 2026
8 checks passed
@st0nefish-ci
st0nefish-ci Bot deleted the feat-skills-catalog branch November 11, 2026 00:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant