skill-creator 0.0.0 → 1.1.0

package/README.md

@@ -1,14 +1,16 @@
-# Skill Creator v2.0
+# Skill Creator
 
-A TypeScript/Node.js tool for creating claude-code-skills with intelligent documentation management.
+A TypeScript/Node.js CLI tool for creating claude-code-skills with intelligent documentation management and Context7 integration.
 
 ## Features
 
-- 🚀 Generate skills with proper folder naming (`package@version` format)
-- 📚 Download and slice documentation from Context7
-- 🔍 ChromaDB-powered semantic search
-- 💾 Dynamic content management with deduplication
-- 🛠️ Modern TypeScript/Node.js implementation
+- 🚀 **Automated Skill Creation**: Generate skills with proper folder naming (`package@version` format)
+- 📚 **Context7 Integration**: Download and slice documentation from Context7 with automatic project ID detection
+- 🔍 **Intelligent Search**: ChromaDB-powered semantic search with automatic indexing
+- 💾 **Dynamic Content Management**: Add custom knowledge with deduplication
+- 🛠️ **Modern TypeScript**: Full type safety with ESM modules
+- 🎯 **Interactive CLI**: Professional command-line interface with inquirer prompts
+- 📦 **Flexible Storage**: Store skills in project or user directory
 
 ## Installation
 
@@ -16,17 +18,121 @@ A TypeScript/Node.js tool for creating claude-code-skills with intelligent docum
 npm install -g skill-creator
 ```
 
-## Usage
+## Quick Start
+
+### Install as Subagent (Recommended)
+
+```bash
+# Interactive installation
+skill-creator init
+
+# Non-interactive installation to user directory
+skill-creator init-cc
+```
+
+### Create a Skill
 
 ```bash
-# Create a new skill
-skill-creator tanstack-router
+# Search for packages
+skill-creator search "react query"
 
-# With specific Context7 ID
-skill-creator @tanstack/react-router --context7-id /tanstack/router
+# Get package information
+skill-creator get-info @tanstack/react-query
 
-# In current directory
-skill-creator zod --storage project
+# Create skill with custom package name (recommended)
+skill-creator create-cc-skill --scope current --name "@tanstack/react-query" --description "React Query for data fetching" @tanstack/react-query@5
+
+# Create skill with interactive prompts (requires --scope)
+skill-creator create-cc-skill --scope current --interactive --description "React Query for data fetching" @tanstack/react-query@5
+
+# Download documentation (automatically builds search index)
+skill-creator download-context7 --package @tanstack/react-query /tanstack/react-query
+
+# Search your skill knowledge base
+skill-creator search-skill --package @tanstack/react-query "useQuery hook"
+```
+
+## Commands
+
+### Core Commands
+
+| Command | Description |
+|---------|-------------|
+| `init` | Install skill-creator as subagent (interactive mode) |
+| `init-cc` | Install skill-creator as subagent in user directory |
+| `search <keywords>` | Search npm packages |
+| `get-info <package>` | Get detailed package information |
+| `create-cc-skill <name>` | Create a new skill directory |
+
+### Content Management
+
+| Command | Description |
+|---------|-------------|
+| `download-context7 <project_id>` | Download and slice Context7 documentation |
+| `search-skill <query>` | Search in skill knowledge base |
+| `add-skill` | Add custom knowledge to skill |
+
+### Options
+
+- `--scope <user|current>`: Storage location for skills (required)
+- `--name <name>`: Package name for the skill (recommended)
+- `--pwd <path>`: Working directory for skill operations
+- `--package <name>`: Use package name to find skill directory
+- `--description <description>`: Custom description for the skill
+- `--force`: Force overwrite existing files
+- `--skip-chroma-indexing`: Skip automatic ChromaDB index building
+- `--interactive`: Enable interactive prompts
+
+## Workflow
+
+### Complete Skill Creation Workflow
+
+1. **Search Package**: Find the right package for your skill
+   ```bash
+   skill-creator search "state management"
+   ```
+
+2. **Get Package Info**: Retrieve detailed information
+   ```bash
+   skill-creator get-info zustand
+   ```
+
+3. **Create Skill**: Set up skill directory (requires --scope, recommended to use --name)
+   ```bash
+   # With custom package name (recommended)
+   skill-creator create-cc-skill --scope current --name zustand --description "Zustand state management"
+   
+   # With interactive prompts
+   skill-creator create-cc-skill --scope current --interactive zustand
+   ```
+
+4. **Download Documentation**: Get Context7 docs with automatic indexing
+   ```bash
+   skill-creator download-context7 --package zustand /zustand
+   ```
+
+5. **Add Custom Knowledge**: Enhance with your own content
+   ```bash
+   skill-creator add-skill --package zustand --title "Best Practices" --content "Your custom notes"
+   ```
+
+6. **Search Knowledge Base**: Query your skill
+   ```bash
+   skill-creator search-skill --package zustand "typescript patterns"
+   ```
+
+## Directory Structure
+
+```
+.claude/skills/
+└── package@version/
+    ├── assets/
+    │   └── references/
+    │       ├── context7/     # Auto-sliced Context7 docs
+    │       └── user/         # Custom knowledge files
+    ├── config.json          # Skill configuration
+    ├── SKILL.md             # Skill documentation
+    └── package.json         # Node.js metadata
 ```
 
 ## Development
@@ -35,19 +141,51 @@ skill-creator zod --storage project
 # Install dependencies
 npm install
 
-# Development mode
+# Development mode with watch
 npm run dev
 
-# Build
+# Build TypeScript
 npm run build
 
-# Test
+# Run tests
 npm test
 
-# Lint
+# Run tests with coverage
+npm run test:coverage
+
+# Lint code
 npm run lint
+
+# Type check
+npm run type-check
 ```
 
+## Configuration
+
+Skills are configured via `config.json` in the skill directory:
+
+```json
+{
+  "context7LibraryId": "/org/project",
+  "searchEngine": {
+    "type": "chroma",
+    "chromaPath": "./chroma"
+  }
+}
+```
+
+## Architecture
+
+- **TypeScript + ESM**: Modern JavaScript with full type safety
+- **ChromaDB Integration**: Vector search for intelligent document retrieval
+- **Context7 API**: Automated documentation downloading and slicing
+- **CLI-first Design**: Professional command-line interface
+- **Modular Architecture**: Clean separation of concerns
+
 ## License
 
-MIT
+MIT
+
+---
+
+*For detailed subagent usage, see `templates/skill-creator.md`*

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAOnC,QAAA,MAAM,OAAO,SAAgB,CAAA;AA8a7B,OAAO,EAAE,OAAO,EAAE,CAAA"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AASnC,QAAA,MAAM,OAAO,SAAgB,CAAA;AA2a7B,OAAO,EAAE,OAAO,EAAE,CAAA"}