@skillsmith/cli 0.3.3 → 0.3.5

package/README.md

@@ -24,7 +24,7 @@ Command-line interface for Skillsmith - discover, manage, and author Claude Code
 - **Skill Transform**: Upgrade existing skills with subagent configuration
 - **Dynamic Version**: Version now reads from package.json automatically
 - **Tool Detection**: Automatic analysis of required tools from skill content
-- **Live Skills**: Search and install from 9,717+ real skills
+- **Live Skills**: Search and install from 14,000+ real skills
 - **Faster Search**: Full-text search with quality ranking
 - **Privacy First**: Opt-out telemetry, no PII collected
 

package/assets/skillsmith-skill/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: "skillsmith"
 description: "Discover, install, compare, and manage Claude Code skills. Search the registry, get recommendations, validate skill quality, and manage your installed skills."
-version: "0.1.0"
+version: "0.2.0"
 category: "productivity"
 tags:
   - skills
@@ -9,15 +9,54 @@ tags:
   - registry
   - mcp
   - installation
+  - agents
+  - optimization
 author: "Skillsmith"
 allowed-tools:
   - mcp__skillsmith
   - Bash
+  - Task
 ---
 
 # Skillsmith Skill
 
-Discover, install, compare, and manage Claude Code skills through natural language.
+Skillsmith is loaded. I can help you with:
+
+## Top Features
+
+**Parallel Agent Spawning**
+- Generate companion subagents for any skill with `author subagent`
+- Transform existing skills into agent-ready workflows with `author transform`
+- Batch process multiple skills for team-wide agent deployment
+
+**Skill Optimization**
+- A/B test original vs optimized skills (Team+ tier)
+- Benchmark skill performance with controlled experiments
+- Generate detailed optimization analysis reports
+
+## Discovery
+- Search 14,000+ skills by keyword, category, or trust tier
+- Get stack-aware recommendations based on your project context
+- Compare multiple skills side-by-side with quality scores
+
+## Management
+- Install skills to `~/.claude/skills/` with security scanning
+- Uninstall skills you no longer need
+- Validate skill structure before publishing
+
+## Security
+- All skills are scanned before installation
+- Trust tiers indicate verification level (Official → Verified → Community → Unverified)
+- Typosquatting and blocklist protection
+
+What would you like to do? Some examples:
+- "Search for testing skills"
+- "Find verified skills for git"
+- "Recommend skills for my React project"
+- "Install the commit skill"
+- "Compare jest-helper and vitest-helper"
+- "Generate subagent for my skill"
+- "Transform my skills to support agents"
 
 ## Trigger Phrases
 
@@ -31,6 +70,9 @@ Discover, install, compare, and manage Claude Code skills through natural langua
 - "skill details", "get skill"
 - "browse skills", "explore skills"
 - "high quality skills", "verified skills"
+- "generate subagent", "create agent"
+- "transform skill", "upgrade skill"
+- "batch transform", "parallel agents"
 
 ## Slash Commands
 
@@ -45,6 +87,46 @@ Discover, install, compare, and manage Claude Code skills through natural langua
 | `/skillsmith uninstall` | Remove an installed skill | `/skillsmith uninstall jest-helper` |
 | `/skillsmith get` | Get detailed skill information | `/skillsmith get community/jest-helper` |
 
+## Agent & Optimization Commands
+
+| Command | Description |
+|---------|-------------|
+| `author subagent [path]` | Generate companion subagent for a skill |
+| `author transform [path]` | Upgrade existing skill with subagent configuration |
+| `author transform --batch` | Batch process multiple skills |
+| `ab-test --skill <name>` | Run A/B testing experiments (Team+ tier) |
+
+### Subagent Generation
+
+Generate a parallel agent for any skill:
+
+```bash
+skillsmith author subagent ./my-skill
+  --tools "Read,Write,Bash"    # Override detected tools
+  --model sonnet               # Model: sonnet|opus|haiku
+  --force                      # Overwrite existing subagent
+```
+
+### Batch Transform
+
+Transform all your skills to support parallel agents:
+
+```bash
+# Transform all skills in ~/.claude/skills/
+skillsmith author transform ~/.claude/skills --batch
+
+# Transform specific skills
+skillsmith author transform skill1,skill2,skill3 --batch --force
+```
+
+### A/B Testing (Team+ Tier)
+
+Compare original vs optimized skill performance:
+
+```bash
+skillsmith ab-test --skill governance --iterations 20
+```
+
 ## MCP Tool Delegation
 
 This skill delegates to the `mcp__skillsmith` MCP server for all operations. When the user requests skill-related actions, use the appropriate MCP tool.