claude-skills-cli 0.0.3 → 0.0.4

package/docs/SKILL-DEVELOPMENT.md

@@ -4,13 +4,13 @@
 
 ```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
@@ -68,7 +68,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 +82,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
 ```
 
@@ -169,8 +169,8 @@ For detailed information:
 
 ## Scripts
 
-- `scripts/validate.py`: Description
-- `scripts/generate.py`: Description
+- `scripts/validate.js`: Description
+- `scripts/generate.js`: Description
 
 ## Notes
 
@@ -192,7 +192,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 +203,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 +234,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**:
@@ -325,7 +325,7 @@ 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.
@@ -425,26 +425,24 @@ 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();
 ```
 
 ---
@@ -453,5 +451,5 @@ if __name__ == "__main__":
 
 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

@@ -12,8 +12,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
@@ -40,9 +40,9 @@ 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"
@@ -68,7 +68,7 @@ pdf/
 │   ├── forms.md
 │   └── reference.md
 └── scripts/
-    └── extract_fields.py
+    └── extract_fields.js
 ```
 
 ### SKILL.md Excerpt
@@ -83,12 +83,16 @@ description: Extract text and tables from PDF files, fill forms, merge documents
 
 ## 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);
+});
 ```
 ````
 
@@ -128,8 +132,8 @@ financial-analyzer/
 │ ├── formulas.md
 │ └── ratios-reference.md
 └── scripts/
-├── calculate_ratios.py
-└── generate_dashboard.py
+├── calculate_ratios.js
+└── generate_dashboard.js
 
 ````
 
@@ -147,14 +151,14 @@ 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).
@@ -166,9 +170,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/
@@ -334,8 +338,8 @@ github-api/
 │ ├── authentication.md
 │ └── rate-limits.md
 └── scripts/
-├── test_connection.py
-└── check_rate_limit.py
+├── test_connection.js
+└── check_rate_limit.js
 
 ````
 
@@ -364,7 +368,7 @@ 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).

package/docs/SKILLS-ARCHITECTURE.md

@@ -90,7 +90,7 @@ For complete schema, see [references/schema.md](references/schema.md)
 
 ```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 +147,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
@@ -248,21 +248,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 +281,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
@@ -377,4 +377,4 @@ Each skill loads independently, shares context naturally.
 
 - 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.4",
   "description": "CLI toolkit for creating and managing Claude Agent Skills",
   "type": "module",
   "main": "./dist/index.js",