convez.ai
Skill
vr000m

skein

vr000m/skein

Ver no GitHub
InicialPluginScore · de 0 a 100

skein: namespaced skill plugin (Claude + Codex)

Instalação

$npx convez-ai vr000m/skein

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
4
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 2 dias
Versão
v0.12.0
Issues abertas
1
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

skein

Namespaced skill plugin for Claude Code and OpenAI Codex CLI agents. All skills load under the skein: namespace (skein:dev-plan, skein:plan-view, etc.) to avoid collisions with third-party skills.

Skills

SkillClaudeCodexDescription
dev-planYesYesGenerate and manage development plans; create runs one fresh-context Explore subagent that gathers verified paths, patterns, dependency versions, and git refs before drafting
fan-outYesYesParallel agent orchestration via worktrees
content-draftYesYesDraft content following style guidelines
content-reviewYesYesReview content against style guidelines
deep-reviewYesYesMulti-lens code review with fresh-context subagents; reconciles findings by structural signature. Opt-in --auto-fix=trivial applies a hard-coded allowlist of mechanical fixes (requires --test-cmd)
review-planYesYesAudit a dev plan via five parallel fresh-context lenses (architecture, sequencing, spec-and-testing, assumptions, codebase-claims; four high-reasoning + one factual) before implementation; reconciles findings by structural signature. Opt-in --auto-fix=trivial applies allowlisted prose edits outside the immutable contract sections
rfc-finderYesYesFind and link to IETF RFCs and related drafts
spec-complianceYesYesCheck code against RFC/W3C/WHATWG requirements
update-docsYesYesAudit and update stale docs against branch diffs
conductYesYesWalk a reviewed dev plan phase by phase via harness-native clean-context subagents
plan-viewYesYesGenerate HTML dashboard and per-plan drill-down pages from a markdown dev-plan corpus; --rich mode produces LLM-rendered per-plan views constrained by a widget toolkit; deterministic and rich pages are cross-linked bidirectionally (forward links emitted unconditionally, back-links injected by relink_rich_pages() on every plain run)

Invoke each skill as skein:<name> (e.g. skein:dev-plan, skein:review-plan).

Plugin install

Install through the harness plugin CLI on each machine. There are no rsync, promote, or bootstrap scripts — the marketplace files in this repo are the install surface. Both harnesses can install directly from GitHub; no clone required.

Claude Code:

/plugin marketplace add vr000m/skein
/plugin install skein@skein

Codex CLI:

codex plugin marketplace add vr000m/skein --ref main
codex plugin add skein@skein

The marketplace name skein matches the entries in .claude-plugin/marketplace.json (Claude) and .agents/plugins/marketplace.json (Codex). To pick up upstream changes, re-add the marketplace (or git pull your clone if you installed from a local path) and re-run /plugin install skein@skein / codex plugin add skein@skein — there is no separate sync step.

Pinning to a release. Once tagged releases exist (the first will be v0.1.0, cut after this install switch merges), prefer pinning over tracking main: pass --ref v0.1.0 to codex plugin marketplace add, and check tagged releases on the GitHub releases page for Claude Code (which resolves the marketplace at add time). Tracking main follows unreleased commits.

If you are developing against a local clone instead, swap the marketplace source for a path: /plugin marketplace add /path/to/skein (Claude) or codex plugin marketplace add /path/to/skein (Codex).

If you are migrating from the older flat layout (skills installed directly under ~/.claude/skills/ and ~/.codex/skills/), use scripts/delete-skills.sh to remove the pre-plugin copies after verifying the plugin install loads correctly.

Releases

skein follows Semantic Versioning; changes are recorded in CHANGELOG.md in Keep a Changelog format.

The first tagged release will be v0.1.0, cut from main immediately after the public-GitHub install switch merges. Until then, all install instructions above resolve against main. Tagged releases are published on the GitHub releases page.

Setup (for contributors)

  1. Install tools:
brew install just jq shellcheck shfmt
  1. Repo invariants worth running before pushing:
just check-sync                  # canonical scripts/ ↔ bundled skill scripts byte-identity
just check-prompt-parity         # Claude vs Codex SKILL.md content parity for bundle skills
just check-trunk-snippet-parity  # trunk-resolution snippet parity
just parity-tests                # bundle + allowlist + orchestration-contract + no-fallback + marker parity (conduct + canonical anchor + review-plan marker write)
just reconciliation-tests        # reconciliation parity + fixture + renderer + determinism
just bundle-appliers             # regenerate bundled auto-fix pipeline inside each skill

Layout

plugins/skein/skills/<name>/         Claude skills (SKILL.md per skill)
plugins/skein-codex/skills/<name>/   Codex skills (mirrored structure; per-harness dispatch idiom)
.claude-plugin/marketplace.json      Claude marketplace entry for skein
.agents/plugins/marketplace.json     Codex marketplace entry for skein
scripts/                             Canonical shell scripts (bundle/check/reconcile/parity/render/auto-fix)

See AGENTS.md for commands, architecture, authority model, and contributor workflow.

Ver o original no GitHub

Bom para

Relacionados