From 15711cea451609d82c4214b3427469647f0b2caf Mon Sep 17 00:00:00 2001 From: "s.savinel" Date: Tue, 23 Jun 2026 21:18:36 +0200 Subject: [PATCH] setup-context-system: offer Superpowers install in Phase 4 --- README.md | 2 +- skills/setup-context-system/SKILL.md | 19 ++++++++++++++++++- 2 files changed, 19 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index fc0dc0f..73a1714 100644 --- a/README.md +++ b/README.md @@ -13,7 +13,7 @@ Skills follow the [Agent Skills](https://agentskills.io) open standard, so each Guides a person through building a **layered context system** for their agent — global/project/initiative context files, index files, knowledge management (Rules/Hypotheses), decision logging, tone rules, an optional discovery methodology, and a maintenance command that keeps it all current. It teaches the pattern and interviews the user for their own content; the result is their system, not a copy. -It runs in phases (essentials first), gating after each so a user can stop with a working system at any point. +It runs in phases (essentials first), gating after each so a user can stop with a working system at any point. Its final phase optionally offers to install [Superpowers](https://github.com/obra/superpowers) — obra's skills library that adds an automatic spec → plan → TDD workflow — as a process companion to this context layer. ## Installing a skill diff --git a/skills/setup-context-system/SKILL.md b/skills/setup-context-system/SKILL.md index 8f7acf8..f6a084f 100644 --- a/skills/setup-context-system/SKILL.md +++ b/skills/setup-context-system/SKILL.md @@ -1,6 +1,6 @@ --- name: setup-context-system -description: "Guide a person through building a layered AI context system for their coding agent: global/project/initiative context files, index files, knowledge management with Rules and Hypotheses, decision logging, tone and behavior rules, optional discovery methodology, and a maintenance command. Use when someone wants to set up CLAUDE.md / AGENTS.md context from scratch, stop re-explaining context every session, or replicate a self-maintaining context setup." +description: "Guide a person through building a layered AI context system for their coding agent: global/project/initiative context files, index files, knowledge management with Rules and Hypotheses, decision logging, tone and behavior rules, optional discovery methodology, a maintenance command, and an optional offer to install obra's Superpowers. Use when someone wants to set up CLAUDE.md / AGENTS.md context from scratch, stop re-explaining context every session, or replicate a self-maintaining context setup." compatibility: "claude-code, opencode" --- @@ -319,6 +319,22 @@ Draft the command file, preview, approve, write. Ask: "Do you run multi-step initiatives or projects that would benefit from a scaffolding command?" If yes, draft a `/create-initiative`-style command that interviews the user and creates an initiative folder with its own `CONTEXT_FILE`, overview file, and index entry. +### Step 4.4 — Optional: install Superpowers + +[Superpowers](https://github.com/obra/superpowers) (by obra) is a composable skills library that adds a development methodology — brainstorming → writing-plans → TDD → subagent-driven development — that triggers automatically. It complements this context system: this skill gives the agent *context*, Superpowers gives it *process*. + +First, **detect** whether it's already installed before offering: +- OpenCode → check for `~/.config/opencode/skills/` entries from superpowers (e.g., a `brainstorming` skill) or a superpowers plugin in `~/.config/opencode/`. +- Claude Code → check for a superpowers plugin/skills under `~/.claude/`. +- If already present, say so and skip. + +If not installed, ask: "Want to install Superpowers? It adds an automatic spec → plan → TDD workflow." If yes, give the install method for the **detected platform** (verify against the current Superpowers README — methods change; do not hardcode from memory): +- **Claude Code:** `/plugin install superpowers@claude-plugins-official` (official marketplace), or via `obra/superpowers-marketplace`. +- **OpenCode:** tell the agent: "Fetch and follow instructions from `https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md`". +- **Other platforms** (Codex, Cursor, Copilot CLI, Gemini CLI): point the user to the install section of the Superpowers README, since each differs. + +Do not run the install silently — present the command/instruction and let the user run it. This skill only *offers and points*; it does not modify the user's plugin setup without consent. + **Phase gate: confirm. System complete.** --- @@ -331,5 +347,6 @@ Summarize what was built and how to use it: 3. **Index files** — navigation to granular context. 4. **Knowledge / Decisions** — the learning layer; grows lazily. 5. **Maintenance command** — run it at the end of sessions to keep everything current. +6. **Superpowers** (if installed) — provides the development process layer alongside this context layer. Remind them: the system is meant to grow incrementally. Run the maintenance command regularly; add Knowledge and Decisions only when there's real content. Re-run this skill anytime to add a phase they skipped.