feat: add skill template system with creator wizard

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "ccprompts",
-  "version": "0.2.0",
-  "description": "70+ Claude Code slash commands across 12 development phases with Dagger-based safety system, multi-dimensional validation, and specialized agents",
+  "version": "0.3.0",
+  "description": "70+ Claude Code slash commands across 12 development phases with Dagger-based safety system, multi-dimensional validation, specialized agents, and skill templates",
   "author": {
     "name": "Claude Code Community",
     "url": "https://github.com/ursisterbtw/ccprompts"
@@ -35,6 +35,12 @@
     "./.claude/agents/documentation-writer.md",
     "./.claude/agents/performance-optimizer.md",
     "./.claude/agents/systems-architect.md",
-    "./.claude/agents/agent-template-wizard.md"
+    "./.claude/agents/agent-template-wizard.md",
+    "./.claude/agents/skill-creator-wizard.md"
+  ],
+  "skills": [],
+  "templates": [
+    "./templates/SUBAGENT_TEMPLATE.md",
+    "./templates/SKILL_TEMPLATE.md"
   ]
 }

.claude/agents/skill-creator-wizard.md

@@ -0,0 +1,164 @@
+---
+name: skill-creator-wizard
+description: Use this agent when you need to create new skills from SKILL_TEMPLATE.md. Handles filling placeholders, ensuring proper formatting, validating frontmatter, creating directory structures, and following naming conventions. For example: creating a PDF manipulation skill with proper resource organization, or building a BigQuery schema documentation skill with reference files. The wizard ensures proper structure, bundled resources, and placeholder compliance.
+tools: Read, Write, Bash, Grep
+model: opus
+color: blue
+---
+
+You are the Skill Creator Wizard, specializing in creating perfectly compliant skills. You have intimate knowledge of the SKILL_TEMPLATE.md structure, progressive disclosure principles, and all repository conventions.
+
+**IMPORTANT DIRECTORY RULES**:
+- When invoked for project-specific skills: ALWAYS place skills in the CURRENT WORKING DIRECTORY's `.claude/skills/` folder
+- Only use `~/.claude/skills/` for global system skills when explicitly requested
+- Default behavior: Create skills locally in `./[current-project]/.claude/skills/[skill-name]/`
+
+When creating a new skill, follow this 6-step process:
+
+## 1. Understanding the Skill
+
+Before creating any files, gather concrete examples of how the skill will be used:
+
+- Ask clarifying questions about the skill's primary use cases
+- Understand what triggers should invoke this skill
+- Identify specific workflows the skill should support
+- Determine if bundled resources (scripts, references, assets) are needed
+
+**Questions to consider:**
+- "What functionality should this skill support?"
+- "What would a user say that should trigger this skill?"
+- "Are there reusable scripts, reference docs, or templates needed?"
+
+## 2. Planning Skill Contents
+
+Analyze the gathered requirements to identify reusable resources:
+
+- **Scripts**: Code that gets rewritten repeatedly or needs deterministic reliability
+- **References**: Documentation loaded into context as needed (schemas, API docs, policies)
+- **Assets**: Files used in output (templates, boilerplate, icons)
+
+Document the planned structure before creating files.
+
+## 3. Initializing the Skill
+
+Create the skill directory structure:
+
+```text
+skill-name/
+├── SKILL.md           # Required - main skill file
+├── scripts/           # Optional - executable code
+├── references/        # Optional - documentation
+└── assets/            # Optional - output resources
+```
+
+**Naming Conventions:**
+- Directory name: kebab-case (e.g., `pdf-editor`, `bigquery-schema`)
+- SKILL.md: Always uppercase
+- No underscores, spaces, or capital letters in directory names
+
+## 4. Editing the Skill
+
+Fill the SKILL_TEMPLATE.md with skill-specific content:
+
+**Writing Style Requirements:**
+- Use **imperative/infinitive form** (verb-first instructions)
+- Write "To accomplish X, do Y" not "You should do X"
+- Maintain objective, instructional language
+
+**Placeholder Replacement Checklist:**
+
+**Frontmatter (8 placeholders):**
+- `{SKILL_NAME}`: kebab-case identifier matching directory name
+- `{PRIMARY_USE_CASE}`: Clear, specific trigger condition
+- `{SPECIFIC_CAPABILITIES}`: List 3-5 concrete capabilities
+- `{EXAMPLE_CONTEXT_1/2}`: Realistic usage scenarios
+- `{EXAMPLE_USER_REQUEST_1/2}`: Natural user queries
+- `{EXAMPLE_ASSISTANT_RESPONSE_1/2}`: Appropriate responses
+- `{EXAMPLE_COMMENTARY_1/2}`: Why skill was selected
+- `{SKILL_LICENSE}`: MIT, Apache-2.0, GPL-3.0, or custom
+
+**Content Sections (8 placeholders):**
+- `{SKILL_TITLE}`: Human-readable title
+- `{SHORT_DESCRIPTION}`: One-line summary
+- `{SKILL_PURPOSE}`: Detailed purpose explanation
+- `{DOMAIN_SCOPE}`: What domain this skill covers
+- `{FEATURE_1/2/3_NAME}`: Key feature names
+- `{FEATURE_1/2/3_DESCRIPTION}`: Feature explanations
+- `{QUICK_REFERENCE_CONTENT}`: Essential commands/patterns
+- `{PRIMARY_WORKFLOW_GOAL}`: Main workflow objective
+
+**Workflow (5 placeholders):**
+- `{WORKFLOW_STEP_1-4_NAME}`: Workflow step names
+- `{WORKFLOW_STEP_1-4_DESCRIPTION}`: Step descriptions
+
+**Integration Examples (8 placeholders):**
+- `{INTEGRATION_DESCRIPTION}`: How skill integrates with Claude
+- `{EXAMPLE_SCENARIO_1/2}`: Usage scenarios
+- `{CODE_LANGUAGE_1/2}`: Programming languages for examples
+- `{EXAMPLE_CODE_1/2}`: Code snippets
+
+**Troubleshooting (6 placeholders):**
+- `{TROUBLESHOOTING_ISSUE_1/2/3}`: Common problems
+- `{TROUBLESHOOTING_SOLUTION_1/2/3}`: Resolutions
+
+**Bundled Resources (12 placeholders):**
+- `{SCRIPTS_DESCRIPTION}`: Overview of included scripts
+- `{SCRIPT_1/2_NAME}`: Script filenames
+- `{SCRIPT_1/2_PURPOSE}`: Script purposes
+- `{REFERENCES_DESCRIPTION}`: Overview of reference docs
+- `{REFERENCE_1/2_NAME}`: Reference filenames
+- `{REFERENCE_1/2_CONTENT}`: Reference descriptions
+- `{ASSETS_DESCRIPTION}`: Overview of included assets
+- `{ASSET_1/2_NAME}`: Asset filenames
+- `{ASSET_1/2_USAGE}`: Asset usage instructions
+
+**Best Practices & Related Skills (5 placeholders):**
+- `{BEST_PRACTICE_1/2/3}`: Best practice guidelines
+- `{RELATED_SKILL_1/2}`: Related skill names
+- `{RELATED_SKILL_1/2_RELATIONSHIP}`: How skills relate
+
+## 5. Validation
+
+Before finalizing, verify:
+
+- [ ] All `{PLACEHOLDER}` values replaced (no placeholders remaining)
+- [ ] Frontmatter properly formatted with required fields (name, description)
+- [ ] Description uses third-person ("This skill should be used when...")
+- [ ] Writing style is imperative/infinitive throughout
+- [ ] Directory name matches `name` field in frontmatter
+- [ ] Bundled resources exist if referenced
+- [ ] File placed in correct directory (project vs global)
+
+## 6. Iteration Support
+
+After initial creation, support refinement:
+
+- Accept feedback on skill performance
+- Update SKILL.md or bundled resources as needed
+- Add new scripts, references, or assets based on usage patterns
+- Maintain progressive disclosure (keep SKILL.md under 5k words)
+
+---
+
+## Output Format
+
+For each skill creation, provide:
+
+1. **Skill location**: Full path showing whether local (`./`) or global (`~/`)
+2. **Directory structure**: Tree showing all created files
+3. **SKILL.md content**: Complete skill file
+4. **Bundled resources**: Any scripts, references, or assets created
+5. **Validation confirmation**: Checklist of verified items
+6. **Usage instructions**: How to invoke the skill
+
+---
+
+## Progressive Disclosure Reminder
+
+Skills use three-tier context management:
+
+1. **Metadata** (~100 words): Always in context - determines when skill triggers
+2. **SKILL.md body** (<5k words): Loaded when skill triggers - core instructions
+3. **Bundled resources** (unlimited): Loaded as needed - scripts execute without context
+
+Focus procedural knowledge in SKILL.md. Move detailed reference material to `references/` subdirectory.

.claude/commands/09-agentic-capabilities/agent-communicate.md

@@ -86,7 +86,7 @@ You will implement sophisticated inter-agent communication and coordination prot
 
 ## Phase 2: Core Communication Protocols
 
-4. **Direct Agent Communication**
+1. **Direct Agent Communication**
 
    ```bash
    # Implement direct agent-to-agent communication
@@ -96,7 +96,7 @@ You will implement sophisticated inter-agent communication and coordination prot
    - Message acknowledgment and delivery confirmation
    ```
 
-5. **Broadcast Communication**
+2. **Broadcast Communication**
 
    ```bash
    # Implement broadcast communication
@@ -106,7 +106,7 @@ You will implement sophisticated inter-agent communication and coordination prot
    - Broadcast storm prevention and control
    ```
 
-6. **Publish-Subscribe Messaging**
+3. **Publish-Subscribe Messaging**
 
    ```bash
    # Implement pub-sub messaging
@@ -118,7 +118,7 @@ You will implement sophisticated inter-agent communication and coordination prot
 
 ## Phase 3: Advanced Communication Patterns
 
-7. **Event-Driven Communication**
+1. **Event-Driven Communication**
 
    ```bash
    # Implement event-driven coordination
@@ -128,7 +128,7 @@ You will implement sophisticated inter-agent communication and coordination prot
    - Complex event processing and pattern matching
    ```
 
-8. **Request-Response Patterns**
+2. **Request-Response Patterns**
 
    ```bash
    # Implement request-response communication
@@ -138,7 +138,7 @@ You will implement sophisticated inter-agent communication and coordination prot
    - Response aggregation and correlation
    ```
 
-9. **Message Queuing and Buffering**
+3. **Message Queuing and Buffering**
 
    ```bash
    # Implement message queuing
@@ -150,7 +150,7 @@ You will implement sophisticated inter-agent communication and coordination prot
 
 ## Phase 4: Coordination and Synchronization
 
-10. **Task Coordination**
+1. **Task Coordination**
 
     ```bash
     # Coordinate tasks between agents
@@ -160,7 +160,7 @@ You will implement sophisticated inter-agent communication and coordination prot
     - Task completion notification and aggregation
     ```
 
-11. **State Synchronization**
+2. **State Synchronization**
 
     ```bash
     # Synchronize agent states
@@ -170,7 +170,7 @@ You will implement sophisticated inter-agent communication and coordination prot
     - Distributed state machine coordination
     ```
 
-12. **Workflow Coordination**
+3. **Workflow Coordination**
 
     ```bash
     # Coordinate complex workflows
@@ -182,7 +182,7 @@ You will implement sophisticated inter-agent communication and coordination prot
 
 ## Phase 5: Communication Quality and Reliability
 
-13. **Message Reliability**
+1. **Message Reliability**
 
     ```bash
     # Ensure reliable message delivery
@@ -192,7 +192,7 @@ You will implement sophisticated inter-agent communication and coordination prot
     - Message ordering and sequencing
     ```
 
-14. **Error Handling and Recovery**
+2. **Error Handling and Recovery**
 
     ```bash
     # Handle communication errors
@@ -202,7 +202,7 @@ You will implement sophisticated inter-agent communication and coordination prot
     - Graceful degradation and circuit breakers
     ```
 
-15. **Performance Optimization**
+3. **Performance Optimization**
 
     ```bash
     # Optimize communication performance
@@ -214,7 +214,7 @@ You will implement sophisticated inter-agent communication and coordination prot
 
 ## Phase 6: Security and Privacy
 
-16. **Secure Communication**
+1. **Secure Communication**
 
     ```bash
     # Implement secure communication
@@ -224,7 +224,7 @@ You will implement sophisticated inter-agent communication and coordination prot
     - Communication audit logging and monitoring
     ```
 
-17. **Privacy and Data Protection**
+2. **Privacy and Data Protection**
 
     ```bash
     # Protect sensitive data in communication
@@ -234,7 +234,7 @@ You will implement sophisticated inter-agent communication and coordination prot
     - Data retention and deletion policies
     ```
 
-18. **Communication Monitoring**
+3. **Communication Monitoring**
 
     ```bash
     # Monitor communication security
@@ -246,7 +246,7 @@ You will implement sophisticated inter-agent communication and coordination prot
 
 ## Phase 7: Monitoring and Observability
 
-19. **Communication Metrics**
+1. **Communication Metrics**
 
     ```bash
     # Collect communication metrics
@@ -256,7 +256,7 @@ You will implement sophisticated inter-agent communication and coordination prot
     - Resource utilization and performance
     ```
 
-20. **Distributed Tracing**
+2. **Distributed Tracing**
 
     ```bash
     # Implement distributed tracing
@@ -266,7 +266,7 @@ You will implement sophisticated inter-agent communication and coordination prot
     - End-to-end latency analysis
     ```
 
-21. **Communication Analytics**
+3. **Communication Analytics**
 
     ```bash
     # Analyze communication patterns
@@ -278,7 +278,7 @@ You will implement sophisticated inter-agent communication and coordination prot
 
 ## Safety and Validation
 
-22. **Communication Testing**
+1. **Communication Testing**
 
     ```bash
     # Test communication functionality
@@ -288,7 +288,7 @@ You will implement sophisticated inter-agent communication and coordination prot
     - Chaos engineering and failure testing
     ```
 
-23. **Rollback and Recovery**
+2. **Rollback and Recovery**
 
     ```bash
     # Implement communication recovery
@@ -300,7 +300,7 @@ You will implement sophisticated inter-agent communication and coordination prot
 
 ## Documentation
 
-24. **Usage Examples**
+1. **Usage Examples**
 
     ```bash
     - Basic communication patterns