feat: add CLI emitter + self-as-skills — v0.4.0

Two new features for the agent-native vision:

1. CLI Emitter (-f cli): generates a standalone Commander.js CLI
   tool from any OpenAPI spec. Each endpoint becomes a command
   with proper positional args, flags, and type coercion.

2. Self-as-Skills: Agentify now ships self-description files
   (self/skills.json, self/CLAUDE.md, self/AGENTS.md) so agents
   can discover and use Agentify autonomously. New `self-describe`
   CLI command copies these files to any directory.

- 9 output formats total (8 default + cli opt-in)
- 133 tests passing across 9 test files
- npm: agentify-cli@0.4.0 published with self/ included

Author: koriyoshi2041

README.md

@@ -14,7 +14,7 @@
 
 ---
 
-Agentify compiles any OpenAPI specification into **8 agent interface formats** — MCP Server, CLAUDE.md, AGENTS.md, .cursorrules, Skills, llms.txt, GEMINI.md, and A2A Card. Instead of hand-building each format separately, generate them all from a single source of truth.
+Agentify compiles any OpenAPI specification into **9 agent interface formats** — MCP Server, CLAUDE.md, AGENTS.md, .cursorrules, Skills, llms.txt, GEMINI.md, A2A Card, and CLI. Instead of hand-building each format separately, generate them all from a single source of truth.
 
 ```bash
 npx agentify-cli transform https://petstore.swagger.io/v2/swagger.json
@@ -38,8 +38,9 @@ AI agents are the new users of your API. But making your product agent-accessibl
 | llms.txt | LLM search engines | Manual authoring |
 | GEMINI.md | Gemini CLI | Write from scratch |
 | A2A Card | Google Agent-to-Agent protocol | JSON schema work |
+| CLI | Developers, scripts, CI/CD | Build from scratch |
 
-**That's 8+ formats to build, test, and keep in sync.** Every API change means updating all of them.
+**That's 9+ formats to build, test, and keep in sync.** Every API change means updating all of them.
 
 ## The Solution
 
@@ -61,6 +62,8 @@ OpenAPI Spec -----> +---> .cursorrules
                     +---> GEMINI.md
                     |
                     +---> A2A Card
+                    |
+                    +---> CLI (standalone command-line tool)
 ```
 
 ## Quick Start
@@ -77,12 +80,18 @@ npx agentify-cli transform https://api.example.com/openapi.json -n my-project
 
 # Generate only specific formats
 npx agentify-cli transform ./my-api.yaml -f mcp claude.md
+
+# Generate a standalone CLI tool from your API
+npx agentify-cli transform ./my-api.yaml -f cli -o my-api-cli
+
+# Get Agentify's own agent interface files (self-describe)
+npx agentify-cli self-describe -o .
 ```
 
 **Output:**
 
 ```
-  Agentify v0.3.0
+  Agentify v0.4.0
   Agent Interface Compiler
 
   +-- 20 endpoints detected -> SMALL API strategy
@@ -129,6 +138,7 @@ npx agentify-cli transform ./my-api.yaml -f mcp claude.md
 | llms.txt | Available | LLM-readable condensed documentation |
 | GEMINI.md | Available | Gemini CLI project context |
 | A2A Card | Available | Google Agent-to-Agent discovery card |
+| CLI | Available | Standalone command-line tool (opt-in: `-f cli`) |
 
 ## How It Works
 
@@ -205,6 +215,8 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for the full guide.
 | llms.txt | Yes | Yes | No | No |
 | GEMINI.md | Yes | No | No | No |
 | A2A Card | Yes | No | No | No |
+| CLI generation | Yes | No | No | No |
+| Self-as-Skills | Yes | No | No | No |
 | Context-aware strategy | Yes | No | Yes | No |
 | Security scanning | Yes | Unknown | Unknown | No |
 | Open source | MIT | No | No | MIT |

docs/demo.gif

@@ -20,7 +20,7 @@ Type "# Transform any OpenAPI spec into 8 agent interface formats"
 Enter
 Sleep 600ms
 
-Type "npx -y agentify-cli@0.3.0 transform https://petstore.swagger.io/v2/swagger.json"
+Type "npx -y agentify-cli@0.4.0 transform https://petstore.swagger.io/v2/swagger.json"
 Sleep 300ms
 Enter
 Sleep 35s

docs/demo.tape

@@ -1,6 +1,6 @@
 {
   "name": "agentify-cli",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Agent Interface Compiler — One command. Every agent speaks your product.",
   "type": "module",
   "bin": {
@@ -54,7 +54,8 @@
     "node": ">=18.0.0"
   },
   "files": [
-    "dist"
+    "dist",
+    "self"
   ],
   "dependencies": {
     "@apidevtools/swagger-parser": "^12.1.0",

package.json

@@ -0,0 +1,55 @@
+# AGENTS.md — Agentify
+
+## Identity
+
+Agentify is an Agent Interface Compiler. It transforms OpenAPI specifications into 9 agent interface formats from a single source of truth.
+
+Install: `npm install -g agentify-cli` or use via `npx agentify-cli`.
+
+## Capabilities
+
+### transform
+
+Convert an OpenAPI specification into agent interface formats.
+
+```bash
+npx agentify-cli transform <input> [-o dir] [-n name] [-f format1 format2 ...]
+```
+
+- **Input**: URL or file path to an OpenAPI spec (Swagger 2.0, OAS 3.x)
+- **Output**: Generated project with selected formats (default: all 9)
+- **Formats**: mcp, claude.md, agents.md, cursorrules, skills, llms.txt, gemini.md, a2a, cli
+- **Side effects**: Creates files in the output directory
+
+### self-describe
+
+Output Agentify's own agent interface files.
+
+```bash
+npx agentify-cli self-describe [-o dir]
+```
+
+- **Output**: skills.json, CLAUDE.md, AGENTS.md describing Agentify itself
+
+## Authentication
+
+No authentication required.
+
+## Protocols
+
+- **Interface**: Command-line (CLI)
+- **Input**: OpenAPI/Swagger specifications (URL or local file)
+- **Output**: File system (generated project directory)
+
+## Constraints
+
+- Requires Node.js 18+
+- Internet access needed for remote OpenAPI spec URLs
+- Generated MCP servers require their own setup (`npm install`, env config)
+- CLI format (`-f cli`) generates a separate project; avoid combining with `mcp` in the same output directory
+
+## Context
+
+- Repository: https://github.com/koriyoshi2041/agentify
+- npm: https://www.npmjs.com/package/agentify-cli
+- License: MIT

self/AGENTS.md

@@ -0,0 +1,70 @@
+# Agentify — Agent Interface Compiler
+
+When a user wants to make their API accessible to AI agents, use Agentify to transform their OpenAPI specification into agent interface formats.
+
+## Usage
+
+```bash
+npx agentify-cli transform <openapi-spec-url-or-path> [options]
+```
+
+### Options
+
+- `-o, --output <dir>` — Output directory (default: `<product-name>-mcp-server`)
+- `-n, --name <name>` — Override project name
+- `-f, --format <formats...>` — Output formats (default: all 9 formats)
+
+### Available Formats
+
+| Format | Flag | Output |
+|--------|------|--------|
+| MCP Server | `mcp` | Full server with tools, handlers, Dockerfile |
+| CLAUDE.md | `claude.md` | Project context for Claude Code |
+| AGENTS.md | `agents.md` | Universal agent instructions |
+| .cursorrules | `cursorrules` | Cursor IDE agent rules |
+| Skills | `skills` | Structured capability file (skills.json) |
+| llms.txt | `llms.txt` | LLM-readable condensed documentation |
+| GEMINI.md | `gemini.md` | Gemini CLI project context |
+| A2A Card | `a2a` | Google Agent-to-Agent discovery card |
+| CLI | `cli` | Standalone command-line tool |
+
+## When to Use
+
+- User has an OpenAPI/Swagger specification and wants agents to use their API
+- User asks to "make my API agent-accessible" or "generate MCP server"
+- User needs to convert a REST API for use with Claude, Cursor, Gemini, or other AI tools
+- User wants a CLI tool generated from their API specification
+- User mentions "agent interfaces", "MCP", "skills", or "A2A"
+
+## Examples
+
+```bash
+# Transform Petstore API into all agent formats
+npx agentify-cli transform https://petstore.swagger.io/v2/swagger.json
+
+# Generate only MCP server
+npx agentify-cli transform ./api-spec.yaml -f mcp -o my-mcp-server
+
+# Generate CLI tool from API
+npx agentify-cli transform https://api.example.com/openapi.json -f cli
+
+# Generate specific formats
+npx agentify-cli transform ./spec.json -f mcp skills a2a
+```
+
+## Supported Inputs
+
+- Swagger 2.0 (JSON/YAML)
+- OpenAPI 3.0.x (JSON/YAML)
+- OpenAPI 3.1.x (JSON/YAML)
+- URL or local file path
+
+## Self-Describe
+
+To get Agentify's own agent interface files:
+
+```bash
+npx agentify-cli self-describe [-o output-dir]
+```
+
+This outputs `skills.json`, `CLAUDE.md`, and `AGENTS.md` describing Agentify itself.

self/CLAUDE.md

@@ -0,0 +1,81 @@
+{
+  "name": "Agentify",
+  "description": "Agent Interface Compiler — transforms OpenAPI specs into 9 agent interface formats (MCP Server, CLAUDE.md, AGENTS.md, .cursorrules, Skills, llms.txt, GEMINI.md, A2A Card, CLI)",
+  "version": "0.4.0",
+  "baseUrl": "https://github.com/koriyoshi2041/agentify",
+  "auth": {
+    "type": "none",
+    "envVariable": ""
+  },
+  "skills": [
+    {
+      "id": "transform",
+      "name": "transform",
+      "description": "Transform an OpenAPI specification into agent interface formats. Run: npx agentify-cli transform <input> [-o dir] [-n name] [-f formats...]",
+      "domain": "compilation",
+      "operation": "execute",
+      "method": "cli",
+      "path": "npx agentify-cli transform",
+      "sideEffects": true,
+      "parameters": [
+        {
+          "name": "input",
+          "type": "string",
+          "required": true,
+          "description": "URL or file path to an OpenAPI spec (Swagger 2.0 or OAS 3.x)",
+          "in": "positional"
+        },
+        {
+          "name": "output",
+          "type": "string",
+          "required": false,
+          "description": "-o, --output <dir> — Output directory",
+          "in": "flag"
+        },
+        {
+          "name": "name",
+          "type": "string",
+          "required": false,
+          "description": "-n, --name <name> — Project name override",
+          "in": "flag"
+        },
+        {
+          "name": "format",
+          "type": "array",
+          "required": false,
+          "description": "-f, --format <formats...> — Output formats: mcp, claude.md, agents.md, cursorrules, skills, llms.txt, gemini.md, a2a, cli",
+          "in": "flag"
+        }
+      ]
+    },
+    {
+      "id": "self-describe",
+      "name": "self-describe",
+      "description": "Output Agentify's own agent interface files (skills.json, CLAUDE.md, AGENTS.md). Run: npx agentify-cli self-describe [-o dir]",
+      "domain": "compilation",
+      "operation": "read",
+      "method": "cli",
+      "path": "npx agentify-cli self-describe",
+      "sideEffects": true,
+      "parameters": [
+        {
+          "name": "output",
+          "type": "string",
+          "required": false,
+          "description": "-o, --output <dir> — Output directory (default: current directory)",
+          "in": "flag"
+        }
+      ]
+    }
+  ],
+  "domains": [
+    {
+      "name": "compilation",
+      "skillCount": 2
+    }
+  ],
+  "meta": {
+    "generator": "agentify (self-description)",
+    "strategy": "manual"
+  }
+}

self/skills.json

@@ -35,7 +35,7 @@ program
   .description("Transform an OpenAPI spec into agent interfaces")
   .option("-o, --output <dir>", "Output directory")
   .option("-n, --name <name>", "Project name override")
-  .option("-f, --format <formats...>", "Output formats (mcp, claude.md, agents.md, cursorrules, llms.txt, gemini.md, skills, a2a)", ["mcp", "claude.md", "agents.md", "cursorrules", "llms.txt", "gemini.md", "skills", "a2a"])
+  .option("-f, --format <formats...>", "Output formats (mcp, claude.md, agents.md, cursorrules, llms.txt, gemini.md, skills, a2a, cli)", ["mcp", "claude.md", "agents.md", "cursorrules", "llms.txt", "gemini.md", "skills", "a2a"])
   .action(async (input: string, opts: TransformOptions) => {
     await runTransform(input, opts);
   });
@@ -147,4 +147,35 @@ function toKebabCase(str: string): string {
     .toLowerCase();
 }
 
+program
+  .command("self-describe")
+  .description("Output Agentify's own agent interface files (skills.json, CLAUDE.md, AGENTS.md)")
+  .option("-o, --output <dir>", "Output directory", ".")
+  .action(async (opts: { output: string }) => {
+    const selfDir = resolveSelfDir();
+    const outputDir = path.resolve(opts.output);
+    fs.mkdirSync(outputDir, { recursive: true });
+
+    const files = ["skills.json", "CLAUDE.md", "AGENTS.md"];
+    for (const file of files) {
+      const src = path.join(selfDir, file);
+      const dest = path.join(outputDir, file);
+      fs.copyFileSync(src, dest);
+      console.log(`  ${chalk.green("\u2713")} ${file}`);
+    }
+
+    console.log("");
+    console.log(chalk.dim("  Agent interface files for Agentify itself."));
+    console.log(chalk.dim("  Add these to your project so agents know how to use Agentify."));
+    console.log("");
+  });
+
+function resolveSelfDir(): string {
+  for (const rel of ["../self", "../../self"]) {
+    const p = path.resolve(__dirname, rel);
+    if (fs.existsSync(p)) return p;
+  }
+  throw new Error("Could not locate self-description files. Are you running from the npm package?");
+}
+
 program.parse();