Skip to content

armgit / agtx

Public Imported from GitHub
0

πŸ„πŸΌβ€β™‚οΈ The blackboard for coding agents - agentic development environment for claude code, codex, cursor, opencode, grok and more.

feat: add agent skills (#88)

Fynn Fluegge759af34940da
diff --git a/.claude/commands/add-plugin.md b/.claude/commands/add-plugin.md
new file mode 100644
index 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 review
diff --git a/README.md b/README.md
index 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.toml
new file mode 100644
index 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.rs
index 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.rs
index 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]