@looplia/looplia-cli 0.6.6

package/plugins/looplia-writer/skills/writing-kit-assembler/SKILL.md

@@ -0,0 +1,206 @@
+---
+name: writing-kit-assembler
+description: |
+  Looplia writer skill for assembling final writing kits.
+  Combines content analysis and ideas into structured output with suggested outlines.
+  Creates comprehensive WritingKit JSON with all components.
+tools: Read, Write
+---
+
+# Writing Kit Assembler Skill
+
+Assemble comprehensive writing kits from analysis and ideas.
+
+## Purpose
+
+Combine outputs from earlier workflow steps into a final, actionable writing kit:
+- Content summary and metadata
+- Generated ideas (hooks, angles, questions)
+- Suggested outline with sections
+- Supporting quotes and references
+
+## Process
+
+### Step 1: Read Analysis
+
+Read content analysis JSON (first input):
+- contentId
+- source metadata
+- summary (headline, tldr, bullets)
+- keyThemes
+- importantQuotes
+- coreIdeas
+
+### Step 2: Read Ideas
+
+Read idea synthesis JSON (second input):
+- hooks
+- angles
+- questions
+- personalization context
+
+### Step 3: Create Suggested Outline
+
+Design a structured outline:
+
+```
+Introduction
+├── Hook (from ideas)
+├── Context/Background
+└── Thesis/Main Point
+
+Body Sections (3-5)
+├── Section 1: {Theme from analysis}
+│   ├── Key point
+│   ├── Supporting quote
+│   └── Transition
+├── Section 2: {Theme from analysis}
+│   └── ...
+└── Section N: {Theme from analysis}
+
+Conclusion
+├── Summary of key points
+├── Call to action (from angles)
+└── Closing thought
+```
+
+### Step 4: Map Content to Sections
+
+For each body section:
+1. Choose a key theme from analysis
+2. Identify supporting quotes
+3. Connect to relevant ideas/angles
+4. Write section summary
+
+### Step 5: Assemble WritingKit
+
+Combine all components into final structure.
+
+### Step 6: Write Output
+
+Output complete WritingKit JSON.
+
+## Input
+
+Two input files:
+1. Analysis JSON from media-reviewer
+2. Ideas JSON from idea-synthesis
+
+## Output Schema
+
+```json
+{
+  "contentId": "string",
+  "source": {
+    "type": "video|audio|article|transcript",
+    "title": "Original content title",
+    "url": "Source URL if available",
+    "creator": "Author/creator name"
+  },
+  "summary": {
+    "headline": "One compelling sentence",
+    "tldr": "3-5 sentence summary",
+    "bullets": ["Key point 1", "Key point 2", "Key point 3"],
+    "keyThemes": ["theme1", "theme2"],
+    "importantQuotes": [
+      {
+        "text": "Exact quote from source",
+        "timestamp": "12:34",
+        "context": "What was being discussed"
+      }
+    ]
+  },
+  "ideas": {
+    "hooks": [
+      { "text": "Hook text", "type": "question" }
+    ],
+    "angles": [
+      { "perspective": "...", "approach": "..." }
+    ],
+    "questions": [
+      { "text": "...", "depth": "medium" }
+    ]
+  },
+  "suggestedOutline": {
+    "title": "Suggested article title",
+    "sections": [
+      {
+        "heading": "Introduction",
+        "type": "intro",
+        "points": ["Hook with question", "Establish context", "Preview main argument"],
+        "suggestedHook": "What if...?"
+      },
+      {
+        "heading": "Section title based on theme",
+        "type": "body",
+        "points": ["Main point", "Evidence/quote", "Analysis"],
+        "supportingQuote": {
+          "text": "Quote from source",
+          "timestamp": "5:23"
+        },
+        "theme": "Related theme from analysis"
+      },
+      {
+        "heading": "Conclusion",
+        "type": "conclusion",
+        "points": ["Summarize key insights", "Call to action", "Final thought"],
+        "suggestedAngle": "Skeptic's view"
+      }
+    ]
+  },
+  "meta": {
+    "generatedAt": "2025-01-15T10:30:00Z",
+    "workflowVersion": "2.0.0",
+    "stepsCompleted": ["analyze-content", "generate-ideas", "build-writing-kit"]
+  }
+}
+```
+
+## Outline Design Guidelines
+
+### Introduction Section
+- Start with a hook from ideas
+- Establish why this matters
+- Preview the structure
+
+### Body Sections (3-5)
+- One theme per section
+- Include supporting quote when available
+- Build logical progression
+- Connect to angles where relevant
+
+### Conclusion Section
+- Summarize (don't repeat)
+- Include call to action
+- End with memorable thought
+
+## Section Mapping
+
+| Analysis Component | Outline Usage |
+|--------------------|---------------|
+| keyThemes | Body section headings |
+| importantQuotes | Section supporting quotes |
+| coreIdeas | Section key points |
+| hooks | Introduction opener |
+| angles | Body perspectives, conclusion CTA |
+| questions | Section discussion points |
+
+## Quality Checklist
+
+Before outputting:
+- [ ] All required fields present
+- [ ] contentId matches across inputs
+- [ ] At least 3 body sections
+- [ ] Each body section has heading and points
+- [ ] Quotes are properly attributed
+- [ ] Meta includes timestamp
+- [ ] JSON is valid
+
+## Important Rules
+
+1. **Include all components** - Don't omit summary, ideas, or outline
+2. **Preserve quotes exactly** - Never paraphrase
+3. **Keep timestamps** - If input has them, output has them
+4. **Match contentId** - Same ID across all components
+5. **Design actionable outlines** - Writer should be able to start immediately
+6. **Use sonnet model** - This requires synthesis and organization

package/plugins/looplia-writer/workflows/writing-kit.md

@@ -0,0 +1,134 @@
+---
+name: writing-kit
+version: 1.1.0
+description: Transform content into structured writing kit with summary, ideas, and outline
+
+steps:
+  - id: summary
+    skill: media-reviewer
+    mission: |
+      Deep analysis of content to extract key themes, concepts, and narrative structure.
+      Extract minimum 3 verbatim quotes with context, at least 5 key bullet points,
+      and analyze the narrative flow. Identify related concepts for exploration.
+    input: ${{ sandbox }}/inputs/content.md
+    output: ${{ sandbox }}/outputs/summary.json
+    validate:
+      required_fields: [contentId, headline, tldr, bullets, tags, sentiment, category, overview, keyThemes, detailedAnalysis, narrativeFlow, coreIdeas, importantQuotes, context, relatedConcepts]
+      min_quotes: 3
+      min_key_points: 5
+
+  - id: ideas
+    skill: idea-synthesis
+    mission: |
+      Generate creative writing ideas, hooks, and angles based on the content summary.
+      Create 5 types of hooks: emotional, curiosity, controversy, statistic, and story.
+      Develop multiple narrative angles with relevance scores.
+      Generate exploratory questions by type (analytical, practical, philosophical, comparative).
+    needs: [summary]
+    input: ${{ steps.summary.output }}
+    output: ${{ sandbox }}/outputs/ideas.json
+    validate:
+      required_fields: [contentId, hooks, angles, questions]
+      has_hooks: true
+
+  - id: writing-kit
+    skill: writing-kit-assembler
+    mission: |
+      Assemble final writing kit combining summary and ideas.
+      Create structured outline with estimated word counts.
+      Include meta information (difficulty, time to write, audience).
+      Calculate relevance scores based on user profile.
+    needs: [summary, ideas]
+    input:
+      - ${{ steps.summary.output }}
+      - ${{ steps.ideas.output }}
+    output: ${{ sandbox }}/outputs/writing-kit.json
+    final: true
+    validate:
+      required_fields: [contentId, source, summary, ideas, suggestedOutline, meta]
+      min_outline_sections: 4
+      has_hooks: true
+---
+
+# Writing Kit Workflow
+
+Transform raw content into a comprehensive writing kit with summary, creative ideas, and suggested outlines.
+
+## Pipeline Overview
+
+```
+content.md
+    │
+    ▼
+┌─────────────────────┐
+│   media-reviewer    │  Step 1: Deep content analysis
+│   (summary.json)    │
+└──────────┬──────────┘
+           │
+           ▼
+┌─────────────────────┐
+│   idea-synthesis    │  Step 2: Generate creative hooks and angles
+│   (ideas.json)      │
+└──────────┬──────────┘
+           │
+           ▼
+┌─────────────────────────┐
+│ writing-kit-assembler   │  Step 3: Assemble final writing kit
+│ (writing-kit.json)      │
+└─────────────────────────┘
+```
+
+## Step Details
+
+### Step 1: Summary (media-reviewer)
+
+Deep analysis of content to extract:
+- Key themes and concepts
+- Minimum 3 verbatim quotes with context
+- At least 5 key bullet points
+- Narrative flow analysis
+- Related concepts for exploration
+
+### Step 2: Ideas (idea-synthesis)
+
+Generate creative writing inspiration:
+- 5 types of hooks: emotional, curiosity, controversy, statistic, story
+- Multiple narrative angles with relevance scores
+- Exploratory questions by type (analytical, practical, philosophical, comparative)
+
+### Step 3: Writing Kit (writing-kit-assembler)
+
+Assemble final kit with:
+- Structured outline with estimated word counts
+- All components from previous steps
+- Meta information (difficulty, time to write, audience)
+- Relevance scores based on user profile
+
+## Quality Standards
+
+1. **Accuracy**: Preserve original meaning without paraphrasing
+2. **Completeness**: Cover all major themes and ideas
+3. **Relevance**: Tailor output to user's interests and writing style
+4. **Creativity**: Provide diverse hooks and angles for inspiration
+
+## User Profile Integration
+
+Read `user-profile.json` from workspace root to personalize:
+- Calculate relevance scores based on user's topics of interest
+- Adjust writing tone to match user's preferred style
+- Target word count based on user's typical article length
+
+## Validation Criteria
+
+| Step | Skill | Required Fields | Additional Checks |
+|------|-------|-----------------|-------------------|
+| summary | media-reviewer | contentId, headline, tldr, bullets... | min_quotes: 3, min_key_points: 5 |
+| ideas | idea-synthesis | contentId, hooks, angles, questions | has_hooks: true |
+| writing-kit | writing-kit-assembler | contentId, source, summary, ideas... | min_outline_sections: 4 |
+
+## Error Handling
+
+If validation fails:
+1. Review the failed checks in validation result
+2. Retry the skill-executor with specific feedback
+3. Report to user if retry also fails