Initial commit

commands/demo-skills.md

@@ -0,0 +1,283 @@
+---
+name: demo-skills
+description: Demonstrates the 5 plugin management Skills for creating, validating, auditing, and managing plugins in claude-code-plugins repository
+model: sonnet
+---
+
+# Skills Powerkit Demo - Plugin Management Skills
+
+This command demonstrates the 5 Agent Skills designed specifically for managing plugins in the **claude-code-plugins** repository.
+
+## What Is Skills Powerkit?
+
+**Skills Powerkit is a "meta-plugin"** - it helps you BUILD, VALIDATE, AUDIT, and MANAGE other plugins.
+
+Unlike general development skills, these are **repository-specific** - they understand:
+- Two-catalog system (marketplace.extended.json → marketplace.json)
+- Repository structure and standards
+- CLAUDE.md compliance requirements
+- Validation and security requirements
+
+---
+
+## 5 Plugin Management Skills
+
+### 1. 🛠️ Plugin Creator
+**Auto-invokes when you mention:**
+- "create plugin", "new plugin"
+- "scaffold plugin"
+- "add plugin to marketplace"
+
+**Example request:** "Create a security plugin called 'owasp-scanner' with commands"
+
+**What it automatically does:**
+1. Creates directory structure: `plugins/security/owasp-scanner/`
+2. Generates plugin.json with proper schema
+3. Creates README.md, LICENSE
+4. Adds commands/ directory with example
+5. Updates marketplace.extended.json
+6. Runs `npm run sync-marketplace`
+7. Validates everything
+8. Reports: "✅ Plugin created and ready!"
+
+**Saves you:** 15-30 minutes of manual setup
+
+---
+
+### 2. ✅ Plugin Validator
+**Auto-invokes when you mention:**
+- "validate plugin", "check plugin"
+- "is plugin ready to commit"
+- "plugin errors"
+
+**Example request:** "Validate the skills-powerkit plugin"
+
+**What it automatically does:**
+1. Checks required files exist
+2. Validates plugin.json schema
+3. Checks markdown frontmatter format
+4. Verifies script permissions
+5. Validates marketplace entry
+6. Runs security scans
+7. Generates validation report
+
+**Saves you:** 5-10 minutes of manual checking
+
+---
+
+### 3. 📦 Marketplace Manager
+**Auto-invokes when you mention:**
+- "update marketplace", "sync marketplace"
+- "add to marketplace"
+- "marketplace catalog"
+
+**Example request:** "Add the new security-scanner to marketplace"
+
+**What it automatically does:**
+1. Reads plugin.json for metadata
+2. Adds entry to marketplace.extended.json
+3. Runs `npm run sync-marketplace`
+4. Validates both catalog files
+5. Checks for duplicates
+6. Reports success
+
+**Saves you:** 3-5 minutes of manual catalog editing
+
+---
+
+### 4. 🔍 Plugin Auditor
+**Auto-invokes when you mention:**
+- "audit plugin", "security review"
+- "best practices check"
+- "plugin quality"
+
+**Example request:** "Security audit on the password-manager plugin"
+
+**What it automatically does:**
+1. Scans for hardcoded secrets (passwords, API keys)
+2. Checks for dangerous commands (rm -rf, eval)
+3. Validates security patterns
+4. Checks best practices compliance
+5. Verifies CLAUDE.md standards
+6. Generates quality score
+7. Provides recommendations
+
+**Saves you:** 10-15 minutes of manual security review
+
+---
+
+### 5. 🔢 Version Bumper
+**Auto-invokes when you mention:**
+- "bump version", "update version"
+- "release", "new version"
+- "major/minor/patch"
+
+**Example request:** "Bump docker-optimizer to minor version"
+
+**What it automatically does:**
+1. Reads current version from plugin.json
+2. Calculates new version (1.0.0 → 1.1.0)
+3. Updates plugin.json
+4. Updates marketplace.extended.json
+5. Runs `npm run sync-marketplace`
+6. Updates CHANGELOG.md (if exists)
+7. Can create git tags
+8. Reports success
+
+**Saves you:** 5 minutes of manual version updates
+
+---
+
+## How Skills Work
+
+**Skills are MODEL-INVOKED** - Claude automatically decides when to use them.
+
+**Example conversation:**
+
+**You:** "I need a new DevOps plugin for Docker optimization with commands"
+
+**Claude automatically:**
+1. Recognizes "new plugin" → Invokes Plugin Creator
+2. Recognizes "DevOps" → Sets category
+3. Recognizes "with commands" → Creates commands/ directory
+4. Creates plugins/devops/docker-optimizer/
+5. Generates all files
+6. Updates marketplace
+7. Validates
+8. Reports: "✅ Created docker-optimizer plugin!"
+
+**You didn't run any commands** - Claude understood context and did everything!
+
+---
+
+## Skills vs Commands Comparison
+
+| Feature | Skills (This Plugin) | Slash Commands |
+|---------|---------------------|----------------|
+| **Invocation** | Auto (Claude decides) | Manual (/command) |
+| **Trigger** | Keywords in conversation | Explicit command |
+| **Context** | Understands repository | Single purpose |
+| **Workflow** | Chains multiple tasks | Single task |
+| **Example** | "create and validate plugin" | /create then /validate |
+
+**Skills feel natural** - like talking to a teammate who knows the repo!
+
+---
+
+## Real Workflow Examples
+
+### Workflow 1: Create + Validate + Audit
+**You:** "Create a security plugin called 'owasp-scanner', validate it, and run security audit"
+
+**Skills automatically chain:**
+1. Plugin Creator → Creates plugin
+2. Plugin Validator → Validates structure
+3. Plugin Auditor → Security audit
+4. Reports all results
+
+### Workflow 2: Update + Sync
+**You:** "Bump version to 1.2.0 and update marketplace"
+
+**Skills automatically chain:**
+1. Version Bumper → Updates to 1.2.0
+2. Marketplace Manager → Syncs catalog
+3. Reports success
+
+### Workflow 3: Pre-Commit Check
+**You:** "Is everything ready to commit?"
+
+**Skills automatically:**
+1. Plugin Validator → Full validation
+2. Plugin Auditor → Security check
+3. Reports: "✅ PASSED - Ready to commit!"
+
+---
+
+## Repository-Specific Knowledge
+
+Skills Powerkit knows about claude-code-plugins:
+
+**Two-Catalog System:**
+- marketplace.extended.json (source - edit this)
+- marketplace.json (generated - never edit)
+- Auto-runs `npm run sync-marketplace`
+
+**Directory Structure:**
+- plugins/[category]/[plugin-name]/
+- 14 valid categories
+- Required files
+
+**Validation Standards:**
+- ./scripts/validate-all.sh
+- python3 scripts/check-frontmatter.py
+- jq for JSON validation
+
+**CLAUDE.md Compliance:**
+- Follows repository conventions
+- Uses correct marketplace slug
+- Validates against standards
+
+---
+
+## Try It Out!
+
+Test each skill by saying:
+
+1. **"Create a new testing plugin called 'jest-generator'"**
+   → Plugin Creator activates
+
+2. **"Validate the jest-generator plugin"**
+   → Plugin Validator activates
+
+3. **"Add jest-generator to marketplace"**
+   → Marketplace Manager activates
+
+4. **"Security audit on jest-generator"**
+   → Plugin Auditor activates
+
+5. **"Bump jest-generator to version 1.1.0"**
+   → Version Bumper activates
+
+Claude will automatically use the right skill!
+
+---
+
+## Installation
+
+```bash
+/plugin install skills-powerkit@claude-code-plugins-plus
+```
+
+Once installed, all 5 skills are active and auto-invoke when relevant.
+
+---
+
+## Time Savings
+
+**Per plugin lifecycle:**
+- Create: 15-30 min → 30 seconds
+- Validate: 5-10 min → 10 seconds
+- Marketplace: 3-5 min → 5 seconds
+- Audit: 10-15 min → 15 seconds
+- Version: 5 min → 10 seconds
+
+**Total saved: 40-60 minutes per plugin!**
+
+---
+
+## Requirements
+
+- Claude Code CLI with Skills support (Oct 2025+)
+- Working in claude-code-plugins repository
+- Node.js for marketplace sync
+- Python 3 for frontmatter validation
+- jq for JSON validation
+
+---
+
+**Need help?** Just ask:
+- "What skills do I have available?"
+- "How do I create a plugin?"
+- "Validate my current plugin"
+
+Skills will respond automatically! 🚀