Initial commit

skills/insight-skill-generator/workflow/phase-4-generation.md

@@ -0,0 +1,89 @@
+# Phase 4: Skill Generation
+
+**Purpose**: Create all skill files following the approved design.
+
+## Steps
+
+### 1. Prepare generation workspace
+- Create temporary directory for skill assembly
+- Load templates from `templates/` directory
+
+### 2. Generate SKILL.md
+- Create frontmatter with name and description
+- Add h1 heading
+- Generate Overview section (what, based on X insights, capabilities)
+- Generate "When to Use" section (trigger phrases, use cases, anti-use cases)
+- Generate Response Style section
+- Generate workflow sections based on pattern:
+  - Phase-based: Phase 1, Phase 2, etc. with Purpose, Steps, Output, Common Issues
+  - Mode-based: Mode 1, Mode 2, etc. with When to use, Steps, Output
+  - Validation: Analysis → Detection → Recommendations
+- Generate Reference Materials section
+- Generate Important Reminders
+- Generate Best Practices
+- Generate Troubleshooting
+- Add Metadata section with source insight attribution
+
+### 3. Generate README.md
+- Brief overview (1-2 sentences)
+- Installation instructions (standard)
+- Quick start example
+- Trigger phrases list
+- Link to SKILL.md for details
+
+### 4. Generate plugin.json
+```json
+{
+  "name": "[skill-name]",
+  "version": "0.1.0",
+  "description": "[description]",
+  "type": "skill",
+  "author": "Connor",
+  "category": "[category from clustering-config]",
+  "tags": ["insights", "lessons-learned", "[domain]"]
+}
+```
+
+### 5. Generate CHANGELOG.md
+Initialize with v0.1.0 and list key features.
+
+### 6. Generate data/insights-reference.md (if complexity >= standard)
+- Add overview (insight count, date range, categories)
+- For each insight: title, metadata, original content, code examples, related insights
+- Add clustering analysis section
+- Add insight-to-skill mapping explanation
+
+### 7. Generate examples/ (if needed)
+- Extract and organize code blocks by language or topic
+- Add explanatory context
+- Create usage examples showing example prompts and expected behaviors
+
+### 8. Generate templates/ (if needed)
+- Create templates/checklist.md from actionable items
+- Organize items by section
+- Add verification steps
+- Include common mistakes section
+
+### 9. Validate all generated files
+- Check YAML frontmatter syntax
+- Validate JSON syntax
+- Check file references are valid
+- Verify no broken markdown links
+- Run quality checklist
+- Report validation results to user
+
+### 10. Preview generated skill
+- Show file tree
+- Show key sections from SKILL.md
+- Show README.md preview
+- Highlight any validation warnings
+
+## Output
+
+Complete, validated skill in temporary workspace, ready for installation.
+
+## Common Issues
+
+- **Validation failures**: Fix automatically if possible, otherwise ask user
+- **Missing code examples**: Offer to generate placeholder or skip examples/ directory
+- **Large SKILL.md** (>500 lines): Suggest splitting content into separate files