@skillsmith/cli 0.2.2 → 0.2.4

package/README.md

@@ -2,8 +2,13 @@
 
 Command-line interface for Skillsmith - discover, manage, and author Claude Code skills.
 
-## What's New in v0.2.2
+## What's New in v0.2.4
 
+- **MCP Server Scaffolding**: Generate TypeScript MCP servers with `author mcp-init`
+- **Decision Helper Integration**: Seamless flow from evaluation to scaffolding
+- **Subagent Generation**: Generate companion specialist agents for parallel execution (37-97% token savings)
+- **Skill Transform**: Upgrade existing skills with subagent configuration
+- **Tool Detection**: Automatic analysis of required tools from skill content
 - **Live Skills**: Search and install from 9,717+ real skills
 - **Faster Search**: Full-text search with quality ranking
 - **Privacy First**: Opt-out telemetry, no PII collected
@@ -156,6 +161,114 @@ skillsmith publish --dry-run
 **Options:**
 - `-d, --dry-run` - Preview without making changes
 
+### author subagent
+
+Generate a companion specialist agent for parallel skill execution.
+
+```bash
+# Generate subagent for current directory
+skillsmith author subagent
+
+# Generate for specific skill
+skillsmith author subagent ./my-skill
+
+# Override detected tools
+skillsmith author subagent --tools "Read,Write,Bash"
+
+# Use different model
+skillsmith author subagent --model haiku
+```
+
+**Options:**
+- `-o, --output <path>` - Output directory (default: ~/.claude/agents)
+- `--tools <tools>` - Override detected tools (comma-separated)
+- `--model <model>` - Model: sonnet, opus, haiku (default: sonnet)
+- `--skip-claude-md` - Skip CLAUDE.md snippet generation
+- `--force` - Overwrite existing subagent
+
+**Output:**
+- Creates `~/.claude/agents/[skill-name]-specialist.md`
+- Displays CLAUDE.md integration snippet
+
+### author transform
+
+Upgrade existing skills with subagent configuration (non-destructive).
+
+```bash
+# Preview what would be generated
+skillsmith author transform ./my-skill --dry-run
+
+# Generate subagent for existing skill
+skillsmith author transform ./my-skill
+
+# Process multiple skills at once
+skillsmith author transform ~/.claude/skills --batch
+```
+
+**Options:**
+- `--dry-run` - Preview without creating files
+- `--force` - Overwrite existing subagent
+- `--batch` - Process directory of skills
+- `--tools <tools>` - Override detected tools
+- `--model <model>` - Model: sonnet, opus, haiku (default: sonnet)
+
+### author mcp-init
+
+Scaffold a new MCP server project with TypeScript and stdio transport.
+
+```bash
+# Interactive mode
+skillsmith author mcp-init
+
+# With name
+skillsmith author mcp-init my-mcp-server
+
+# With pre-defined tools
+skillsmith author mcp-init my-server --tools "greet,search,process"
+
+# Custom output directory
+skillsmith author mcp-init my-server --output ./servers
+```
+
+**Options:**
+- `-o, --output <path>` - Output directory (default: current directory)
+- `--tools <tools>` - Initial tool names (comma-separated)
+- `--force` - Overwrite existing directory
+
+**Generated Structure:**
+```
+my-mcp-server/
+├── package.json         # npm package with MCP SDK
+├── tsconfig.json        # TypeScript configuration
+├── src/
+│   ├── index.ts         # Entry point (npx-ready)
+│   ├── server.ts        # MCP server setup
+│   └── tools/
+│       ├── index.ts     # Tool definitions
+│       └── example.ts   # Example tool implementation
+├── README.md            # Usage documentation
+└── .gitignore
+```
+
+**After Generation:**
+```bash
+cd my-mcp-server
+npm install
+npm run dev  # Start in development mode
+```
+
+**Configure in Claude Code** (`~/.claude/settings.json`):
+```json
+{
+  "mcpServers": {
+    "my-mcp-server": {
+      "command": "npx",
+      "args": ["tsx", "/path/to/my-mcp-server/src/index.ts"]
+    }
+  }
+}
+```
+
 ### import
 
 Import skills from GitHub (for populating local database).
@@ -220,10 +333,43 @@ skillsmith init my-awesome-skill
 # Validate your skill
 skillsmith validate ./my-awesome-skill
 
+# Generate companion subagent for parallel execution
+skillsmith author subagent ./my-awesome-skill
+
 # Prepare for publishing
 skillsmith publish ./my-awesome-skill
 ```
 
+### Upgrade Existing Skills with Subagents
+
+```bash
+# Preview subagent generation (dry run)
+skillsmith author transform ~/.claude/skills/docker --dry-run
+
+# Generate subagent for a skill
+skillsmith author transform ~/.claude/skills/docker
+
+# Batch upgrade all skills
+skillsmith author transform ~/.claude/skills --batch --force
+```
+
+### Create an MCP Server
+
+```bash
+# Scaffold a new MCP server
+skillsmith author mcp-init my-slack-integration --tools "send_message,list_channels"
+
+# Navigate and install dependencies
+cd my-slack-integration
+npm install
+
+# Start development server
+npm run dev
+
+# Add to Claude Code settings
+# Edit ~/.claude/settings.json to include the server
+```
+
 ### Manage Skills
 
 ```bash