claude-skills-cli 0.0.3 → 0.0.5

package/docs/SKILL-DEVELOPMENT.md

@@ -4,18 +4,19 @@
 
 ```bash
 # Create a new skill
-python .claude/scripts/init_skill.py --name my-skill --description "What it does"
+claude-skills init --name my-skill --description "What it does"
 
 # Validate the skill
-python .claude/scripts/validate_skill.py .claude/skills/my-skill
+claude-skills validate .claude/skills/my-skill
 
 # Package for distribution
-python .claude/scripts/package_skill.py .claude/skills/my-skill
+claude-skills package .claude/skills/my-skill
 ```
 
 ## The 6-Step Process
 
-Based on Anthropic's skill-creator methodology, adapted for devhub-crm.
+Based on Anthropic's skill-creator methodology, adapted for
+devhub-crm.
 
 ### Step 1: Understanding with Concrete Examples
 
@@ -68,7 +69,7 @@ Based on Anthropic's skill-creator methodology, adapted for devhub-crm.
 **Command**:
 
 ```bash
-python .claude/scripts/init_skill.py \
+claude-skills init \
   --name database-patterns \
   --description "Guide for SQLite operations..."
 ```
@@ -82,7 +83,7 @@ python .claude/scripts/init_skill.py \
 ├── references/
 │   └── detailed-guide.md       # Example reference
 ├── scripts/
-│   └── example.py              # Example script
+│   └── example.js              # Example script
 └── assets/                     # Empty directory
 ```
 
@@ -92,7 +93,8 @@ python .claude/scripts/init_skill.py \
 
 ### Step 4: Editing the Skill
 
-**Focus**: Write content for another instance of Claude to use effectively.
+**Focus**: Write content for another instance of Claude to use
+effectively.
 
 #### Start with Reusable Contents
 
@@ -169,8 +171,8 @@ For detailed information:
 
 ## Scripts
 
-- `scripts/validate.py`: Description
-- `scripts/generate.py`: Description
+- `scripts/validate.js`: Description
+- `scripts/generate.js`: Description
 
 ## Notes
 
@@ -192,7 +194,7 @@ For detailed information:
 **Validation First**:
 
 ```bash
-python .claude/scripts/validate_skill.py .claude/skills/database-patterns
+claude-skills validate .claude/skills/database-patterns
 
 # Output shows:
 # ✅ All required fields present
@@ -203,7 +205,7 @@ python .claude/scripts/validate_skill.py .claude/skills/database-patterns
 **Fix Validation Issues**, then package:
 
 ```bash
-python .claude/scripts/package_skill.py .claude/skills/database-patterns
+claude-skills package .claude/skills/database-patterns
 
 # Creates:
 # dist/database-patterns.zip
@@ -234,13 +236,13 @@ python .claude/scripts/package_skill.py .claude/skills/database-patterns
 vim .claude/skills/database-patterns/SKILL.md
 
 # Validate changes
-python .claude/scripts/validate_skill.py .claude/skills/database-patterns
+claude-skills validate .claude/skills/database-patterns
 
 # Test in conversation
 # (Skills auto-reload in Claude Code)
 
 # Package new version if needed
-python .claude/scripts/package_skill.py .claude/skills/database-patterns
+claude-skills package .claude/skills/database-patterns
 ```
 
 **Common Iterations**:
@@ -315,7 +317,8 @@ Add comments explaining WHY, not just WHAT:
 ```markdown
 ## ID Generation
 
-Generate IDs with nanoid() to ensure uniqueness without database overhead.
+Generate IDs with nanoid() to ensure uniqueness without database
+overhead.
 
 <!-- Not just: "Use nanoid()" -->
 ```
@@ -325,10 +328,11 @@ Generate IDs with nanoid() to ensure uniqueness without database overhead.
 Always run validation:
 
 ```bash
-python .claude/scripts/validate_skill.py .claude/skills/my-skill --strict
+claude-skills validate .claude/skills/my-skill --strict
 ```
 
-Strict mode treats warnings as errors - use before packaging for distribution.
+Strict mode treats warnings as errors - use before packaging for
+distribution.
 
 ---
 
@@ -425,33 +429,32 @@ description: Brief description including when to use this skill
 
 ### Script File
 
-```python
-#!/usr/bin/env python3
-"""
-Description of what this script does.
+```javascript
+#!/usr/bin/env node
 
-Usage:
-    python script_name.py [arguments]
+/**
+ * Description of what this script does.
+ *
+ * Usage:
+ *   node script_name.js [arguments]
+ *
+ * Example:
+ *   node validate.js --check-all
+ */
 
-Example:
-    python validate.py --check-all
-"""
+function main() {
+	// Script logic here
+}
 
-import sys
-
-def main():
-    # Script logic here
-    pass
-
-if __name__ == "__main__":
-    main()
+main();
 ```
 
 ---
 
 ## Next Steps
 
-1. Read [SKILLS-ARCHITECTURE.md](SKILLS-ARCHITECTURE.md) for system overview
+1. Read [SKILLS-ARCHITECTURE.md](SKILLS-ARCHITECTURE.md) for system
+   overview
 2. See [SKILL-EXAMPLES.md](SKILL-EXAMPLES.md) for real examples
-3. Create your first skill with `python .claude/scripts/init_skill.py`
+3. Create your first skill with `claude-skills init`
 4. Join skill development workflow for devhub-crm

package/docs/SKILL-EXAMPLES.md

@@ -1,6 +1,7 @@
 # Skill Examples
 
-Real-world examples from Anthropic's Skills repository and Claude Cookbooks, with analysis of what makes them effective.
+Real-world examples from Anthropic's Skills repository and Claude
+Cookbooks, with analysis of what makes them effective.
 
 ---
 
@@ -12,8 +13,8 @@ Real-world examples from Anthropic's Skills repository and Claude Cookbooks, wit
 applying-brand-guidelines/
 ├── SKILL.md
 └── scripts/
-    ├── apply_brand.py
-    └── validate_brand.py
+    ├── apply_brand.js
+    └── validate_brand.js
 ```
 
 ### SKILL.md Frontmatter
@@ -21,15 +22,19 @@ applying-brand-guidelines/
 ```yaml
 ---
 name: applying-brand-guidelines
-description: This skill applies consistent corporate branding and styling to all generated documents including colors, fonts, layouts, and messaging
+description:
+  This skill applies consistent corporate branding and styling to all
+  generated documents including colors, fonts, layouts, and messaging
 ---
 ```
 
 ### What Makes It Good
 
-**✅ Clear Scope**: Focuses on one thing - brand consistency across documents
+**✅ Clear Scope**: Focuses on one thing - brand consistency across
+documents
 
-**✅ Actionable Content**: Specific hex codes, font sizes, spacing rules
+**✅ Actionable Content**: Specific hex codes, font sizes, spacing
+rules
 
 ```markdown
 ### Color Palette
@@ -40,12 +45,13 @@ description: This skill applies consistent corporate branding and styling to all
 
 **✅ Executable Scripts**: Validation doesn't need manual checking
 
-```python
-# scripts/validate_brand.py
-# Checks documents for brand compliance automatically
+```javascript
+// scripts/validate_brand.js
+// Checks documents for brand compliance automatically
 ```
 
-**✅ "When to Use" in Description**: "applies consistent corporate branding...to all generated documents"
+**✅ "When to Use" in Description**: "applies consistent corporate
+branding...to all generated documents"
 
 ### Key Takeaway
 
@@ -68,7 +74,7 @@ pdf/
 │   ├── forms.md
 │   └── reference.md
 └── scripts/
-    └── extract_fields.py
+    └── extract_fields.js
 ```
 
 ### SKILL.md Excerpt
@@ -76,19 +82,26 @@ pdf/
 ````markdown
 ---
 name: pdf
-description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
+description:
+  Extract text and tables from PDF files, fill forms, merge documents.
+  Use when working with PDF files or when the user mentions PDFs,
+  forms, or document extraction.
 ---
 
 # PDF Processing
 
 ## Quick Start
 
-Use pdfplumber to extract text from PDFs:
+Use pdf-parse to extract text from PDFs:
 
-```python
-import pdfplumber
-with pdfplumber.open("document.pdf") as pdf:
-    text = pdf.pages[0].extract_text()
+```javascript
+const fs = require('fs');
+const pdf = require('pdf-parse');
+
+const dataBuffer = fs.readFileSync('document.pdf');
+pdf(dataBuffer).then((data) => {
+	console.log(data.text);
+});
 ```
 ````
 
@@ -122,14 +135,9 @@ Large domains benefit from splitting:
 ### Structure (from Claude Cookbooks)
 ```
 
-financial-analyzer/
-├── SKILL.md
-├── references/
-│ ├── formulas.md
-│ └── ratios-reference.md
-└── scripts/
-├── calculate_ratios.py
-└── generate_dashboard.py
+financial-analyzer/ ├── SKILL.md ├── references/ │ ├── formulas.md │
+└── ratios-reference.md └── scripts/ ├── calculate_ratios.js └──
+generate_dashboard.js
 
 ````
 
@@ -147,17 +155,18 @@ description: Calculate financial ratios, analyze statements, and generate perfor
 ### Liquidity Ratios
 
 **Current Ratio**:
-```python
-current_ratio = current_assets / current_liabilities
+```javascript
+const currentRatio = currentAssets / currentLiabilities;
 ````
 
 **Quick Ratio**:
 
-```python
-quick_ratio = (current_assets - inventory) / current_liabilities
+```javascript
+const quickRatio = (currentAssets - inventory) / currentLiabilities;
 ```
 
-For complete ratio formulas, see [references/formulas.md](references/formulas.md).
+For complete ratio formulas, see
+[references/formulas.md](references/formulas.md).
 
 ````
 
@@ -166,9 +175,9 @@ For complete ratio formulas, see [references/formulas.md](references/formulas.md
 **✅ Domain-Specific**: Tailored to financial analysis
 
 **✅ Executable Calculations**: Scripts provide exact formulas
-```python
-# scripts/calculate_ratios.py
-# Runs calculations without Claude generating code each time
+```javascript
+// scripts/calculate_ratios.js
+// Runs calculations without Claude generating code each time
 ````
 
 **✅ References for Detail**: Full formula explanations in references/
@@ -204,7 +213,10 @@ database-schema/
 ````markdown
 ---
 name: database-schema
-description: Complete database schema with table structures, relationships, and indexes for the project. Use when writing SQL queries, understanding data models, or working with database operations.
+description:
+  Complete database schema with table structures, relationships, and
+  indexes for the project. Use when writing SQL queries, understanding
+  data models, or working with database operations.
 ---
 
 # Database Schema
@@ -259,16 +271,9 @@ Reference-heavy skills should:
 ### Structure (from Anthropic examples)
 ```
 
-component-library/
-├── SKILL.md
-├── references/
-│ ├── button-variants.md
-│ ├── form-patterns.md
-│ └── layout-components.md
-└── assets/
-└── component-templates/
-├── button.tsx
-└── form.tsx
+component-library/ ├── SKILL.md ├── references/ │ ├──
+button-variants.md │ ├── form-patterns.md │ └── layout-components.md
+└── assets/ └── component-templates/ ├── button.tsx └── form.tsx
 
 ````
 
@@ -327,15 +332,9 @@ Component library skills should:
 ### Structure
 ```
 
-github-api/
-├── SKILL.md
-├── references/
-│ ├── endpoints.md
-│ ├── authentication.md
-│ └── rate-limits.md
-└── scripts/
-├── test_connection.py
-└── check_rate_limit.py
+github-api/ ├── SKILL.md ├── references/ │ ├── endpoints.md │ ├──
+authentication.md │ └── rate-limits.md └── scripts/ ├──
+test_connection.js └── check_rate_limit.js
 
 ````
 
@@ -364,10 +363,11 @@ const response = await fetch('https://api.github.com/user', {
 Check rate limits before making requests:
 
 ```bash
-python scripts/check_rate_limit.py
+node scripts/check_rate_limit.js
 ```
 
-For complete API reference, see [references/endpoints.md](references/endpoints.md).
+For complete API reference, see
+[references/endpoints.md](references/endpoints.md).
 
 ````
 
@@ -406,7 +406,10 @@ description: Helps with database operations
 
 ```yaml
 ---
-description: SQLite query patterns using better-sqlite3 for contacts, companies, and interactions tables. Use when writing SELECT, INSERT, UPDATE, or DELETE operations with prepared statements.
+description:
+  SQLite query patterns using better-sqlite3 for contacts, companies,
+  and interactions tables. Use when writing SELECT, INSERT, UPDATE, or
+  DELETE operations with prepared statements.
 ---
 ```
 
@@ -433,8 +436,8 @@ description: SQLite query patterns using better-sqlite3 for contacts, companies,
 
 [10 common patterns]
 
-For complete schema: [references/schema.md](references/schema.md)
-For all examples: [references/queries.md](references/queries.md)
+For complete schema: [references/schema.md](references/schema.md) For
+all examples: [references/queries.md](references/queries.md)
 ```
 
 ### ❌ Anti-Pattern 3: Using Second Person
@@ -466,7 +469,10 @@ description: Handle form submissions
 
 ```yaml
 ---
-description: Handle form submissions with validation, error handling, and reactive updates. Use when implementing forms, processing user input, or validating data before database operations.
+description:
+  Handle form submissions with validation, error handling, and
+  reactive updates. Use when implementing forms, processing user
+  input, or validating data before database operations.
 ---
 ```
 
@@ -476,7 +482,8 @@ description: Handle form submissions with validation, error handling, and reacti
 
 ### Example: Multi-Skill Workflow
 
-**User Request**: "Create a GitHub contact dashboard with database stats"
+**User Request**: "Create a GitHub contact dashboard with database
+stats"
 
 **Skills Activated**:
 
@@ -485,7 +492,8 @@ description: Handle form submissions with validation, error handling, and reacti
 3. `sveltekit-patterns` - Build component structure
 4. `daisyui-conventions` - Apply styling
 
-**Why This Works**: Each skill handles its domain, Claude composes them naturally.
+**Why This Works**: Each skill handles its domain, Claude composes
+them naturally.
 
 ---
 
@@ -494,8 +502,10 @@ description: Handle form submissions with validation, error handling, and reacti
 ### From Anthropic Skills
 
 1. **Metadata drives discovery** - Spend time on descriptions
-2. **Progressive disclosure saves tokens** - Don't front-load everything
-3. **Scripts for determinism** - Code that doesn't change shouldn't be generated
+2. **Progressive disclosure saves tokens** - Don't front-load
+   everything
+3. **Scripts for determinism** - Code that doesn't change shouldn't be
+   generated
 4. **References for depth** - Keep SKILL.md navigable
 5. **Real examples** - Pull from actual codebases
 

package/docs/SKILLS-ARCHITECTURE.md

@@ -2,7 +2,10 @@
 
 ## Overview
 
-Claude Skills are modular capabilities that extend Claude's functionality through a filesystem-based architecture. They provide specialized domain expertise, workflows, and tools that transform Claude from a general-purpose agent into a specialist.
+Claude Skills are modular capabilities that extend Claude's
+functionality through a filesystem-based architecture. They provide
+specialized domain expertise, workflows, and tools that transform
+Claude from a general-purpose agent into a specialist.
 
 ## Core Concepts
 
@@ -52,8 +55,8 @@ Claude sees this at startup and knows:
 - When to use it
 - How to trigger it
 
-**Token cost**: ~100 tokens per skill (metadata only)
-**When**: At agent startup, every conversation
+**Token cost**: ~100 tokens per skill (metadata only) **When**: At
+agent startup, every conversation
 
 ### Level 2: Instructions (<5k tokens)
 
@@ -71,26 +74,26 @@ The markdown body of SKILL.md contains:
 ## Core Principles
 
 - Use prepared statements for all queries
-- Generate IDs with nanoid()
-  ...
+- Generate IDs with nanoid() ...
 
 For complete schema, see [references/schema.md](references/schema.md)
 ```
 
-**Token cost**: ~3-5k tokens typically
-**When**: Only when Claude determines skill is relevant
+**Token cost**: ~3-5k tokens typically **When**: Only when Claude
+determines skill is relevant
 
 ### Level 3: Resources (unlimited)
 
 **Loaded as needed**
 
 - **references/**: Documentation Claude reads into context as needed
-- **scripts/**: Executable code Claude runs without loading into context
+- **scripts/**: Executable code Claude runs without loading into
+  context
 - **assets/**: Files used in output (templates, images, fonts)
 
 ```bash
 # Claude can execute scripts without reading them
-python scripts/validate_schema.py
+node scripts/validate_schema.js
 
 # Or read references when needed
 cat references/detailed-schema.md
@@ -147,8 +150,8 @@ my-skill/
 │   ├── examples.md
 │   └── troubleshooting.md
 ├── scripts/                    # Executable code
-│   ├── validate.py
-│   ├── generate.py
+│   ├── validate.js
+│   ├── generate.js
 │   └── test.sh
 └── assets/                     # Templates & resources
     ├── template.sql
@@ -226,7 +229,8 @@ Detailed documentation loaded only when needed by Claude.
 ```markdown
 # In SKILL.md
 
-For complete database schema with all relationships, see [references/schema.md](references/schema.md).
+For complete database schema with all relationships, see
+[references/schema.md](references/schema.md).
 
 # Claude can then:
 
@@ -237,7 +241,8 @@ cat references/schema.md # Load when needed
 
 ### Purpose
 
-Executable code for deterministic operations that don't need token generation.
+Executable code for deterministic operations that don't need token
+generation.
 
 ### When to Use Scripts
 
@@ -248,21 +253,21 @@ Executable code for deterministic operations that don't need token generation.
 
 ### Why Scripts Are Efficient
 
-```python
-# Option 1: Claude generates code every time (expensive)
-"Claude, write Python to validate these timestamps..."
-# Result: ~500 tokens each time
+```javascript
+// Option 1: Claude generates code every time (expensive)
+"Claude, write JavaScript to validate these timestamps..."
+// Result: ~500 tokens each time
 
-# Option 2: Claude runs existing script (cheap)
-python scripts/validate_timestamps.py
-# Result: ~50 tokens (just the output)
+// Option 2: Claude runs existing script (cheap)
+node scripts/validate_timestamps.js
+// Result: ~50 tokens (just the output)
 ```
 
 ### Best Practices
 
-- Include shebang (`#!/usr/bin/env python3`)
+- Include shebang (`#!/usr/bin/env node`)
 - Make executable (`chmod +x`)
-- Add docstrings with usage
+- Add JSDoc comments with usage
 - Handle errors gracefully
 - Return meaningful output
 
@@ -281,7 +286,7 @@ Files used in output, not loaded into context.
 
 ### Usage Pattern
 
-```python
+```bash
 # Claude copies/modifies assets without reading into context
 cp assets/template.html output/index.html
 # Modify the template as needed
@@ -309,7 +314,8 @@ Schema reference (if needed): ~2000 tokens
 Total: 100 tokens normally, 3100-5100 when used
 ```
 
-**Savings**: Skill metadata is loaded once. Without skill, you pay ~3500 tokens every conversation even if not needed.
+**Savings**: Skill metadata is loaded once. Without skill, you pay
+~3500 tokens every conversation even if not needed.
 
 ## Skill Composition
 
@@ -354,27 +360,22 @@ Each skill loads independently, shares context naturally.
 
 ### Do:
 
-✅ Keep SKILL.md concise and actionable
-✅ Use imperative voice for instructions
-✅ Provide concrete examples
-✅ Link to references for details
-✅ Include "when to use" in description
-✅ Use scripts for deterministic operations
-✅ Group related content in references
-✅ Test skills on real tasks
+✅ Keep SKILL.md concise and actionable ✅ Use imperative voice for
+instructions ✅ Provide concrete examples ✅ Link to references for
+details ✅ Include "when to use" in description ✅ Use scripts for
+deterministic operations ✅ Group related content in references ✅
+Test skills on real tasks
 
 ### Don't:
 
-❌ Duplicate content between SKILL.md and references
-❌ Use second person ("you")
-❌ Include entire documentation inline
-❌ Forget to specify when to use skill
-❌ Make descriptions too generic
-❌ Leave TODO placeholders
-❌ Skip validation before packaging
+❌ Duplicate content between SKILL.md and references ❌ Use second
+person ("you") ❌ Include entire documentation inline ❌ Forget to
+specify when to use skill ❌ Make descriptions too generic ❌ Leave
+TODO placeholders ❌ Skip validation before packaging
 
 ## Next Steps
 
-- Read [SKILL-DEVELOPMENT.md](SKILL-DEVELOPMENT.md) for creation workflow
+- Read [SKILL-DEVELOPMENT.md](SKILL-DEVELOPMENT.md) for creation
+  workflow
 - See [SKILL-EXAMPLES.md](SKILL-EXAMPLES.md) for real-world examples
-- Use `python init_skill.py` to create your first skill
+- Use `claude-skills init` to create your first skill

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-skills-cli",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "CLI toolkit for creating and managing Claude Agent Skills",
   "type": "module",
   "main": "./dist/index.js",
@@ -10,7 +10,6 @@
   "files": [
     "dist",
     "docs",
-    "skills",
     "README.md"
   ],
   "engines": {
@@ -47,6 +46,7 @@
   },
   "scripts": {
     "build": "tsc",
+    "postbuild": "mkdir -p dist/skills && cp -r .claude/skills/skill-creator dist/skills/skill-creator",
     "dev": "tsc --watch",
     "start": "node ./dist/index.js",
     "format": "prettier --write .",