skilldrop-cli 0.7.0 → 0.8.0

package/README.md

@@ -293,13 +293,14 @@ Four targets, each projecting only as much as the tool's format demands:
 | `--ide copilot` | `.github/agents/<name>.agent.md` | a rename |
 | `--ide kiro` | `.kiro/agents/<name>.json` | generated JSON; tool names mapped to Kiro's built-ins |
 | `--ide codex` | `~/.codex/agents/<name>.toml` (`--project` for repo) | generated TOML |
+| `--ide antigravity` | `~/.gemini/config/agents/<name>.md` (`--project` → `.agents/agents/`) | frontmatter rewritten, `subagent: true` added |
 | `--dest <dir>` | `<dir>/<name>.md` | none |
 
 The Kiro emitter maps `Read`/`Grep`/`Glob`/`Bash` to `read`/`grep`/`glob`/`shell` against [Kiro's built-in tool reference](https://kiro.dev/docs/cli/reference/built-in-tools/), and **names any tool it can't map instead of dropping it silently** — a mistranslated permission is worse than a missing one. It omits `allowedTools` so you're prompted per tool call.
 
 Each generated target omits the permission field it cannot map safely rather than guessing one: Kiro's `allowedTools` and Codex's `sandbox_mode` are both left unset, so an agent inherits the session's permissions and is prompted per call. A widened permission nobody asked for is worse than an extra prompt.
 
-Only **Antigravity** still refuses — its subagents exist solely inside a plugin bundle, which is a container rather than a file drop. Design is worked out in [RFC-0013](docs/rfcs/0013-antigravity-plugin-bundle.md), unimplemented pending demand. [`agents/README.md`](agents/README.md) has the manual route.
+**Every surveyed tool now installs.** Only Cursor is absent, because it has no agent file format at all — use a custom mode ([`agents/README.md`](agents/README.md) has the steps).
 
 ### Third-party catalogs — publish your own skills through the same CLI
 

package/agents/README.md

@@ -4,7 +4,17 @@ Portable **reviewer agents** — opinionated personas you delegate code and test
 
 The frontmatter makes the file a drop-in **Claude Code subagent**. The body is plain enough to paste into any other tool's agent / mode / system-prompt slot.
 
-Nothing auto-discovers *this* folder at the repo root, so it is the **canonical source of truth** and the table below says where to copy each file. That framing used to be simpler: as of the [July 2026 survey](../docs/designs/ide-primitive-coverage.md), **five tools have a native subagent format** — Claude Code, Kiro, Codex, Copilot, and Antigravity, which registers subagents from a directory literally named `agents/` inside a plugin bundle. The CLI does not install agents into any of them yet ([RFC-0010](../docs/rfcs/0010-install-target-table.md) has to settle the projection model first), so copying by hand remains the route.
+Nothing auto-discovers *this* folder at the repo root, so it is the **canonical source of truth**. As of the [July 2026 survey](../docs/designs/ide-primitive-coverage.md), **five tools have a native subagent format** — Claude Code, Kiro, Codex, Copilot, and Antigravity, which registers subagents from a directory literally named `agents/` inside a plugin bundle.
+
+**The CLI installs into four of them** ([RFC-0012](../docs/rfcs/0012-subagent-installation.md)):
+
+```bash
+npx skilldrop-cli agents                                       # list
+npx skilldrop-cli install --agent devils-advocate              # ~/.claude/agents/
+npx skilldrop-cli install --agent devils-advocate --ide kiro   # .kiro/agents/*.json
+```
+
+**Five of the five tools with a native format now install by command** — Claude Code, Kiro, Codex, Copilot, and Antigravity. Only Cursor needs hand-work, because it has no agent file format at all. Each section below gives the command where one exists, and the manual route either way.
 
 ## The agents
 
@@ -48,28 +58,36 @@ Standalone TOML in `~/.codex/agents/` or `.codex/agents/` (`--project`). Codex r
 
 ### Kiro (native custom agents)
 
-Kiro reads JSON agent definitions from `.kiro/agents/` (local) or `~/.kiro/agents/` (global). The filename minus `.json` becomes the agent's name.
+```bash
+npx skilldrop-cli install --agent devils-advocate --ide kiro   # .kiro/agents/<name>.json
+```
 
-Its `prompt` field accepts a **`file://` URI**, so the definition can point at the markdown instead of duplicating it — the cleanest projection of any tool surveyed:
+Kiro reads JSON agent definitions from `.kiro/agents/` (local) or `~/.kiro/agents/` (global). The emitter maps Claude Code tool names to [Kiro's built-ins](https://kiro.dev/docs/cli/reference/built-in-tools/) — `Read`/`Grep`/`Glob`/`Bash` → `read`/`grep`/`glob`/`shell` — and **names any tool it cannot map** rather than dropping it silently.
 
-```json
-{
-  "name": "devils-advocate",
-  "description": "<paste the description from the agent's frontmatter>",
-  "prompt": "file://./agents/devils-advocate.md",
-  "tools": ["read", "grep", "execute"]
-}
-```
+Two choices worth knowing if you hand-write one instead:
+
+- **The prompt is inlined, not a `file://` reference.** Kiro's docs show a relative `file://` path but do not say whether it resolves against the workspace root or the JSON file, and a wrong path fails *silently* — the agent loads with no instructions.
+- **`allowedTools` is omitted**, so you are prompted per tool call. That is the right default for a reviewer, and it avoids [kirodotdev/Kiro#6714](https://github.com/kirodotdev/Kiro/issues/6714), where the field does not load as configured.
 
 **Don't use a steering file for this.** Earlier advice here said to drop the agent at `.kiro/steering/<agent>.md`; a steering file with no inclusion mode is loaded into *every* session, which is a permanent context cost for a persona you want on demand. Same reason the CLI stopped writing steering shims for skills.
 
 ### GitHub Copilot (native custom agents)
 
-Copilot reads `.github/agents/<name>.agent.md` (repo) or `~/.copilot/agents/` (personal). The filename minus `.agent.md` is the invocation name — `copilot --agent devils-advocate`. Copy the file in and rename it; the frontmatter needs `name` and `description`, and takes an optional `tools` list.
+```bash
+npx skilldrop-cli install --agent devils-advocate --ide copilot   # .github/agents/<name>.agent.md
+```
+
+Copilot reads `.github/agents/<name>.agent.md` (repo) or `~/.copilot/agents/` (personal). The filename minus `.agent.md` is the invocation name — `copilot --agent devils-advocate`. The install is a pure rename; nothing in the file changes.
 
 ### Antigravity CLI (plugin subagents)
 
-Antigravity registers subagent templates from an `agents/` directory **inside a plugin bundle** at `~/.gemini/antigravity-cli/plugins/<plugin>/agents/`. There is no project-root `agents/` convention, so this is a copy into a bundle you own, not a drop-in.
+```bash
+npx skilldrop-cli install --agent devils-advocate --ide antigravity   # ~/.gemini/config/agents/
+```
+
+Antigravity discovers subagents at `~/.gemini/config/agents/<name>.md` (global) or `.agents/agents/<name>.md` (workspace, `--project`) — markdown with YAML frontmatter, same shape as these files. A plugin bundle is a *third* option, not a requirement; [RFC-0013](../docs/rfcs/0013-antigravity-plugin-bundle.md) records why an earlier draft wrongly thought it was the only one.
+
+The emitter adds **`subagent: true`** — without it the agent exists but `invoke_subagent` cannot reach it — and maps `Read`/`Grep`/`Bash` to `view_file`/`grep_search`/`run_command`. Antigravity has no glob-style tool, so `Glob` is named and dropped rather than bent into `list_dir`.
 
 ### Continue, Cline, Aider, and other tools
 

package/bin/skilldrop.js

@@ -54,8 +54,9 @@ Options:
                        --ide kiro     ./.kiro/agents        generated JSON, tools mapped
                        --ide copilot  ./.github/agents      <name>.agent.md
                        --ide codex    ~/.codex/agents       generated TOML (--project for repo)
+                       --ide antigravity  ~/.gemini/config/agents  markdown, subagent: true
                        --dest <dir>   any directory         copied as-is
-                     Antigravity needs a plugin bundle (RFC-0013) — see agents/README.md.
+                     Cursor has no agent format — use a custom mode (agents/README.md).
   --with-related     also install each skill's related companions (one level)
   --with-hooks       also wire any hooks a skill declares (RFC-0006) — git pre-commit
                      reminders and Claude Code session-start context; degrades where the
@@ -202,6 +203,26 @@ function kiroAgentJSON(meta, body) {
   return { json: JSON.stringify(agent, null, 2) + "\n", unmapped: [...new Set(unmapped)] };
 }
 
+/* Antigravity agent markdown (RFC-0013). Only mappings confirmed in Antigravity's own
+   subagents doc are listed. There is no glob-style tool in its file tooling
+   (view_file / list_dir / grep_search / write_to_file), so Glob is dropped and named
+   rather than bent into list_dir — a different operation. */
+const ANTIGRAVITY_TOOLS = { Read: "view_file", Grep: "grep_search", Bash: "run_command" };
+const ANTIGRAVITY_MODELS = new Set(["inherit", "flash", "pro"]);
+
+function antigravityAgentMD(meta, body) {
+  const declared = meta.tools ? meta.tools.split(",").map((s) => s.trim()).filter(Boolean) : [];
+  const tools = [], unmapped = [];
+  for (const d of declared) (ANTIGRAVITY_TOOLS[d] ? tools : unmapped).push(ANTIGRAVITY_TOOLS[d] || d);
+  // YAML double-quoted scalars are a superset of JSON strings, so JSON.stringify is a
+  // correct quoter here — descriptions contain em-dashes and embedded quotes.
+  const lines = [`name: ${JSON.stringify(meta.name)}`, `description: ${JSON.stringify(meta.description)}`];
+  if (tools.length) lines.push(`tools: [${tools.join(", ")}]`);
+  lines.push("subagent: true"); // required, or invoke_subagent cannot reach it
+  if (ANTIGRAVITY_MODELS.has(meta.model)) lines.push(`model: ${meta.model}`);
+  return { md: `---\n${lines.join("\n")}\n---\n\n${body}\n`, unmapped: [...new Set(unmapped)] };
+}
+
 /* Codex agent TOML. Schema confirmed at learn.chatgpt.com/docs/agent-configuration/subagents:
    name, description and developer_instructions are required; unknown fields are rejected.
    sandbox_mode is deliberately NOT emitted — Codex has no `tools` field, permissions come
@@ -219,7 +240,6 @@ function codexAgentTOML(meta, body) {
 /* Only plain-copy targets ship in RFC-0012. Everything else needs a projection the
    install-target model (RFC-0010) has not settled — so say so instead of guessing a path. */
 const AGENT_MANUAL = {
-  antigravity: "an agents/ directory inside a plugin bundle you own — see RFC-0013",
   cursor: "a custom mode — Cursor has no agent file format",
 };
 function agentTarget(flags) {
@@ -236,6 +256,10 @@ function agentTarget(flags) {
     return flags.project
       ? { dest: path.resolve(".codex", "agents"), ide }
       : { dest: path.join(os.homedir(), ".codex", "agents"), ide };
+  if (ide === "antigravity")
+    return flags.project
+      ? { dest: path.resolve(".agents", "agents"), ide }
+      : { dest: path.join(os.homedir(), ".gemini", "config", "agents"), ide };
   const hint = AGENT_MANUAL[ide];
   die(`--agent has no target for '${ide}'${hint ? ` — it needs ${hint}` : ""}.\n` +
       `       Copy it by hand (see agents/README.md), or use --dest <dir>. Tracked in RFC-0012.`);
@@ -254,6 +278,15 @@ function writeAgent(cat, a, dest, ide) {
       ? `  ${a}: no Kiro equivalent for ${unmapped.join(", ")} — dropped from tools, add by hand if needed`
       : null };
   }
+  if (ide === "antigravity") {
+    const raw = fs.readFileSync(src, "utf8");
+    const body = raw.split("---").slice(2).join("---").trim();
+    const { md, unmapped } = antigravityAgentMD(agentMeta(cat, a), body);
+    fs.writeFileSync(path.join(dest, `${a}.md`), md);
+    return { file: `${a}.md`, warn: unmapped.length
+      ? `  ${a}: no Antigravity equivalent for ${unmapped.join(", ")} — dropped from tools, add by hand if needed`
+      : null };
+  }
   if (ide === "codex") {
     const raw = fs.readFileSync(src, "utf8");
     const body = raw.split("---").slice(2).join("---").trim();
@@ -585,6 +618,7 @@ function installAgents(args) {
   if (ide === "kiro") console.log("Kiro grants `tools` but not auto-approval — you are prompted per call by design.");
   if (ide === "copilot") console.log("Invoke with: copilot --agent <name>");
   if (ide === "codex") console.log("sandbox_mode is left unset, so each agent inherits the parent session's permissions.");
+  if (ide === "antigravity") console.log("Emitted with `subagent: true` so invoke_subagent can reach them.");
   if (cat.source !== BUNDLED)
     console.log(`\nWARNING: third-party catalog '${cat.source}'. An agent is a system prompt your tool will adopt — read it before first use. Install copied files only; nothing was executed.`);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skilldrop-cli",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Portable AI-agent skills for the deliverables knowledge workers ship \u2014 diagrams, ADRs, PRDs, runbooks, decks, reviews \u2014 installable into Claude Code, Cursor, Kiro, and any IDE that takes custom instructions. One command per skill or per role-based pack.",
   "bin": {
     "skilldrop": "bin/skilldrop.js"