ππΌββοΈ The blackboard for coding agents - agentic development environment for claude code, codex, cursor, opencode, grok and more.
Rust adeai-agentsclaudeclaude-codecodexcursorgeminigrokopencodespec-driven-developmentvibe-codingvim
feat: add agent skills (#88)
Fynn Fluegge759af34940da
diff --git a/.claude/commands/add-plugin.md b/.claude/commands/add-plugin.mdnew file mode 100644index 0000000..49e195b--- /dev/null+++ b/.claude/commands/add-plugin.md@@ -0,0 +1,102 @@+---+description: Integrate a spec-driven/skill framework as a bundled agtx plugin. Pass a GitHub repo URL to auto-generate the plugin.toml, or run without arguments to write one from scratch.+---++# Add agtx Plugin++Integrate a spec-driven development framework or skill library as a bundled agtx plugin.++## Input++Optionally, a GitHub repository URL is provided as the argument (e.g. `https://github.com/org/repo`).+If no URL is given, ask the user which framework they want to integrate and gather the necessary details interactively.++## Steps++### 1. Gather information about the framework++**If a GitHub URL was provided**, use the GitHub CLI to inspect the repo:++```bash+gh repo view <owner>/<repo> --json name,description+gh api repos/<owner>/<repo>/git/trees/HEAD?recursive=1 | jq '[.tree[].path]'+gh api repos/<owner>/<repo>/contents/README.md | jq -r '.content' | base64 -d+```++**If no URL was provided**, ask the user:+- Framework name and slash command namespace (e.g. `gsd`, `opsx`)+- Which phases it covers and what commands it uses+- How it is installed (npm, git clone, shell script)+- Which agents it supports++In either case, look for:+- The slash command namespace and per-phase commands+- Installation method: npm package, clone-and-run library, or shell installer+- Agent compatibility: Claude-only (hooks/skills), multi-agent (npm flags), or prompt-only (all agents)+- Artifact files that signal phase completion+- Directories/files that need to be propagated to each worktree (`copy_dirs`, `copy_files`, `copy_back`)+- A one-time project setup step (`preresearch` + artifact)+- Interactive CLI prompts at startup that need `auto_dismiss` or `prompt_triggers`+- Multi-milestone iteration (`cyclic = true`)++### 2. Study existing bundled plugins as reference++Read `plugins/*/plugin.toml` and pick the closest analog to use as a starting point.++Key patterns:+- `init_script` with `--{agent}` placeholder when the tool has per-agent flags+- `copy_back` so artifacts produced in one worktree are visible to others+- `{task}` in a command or prompt β phase is accessible directly from Backlog; omit `{task}` β phase requires a prior artifact+- `cyclic = true` only when the framework supports multi-milestone iteration (Review β Planning loop)++### 3. Determine agent compatibility++| Signal | Compatible agents |+|--------|------------------|+| Only `.claude/commands/` skills or `.claude/hooks/` | `["claude"]` |+| npm package with `--codex` / `--gemini` flags | `["claude", "codex", "gemini", "opencode"]` |+| Pure prompt-based, no interactive skills | all agents (omit `supported_agents`) |++### 4. Write the plugin++Create `plugins/<name>/plugin.toml`. The full field reference is in the "Creating a Plugin" section of `README.md` β use it as the authoritative guide for every available field and its semantics.++Omit sections and fields that don't apply to this framework. Start minimal and add only what is needed.++### 5. Register it in `src/skills.rs`++Add an entry to `BUNDLED_PLUGINS`:++```rust+(+ "<name>",+ "<one-line description>",+ include_str!("../plugins/<name>/plugin.toml"),+),+```++### 6. Add agent compatibility row to README++In the plugin compatibility table in `README.md`, add a row for the new plugin showing which agents are supported (β / π‘ / β).++Also add a row to the plugin description table:++```markdown+| **<name>** | [<Framework Name>](<repo-url>) - <short description> |+```++### 7. Verify++```bash+cargo build 2>&1 | grep -E "error|warning"+```++Fix any compile errors (usually a missing comma in `BUNDLED_PLUGINS`).++## Output++Report what was created:+- Path to the generated `plugin.toml`+- The `src/skills.rs` entry added+- The README rows added+- Any ambiguities or fields left as TODOs that need manual reviewdiff --git a/README.md b/README.mdindex c168fec..d5ccbe0 100644--- a/README.md+++ b/README.md@@ -330,7 +330,7 @@ running = "codex"Plug any spec-driven framework into the task lifecycle. Define commands, prompts, and artifacts β agtx handles phase gating, artifact polling, worktree sync, agent switching, and autonomous execution.-Press `P` to switch plugins. Ships with 7 built-in:+Press `P` to switch plugins. Ships with 9 built-in:| Plugin | Description ||--------|-------------|@@ -342,6 +342,7 @@ Press `P` to switch plugins. Ships with 7 built-in:| **bmad** | [BMAD Method](https://github.com/bmad-code-org/BMAD-METHOD) - AI-driven agile development with structured phases || **superpowers** | [Superpowers](https://github.com/obra/superpowers) - brainstorming, plans, TDD, subagent-driven development || **oh-my-claudecode** | [oh-my-claudecode](https://github.com/Yeachan-Heo/oh-my-claudecode) - multi-agent orchestration with 37 skills and 22 specialized agents |+| **agent-skills** | [Agent Skills](https://github.com/addyosmani/agent-skills) - production-grade engineering skills covering the full spec-to-ship lifecycle |### Agent Compatibility@@ -360,6 +361,7 @@ Commands are written once in canonical format and automatically translated per a| **bmad** | β | β | β | β | β | π‘ || **superpowers** | β | β | β | β | β | β || **oh-my-claudecode** | β | β | β | β | β | β |+| **agent-skills** | β | π‘ | π‘ | π‘ | π‘ | π‘ || **void** | β | β | β | β | β | β |β Skills, commands, and prompts fully supported Β· π‘ Prompt only, no interactive skill support Β· β Not supported@@ -367,6 +369,9 @@ Commands are written once in canonical format and automatically translated per a<details><summary><b>Creating a Plugin</b></summary>+> [!TIP]+> If you have the agtx repo open in Claude Code, run `/add-plugin <github-url>` to automatically generate a bundled `plugin.toml` from any spec-driven framework repo β including wiring up `src/skills.rs` and the README tables.+Place your plugin at `.agtx/plugins/<name>/plugin.toml` in your project root (or `~/.config/agtx/plugins/<name>/plugin.toml` for global use). It will appear in the plugin selector automatically.**Minimal example** β a plugin that uses custom slash commands:diff --git a/plugins/agent-skills/plugin.toml b/plugins/agent-skills/plugin.tomlnew file mode 100644index 0000000..6691c6e--- /dev/null+++ b/plugins/agent-skills/plugin.toml@@ -0,0 +1,18 @@+name = "agent-skills"+description = "Agent Skills by Addy Osmani - production-grade engineering skills covering the full spec-to-ship lifecycle"+# Claude: /plugin marketplace add addyosmani/agent-skills+# then: /plugin install agent-skills@addy-agent-skills+# Other agents: clone https://github.com/addyosmani/agent-skills and follow docs/ setup guides+init_script = "[ \"{agent}\" = \"claude\" ] && (claude plugin marketplace add addyosmani/agent-skills 2>/dev/null; claude plugin install agent-skills@addy-agent-skills --scope local 2>/dev/null) || true"++[commands]+research = "/spec"+planning = "/plan"+running = "/build"+review = "/review"++[prompts]+research = "{task}"+planning = "{task}"+running = "Implement the plan. Use /test to verify as you go and /ship when ready."+review = "Review the completed work using /review, then run /ship to prepare for production."diff --git a/src/skills.rs b/src/skills.rsindex cfc520a..a2e5c4d 100644--- a/src/skills.rs+++ b/src/skills.rs@@ -181,6 +181,11 @@ pub const BUNDLED_PLUGINS: &[(&str, &str, &str)] = &["oh-my-claudecode - Multi-agent orchestration",include_str!("../plugins/oh-my-claudecode/plugin.toml"),),+ (+ "agent-skills",+ "Agent Skills - production-grade engineering skills for the full spec-to-ship lifecycle",+ include_str!("../plugins/agent-skills/plugin.toml"),+ ),];/// Extract the description from YAML frontmatter.diff --git a/src/tui/app_tests.rs b/src/tui/app_tests.rsindex e3a8f4d..b46684e 100644--- a/src/tui/app_tests.rs+++ b/src/tui/app_tests.rs@@ -2400,7 +2400,8 @@ fn test_bundled_plugins_list() {assert!(names.contains(&"bmad"));assert!(names.contains(&"superpowers"));assert!(names.contains(&"oh-my-claudecode"));- assert_eq!(names.len(), 8);+ assert!(names.contains(&"agent-skills"));+ assert_eq!(names.len(), 9);}#[test]