284 lines
7.3 KiB
Markdown
284 lines
7.3 KiB
Markdown
---
|
|
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! 🚀
|