Use when checking for updates from upstream tool repos (beads, oracle, superpowers, compound-engineering) or when the /clavain:upstream-sync command is invoked
From clavainnpx claudepluginhub mistakeknot/interagency-marketplace --plugin clavainThis skill uses the workspace's default tool permissions.
SKILL-compact.mdSearches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Searches prompts.chat for AI prompt templates by keyword or category, retrieves by ID with variable handling, and improves prompts via AI. Use for discovering or enhancing prompts.
Compares coding agents like Claude Code and Aider on custom YAML-defined codebase tasks using git worktrees, measuring pass rate, cost, time, and consistency.
Clavain bundles knowledge from upstream tools. This skill tracks their releases and updates affected skills.
| Tool | Repo | Clavain Skills Affected |
|---|---|---|
| Beads | steveyegge/beads | interphase companion plugin |
| Oracle | steipete/oracle | interpeer, prompterpeer, winterpeer, splinterpeer |
| superpowers | obra/superpowers | Multiple (founding source) |
| superpowers-lab | obra/superpowers-lab | using-tmux-for-interactive-commands |
| superpowers-dev | obra/superpowers-developing-for-claude-code | developing-claude-code-plugins, working-with-claude-code |
| compound-engineering | EveryInc/compound-engineering-plugin | Multiple (founding source) |
.github/workflows/upstream-check.yml runs daily at 08:00 UTC — runs scripts/upstream-check.sh --json, compares against docs/upstream-versions.json, opens/updates a GitHub issue (label upstream-sync) if changes detected. No manual action needed.
hooks/session-start.sh checks age of docs/upstream-versions.json on every session. If >7 days old, injects: "Upstream sync stale (N days). Run /clavain:upstream-sync."
/clavain:upstream-sync CommandPreferred path (issues exist):
gh issue list — fetch open upstream-sync issuesbash scripts/upstream-check.sh --update — update baselineManual fallback (no issues): bash scripts/upstream-check.sh directly, then remediate.
Two PR workflows:
.github/workflows/upstream-impact.yml — posts impact summaries.github/workflows/upstream-decision-gate.yml — blocks merge until decision record completeRequired: docs/upstream-decisions/pr-<PR_NUMBER>.md (template at docs/templates/upstream-decision-record.md) with Gate: approved, no TBD, explicit per-upstream decisions (adopt-now/defer/ignore).
For each repo with new activity, check:
# Check changelog
gh api repos/{owner}/{repo}/contents/CHANGELOG.md --jq '.content' | base64 -d | head -100
# Check recent README commits
gh api "repos/{owner}/{repo}/commits?path=README.md&per_page=3" \
--jq '.[] | .sha[:7] + " " + (.commit.message | split("\n")[0])'
For each breaking change: read the skill → make minimal edit → verify no phantom references (flags/tools that no longer exist).
After all edits: bash scripts/upstream-check.sh --update
docs/upstream-versions.json:
{
"steveyegge/beads": {
"synced_release": "v0.49.4",
"synced_commit": "eb1049b",
"checked_at": "2026-02-06T20:26:55Z"
}
}