agkit 0.7.0

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "agkit",
+  "version": "0.7.0",
+  "description": "Scaffold and manage plugin marketplaces for Claude Code and GitHub Copilot, distributed via any Git host (GitHub, GitLab, Bitbucket, Gitea, self-hosted). Init, add plugins from built-in or remote templates, sync, validate, bump.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "agkit": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "github-copilot",
+    "copilot",
+    "plugin",
+    "marketplace",
+    "scaffold",
+    "cli",
+    "generator",
+    "agentic"
+  ],
+  "dependencies": {
+    "@clack/prompts": "^0.11.0",
+    "commander": "^14.0.0",
+    "picocolors": "^1.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.6.0"
+  }
+}

package/templates/marketplace/README.md.tpl

@@ -0,0 +1,32 @@
+# {{marketplaceName}}
+
+{{description}}
+
+A [plugin marketplace](https://code.claude.com/docs/en/plugin-marketplaces): a Git repository whose `.claude-plugin/marketplace.json` catalog is consumed by AI coding agents. Works from any Git host.
+
+## Install
+
+{{installSections}}
+
+## Team setup (automatic installation)
+
+{{teamSections}}
+
+## Available plugins
+
+<!-- agkit:plugins:start -->
+_No plugins yet. Add one with `agkit add <template> <name>`._
+<!-- agkit:plugins:end -->
+
+## Development
+
+This marketplace is managed with [agkit](https://www.npmjs.com/package/agkit):
+
+```bash
+agkit add skill my-skill      # scaffold a new plugin from a template
+agkit sync                    # reconcile marketplace.json with plugins/
+agkit validate                # check the catalog before pushing
+agkit bump my-skill --tag     # version a plugin from conventional commits
+```
+
+The catalog lives in `.claude-plugin/marketplace.json`; each plugin lives in `plugins/<name>/` with its own `.claude-plugin/plugin.json` manifest. Target agents are recorded in `metadata.targets`.

package/templates/marketplace/github-validate.yml.tpl

@@ -0,0 +1,19 @@
+name: Validate marketplace
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+      - name: Validate catalog
+        run: npx --yes agkit validate
+      - name: Check tier-2 artifacts are fresh
+        run: npx --yes agkit build --check

package/templates/marketplace/gitlab-ci.yml.tpl

@@ -0,0 +1,8 @@
+validate-marketplace:
+  image: node:22
+  rules:
+    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
+    - if: '$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH'
+  script:
+    - npx --yes agkit validate
+    - npx --yes agkit build --check

package/templates/marketplace/team-settings.json.tpl

@@ -0,0 +1,7 @@
+{
+  "extraKnownMarketplaces": {
+    "{{marketplaceName}}": {
+      "source": {{teamSource}}
+    }
+  }
+}

package/templates/plugins/agent/.claude-plugin/plugin.json.tpl

@@ -0,0 +1,8 @@
+{
+  "name": "{{pluginName}}",
+  "version": "0.1.0",
+  "description": "{{description}}",
+  "author": {
+    "name": "{{authorName}}"
+  }
+}

package/templates/plugins/agent/agents/{{pluginName}}.md.tpl

@@ -0,0 +1,20 @@
+---
+name: {{pluginName}}
+description: {{description}} Use this agent when... (Claude reads this to decide when to delegate to it.)
+---
+
+You are {{pluginTitle}}, a specialist subagent.
+
+## Role
+
+Describe the agent's expertise and scope. Be specific: a narrow, well-defined
+role outperforms a generalist description.
+
+## Process
+
+1. How the agent should approach a task.
+2. What it must verify before answering.
+
+## Output
+
+Describe the structure and tone of the agent's responses.

package/templates/plugins/command/.claude-plugin/plugin.json.tpl

@@ -0,0 +1,8 @@
+{
+  "name": "{{pluginName}}",
+  "version": "0.1.0",
+  "description": "{{description}}",
+  "author": {
+    "name": "{{authorName}}"
+  }
+}

package/templates/plugins/command/commands/{{pluginName}}.md.tpl

@@ -0,0 +1,15 @@
+---
+description: {{description}}
+argument-hint: [target]
+---
+
+# {{pluginTitle}}
+
+You are executing the /{{pluginName}} command. The user invoked it with:
+$ARGUMENTS
+
+## Instructions
+
+1. Describe precisely what Claude must do when this command runs.
+2. Reference $ARGUMENTS wherever the user input matters.
+3. State the expected output format.

package/templates/plugins/hook/.claude-plugin/plugin.json.tpl

@@ -0,0 +1,8 @@
+{
+  "name": "{{pluginName}}",
+  "version": "0.1.0",
+  "description": "{{description}}",
+  "author": {
+    "name": "{{authorName}}"
+  }
+}

package/templates/plugins/hook/hooks/hooks.json.tpl

@@ -0,0 +1,15 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"${CLAUDE_PLUGIN_ROOT}\"/scripts/{{pluginName}}.sh"
+          }
+        ]
+      }
+    ]
+  }
+}

package/templates/plugins/hook/scripts/{{pluginName}}.sh.tpl

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+# {{pluginTitle}} — PostToolUse hook (fires after Write|Edit succeeds).
+# Claude Code pipes the event JSON on stdin. Exit 0 = OK; exit 2 = block
+# with feedback (stderr is shown to Claude). Other events: PreToolUse,
+# UserPromptSubmit, SessionStart, Stop... (see hooks reference).
+set -euo pipefail
+
+input=$(cat)
+file_path=$(printf '%s' "$input" | grep -o '"file_path"[^,}]*' | head -1 | cut -d'"' -f4 || true)
+
+# TODO: implement your check. Example: fail if a TODO marker slips in.
+# if [ -n "$file_path" ] && grep -q "DO-NOT-COMMIT" "$file_path"; then
+#   echo "Blocked: $file_path contains DO-NOT-COMMIT" >&2
+#   exit 2
+# fi
+
+exit 0

package/templates/plugins/mcp/.claude-plugin/plugin.json.tpl

@@ -0,0 +1,8 @@
+{
+  "name": "{{pluginName}}",
+  "version": "0.1.0",
+  "description": "{{description}}",
+  "author": {
+    "name": "{{authorName}}"
+  }
+}

package/templates/plugins/mcp/.mcp.json.tpl

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "{{pluginName}}": {
+      "command": "node",
+      "args": ["${CLAUDE_PLUGIN_ROOT}/servers/{{pluginName}}.mjs"]
+    }
+  }
+}

package/templates/plugins/mcp/servers/{{pluginName}}.mjs.tpl

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+/**
+ * {{pluginTitle}} — minimal MCP stdio server, zero dependencies.
+ * Implements just enough JSON-RPC for Claude Code: initialize,
+ * tools/list, tools/call. Replace the example tool with your own,
+ * or migrate to @modelcontextprotocol/sdk when it grows.
+ */
+import { createInterface } from "node:readline";
+
+const TOOLS = [
+  {
+    name: "{{pluginName}}_echo",
+    description: "Example tool: echoes the provided text back. Replace me.",
+    inputSchema: {
+      type: "object",
+      properties: { text: { type: "string", description: "Text to echo" } },
+      required: ["text"],
+    },
+  },
+];
+
+async function callTool(name, args) {
+  switch (name) {
+    case "{{pluginName}}_echo":
+      return { content: [{ type: "text", text: `Echo: ${args.text}` }] };
+    default:
+      throw new Error(`Unknown tool: ${name}`);
+  }
+}
+
+const send = (msg) => process.stdout.write(JSON.stringify(msg) + "\n");
+
+createInterface({ input: process.stdin }).on("line", async (line) => {
+  if (!line.trim()) return;
+  let req;
+  try { req = JSON.parse(line); } catch { return; }
+  const { id, method, params } = req;
+  try {
+    if (method === "initialize") {
+      send({ jsonrpc: "2.0", id, result: {
+        protocolVersion: params?.protocolVersion ?? "2025-06-18",
+        capabilities: { tools: {} },
+        serverInfo: { name: "{{pluginName}}", version: "0.1.0" },
+      }});
+    } else if (method === "notifications/initialized") {
+      // notification: no response
+    } else if (method === "tools/list") {
+      send({ jsonrpc: "2.0", id, result: { tools: TOOLS } });
+    } else if (method === "tools/call") {
+      const result = await callTool(params.name, params.arguments ?? {});
+      send({ jsonrpc: "2.0", id, result });
+    } else if (id !== undefined) {
+      send({ jsonrpc: "2.0", id, error: { code: -32601, message: `Method not found: ${method}` } });
+    }
+  } catch (err) {
+    if (id !== undefined) {
+      send({ jsonrpc: "2.0", id, error: { code: -32000, message: String(err?.message ?? err) } });
+    }
+  }
+});

package/templates/plugins/skill/.claude-plugin/plugin.json.tpl

@@ -0,0 +1,8 @@
+{
+  "name": "{{pluginName}}",
+  "version": "0.1.0",
+  "description": "{{description}}",
+  "author": {
+    "name": "{{authorName}}"
+  }
+}

package/templates/plugins/skill/skills/{{pluginName}}/SKILL.md.tpl

@@ -0,0 +1,23 @@
+---
+name: {{pluginName}}
+description: "{{description}} Describe here WHEN Claude should load this skill: trigger words, file types, or situations. This description is what Claude reads to decide whether the skill is relevant."
+---
+
+# {{pluginTitle}}
+
+Explain the knowledge or procedure this skill provides. Claude loads this
+file on demand, so write it as instructions to a competent colleague.
+
+## When to use
+
+- Situation 1
+- Situation 2
+
+## Instructions
+
+1. Step one
+2. Step two
+
+## Examples
+
+Provide at least one concrete example of correct application.