@soulcraft/kits 1.0.0

package/kits/screenplay-writing/kit.json

@@ -0,0 +1,412 @@
+{
+  "$schema": "https://soulcraft.com/schemas/kit/v2.json",
+  "id": "screenplay-writing",
+  "type": "soulcraft",
+  "role": "primary",
+  "status": "released",
+  "name": "Screenplay Writing",
+  "description": "Professional screenplay workspace with scene breakdown, character arcs, and industry-standard formatting",
+  "longDescription": "Complete screenplay development system with scene cards, character sheets, beat sheets, and act structure. Includes concepts for characters, scenes, and acts that connect in the knowledge graph for easy navigation. Aligned to industry-standard Save the Cat! beat structure.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Soulcraft Labs",
+    "email": "kits@soulcraft.com",
+    "url": "https://soulcraft.com"
+  },
+  "icon": "🎬",
+  "tags": [
+    "screenplay",
+    "film",
+    "script",
+    "creative-writing",
+    "storytelling"
+  ],
+  "variables": [
+    {
+      "key": "projectName",
+      "label": "Screenplay Title",
+      "description": "The title of your screenplay",
+      "type": "string",
+      "required": true,
+      "example": "The Last Sunset"
+    },
+    {
+      "key": "author",
+      "label": "Writer",
+      "description": "Your name as the screenwriter",
+      "type": "string",
+      "required": false,
+      "example": "Your Name",
+      "default": ""
+    },
+    {
+      "key": "genre",
+      "label": "Genre",
+      "description": "Primary genre (Drama, Comedy, Thriller, Sci-Fi, etc.)",
+      "type": "string",
+      "required": false,
+      "example": "Drama"
+    },
+    {
+      "key": "logline",
+      "label": "Logline",
+      "description": "One-sentence pitch for your story",
+      "type": "string",
+      "required": false,
+      "example": "A brief, compelling summary of your screenplay"
+    }
+  ],
+  "shared": {
+    "industry": "filmmaking",
+    "category": "writing",
+    "aiExpertise": [
+      "Screenplay structure and beat sheets",
+      "Character arc development",
+      "Scene writing and pacing",
+      "Dialogue and subtext",
+      "Genre conventions"
+    ],
+    "dataModelHints": [
+      "person",
+      "document",
+      "event",
+      "location",
+      "concept"
+    ],
+    "dataModel": {
+      "entities": [
+        {
+          "domain": "character",
+          "type": "Person",
+          "description": "A character with speaking role, arc, and motivation",
+          "products": {
+            "workshop": {
+              "view": "gallery",
+              "icon": "🎭"
+            },
+            "academy": {
+              "mapsTo": "learning-subject",
+              "assessable": false
+            }
+          }
+        },
+        {
+          "domain": "scene",
+          "type": "Document",
+          "description": "A screenplay scene with action and dialogue",
+          "products": {
+            "workshop": {
+              "view": "board",
+              "icon": "🎬"
+            },
+            "academy": {
+              "mapsTo": "learning-artifact",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "location",
+          "type": "Location",
+          "description": "A physical setting where scenes take place",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "📍"
+            }
+          }
+        },
+        {
+          "domain": "beat",
+          "type": "Concept",
+          "description": "A structural beat in the Save the Cat beat sheet",
+          "products": {
+            "workshop": {
+              "view": "timeline",
+              "icon": "🥁"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "act",
+          "type": "Concept",
+          "description": "An act of the three-act structure",
+          "products": {
+            "workshop": {
+              "view": "timeline",
+              "icon": "📋"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": false
+            }
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "character",
+          "to": "character",
+          "verb": "Conflicts",
+          "description": "Character is in opposition with another"
+        },
+        {
+          "from": "character",
+          "to": "character",
+          "verb": "RelatedTo",
+          "description": "Character relationship or bond"
+        },
+        {
+          "from": "scene",
+          "to": "character",
+          "verb": "Contains",
+          "description": "Scene features this character"
+        },
+        {
+          "from": "scene",
+          "to": "location",
+          "verb": "LocatedAt",
+          "description": "Scene takes place in this setting"
+        },
+        {
+          "from": "scene",
+          "to": "beat",
+          "verb": "InstanceOf",
+          "description": "Scene fulfils this structural beat"
+        }
+      ]
+    },
+    "suggestions": [
+      {
+        "label": "Write a scene",
+        "prompt": "Help me write the next scene in my screenplay"
+      },
+      {
+        "label": "Develop a character",
+        "prompt": "Help me develop a character profile for my screenplay"
+      },
+      {
+        "label": "Outline an act",
+        "prompt": "Help me outline the structure of an act"
+      },
+      {
+        "label": "Write dialogue",
+        "prompt": "Help me write natural, compelling dialogue for a scene"
+      },
+      {
+        "label": "Check pacing",
+        "prompt": "Analyze my screenplay's pacing and suggest improvements"
+      },
+      {
+        "label": "View story structure",
+        "prompt": "Show me my screenplay structure in the timeline view"
+      }
+    ]
+  },
+  "academy": {
+    "skillPath": "screenwriting",
+    "level": "intermediate",
+    "learningObjectives": [
+      "Complete a Save the Cat beat sheet with all 15 beats and justified page ranges",
+      "Write a scene in industry-standard format that advances plot and reveals character simultaneously",
+      "Craft dialogue with distinct character voice and subtext that avoids on-the-nose exposition",
+      "Develop a protagonist whose external want and internal need are in direct conflict",
+      "Rewrite a scene to cut page count by 30% without losing story information"
+    ],
+    "assessmentTypes": [
+      "portfolio",
+      "peer-review"
+    ],
+    "certificationSlug": "screenwriter"
+  },
+  "workshop": {
+    "difficulty": "intermediate",
+    "templateTier": 4,
+    "aiPersona": {
+      "role": "You are a professional screenwriter and story consultant helping writers develop compelling screenplays using industry-standard structure, character development, and scene craft.",
+      "expertise": [
+        "Screenplay structure (Save the Cat!, McKee)",
+        "Character arc development",
+        "Scene writing and pacing",
+        "Dialogue and subtext",
+        "Genre conventions and expectations"
+      ],
+      "tone": "collaborator"
+    },
+    "workspaceConfig": {
+      "paradigm": "writer",
+      "defaultTab": "edit",
+      "defaultView": "timeline",
+      "defaultFile": "script/act-1/scene-01.md",
+      "fallbackFiles": [
+        "planning/treatment.md",
+        "README.md"
+      ],
+      "layout": {
+        "leftDock": "files",
+        "rightDock": "properties"
+      },
+      "onboarding": {
+        "showGuide": true,
+        "highlightFeatures": [
+          "timeline",
+          "graph",
+          "ai-chat"
+        ],
+        "suggestedActions": [
+          "Start with the treatment in planning/treatment.md",
+          "Develop characters using the template",
+          "Use Timeline view to visualize scene flow",
+          "Ask AI for dialogue and scene suggestions"
+        ]
+      }
+    },
+    "graphGuidance": {
+      "conceptCreation": {
+        "triggers": [
+          "When user creates a character",
+          "When user describes a scene",
+          "When user mentions a location",
+          "When user outlines a beat or sequence"
+        ],
+        "typeMapping": {
+          "character": "person",
+          "scene": "document",
+          "location": "location",
+          "beat": "concept",
+          "act": "concept"
+        }
+      },
+      "relationshipPatterns": [
+        {
+          "from": "person",
+          "to": "person",
+          "verb": "conflicts",
+          "description": "Character opposition"
+        },
+        {
+          "from": "person",
+          "to": "person",
+          "verb": "relatedTo",
+          "description": "Character relationship"
+        },
+        {
+          "from": "document",
+          "to": "person",
+          "verb": "contains",
+          "description": "Scene features character"
+        },
+        {
+          "from": "document",
+          "to": "location",
+          "verb": "locatedAt",
+          "description": "Scene setting"
+        },
+        {
+          "from": "document",
+          "to": "concept",
+          "verb": "instanceOf",
+          "description": "Scene belongs to beat"
+        }
+      ],
+      "rules": [
+        "Create person entities for characters with speaking roles",
+        "Link scenes to their locations and characters",
+        "Track scene order and act placement",
+        "Note character relationships and conflicts"
+      ]
+    },
+    "qualityGates": {
+      "fileChecks": [
+        {
+          "path": "planning/beat-sheet.md",
+          "required": [
+            "Opening Image",
+            "Catalyst",
+            "Midpoint",
+            "All Is Lost",
+            "Finale"
+          ],
+          "optional": [
+            "Theme Stated",
+            "B Story"
+          ]
+        },
+        {
+          "path": "characters/protagonist.md",
+          "required": [
+            "Name",
+            "Want",
+            "Need"
+          ],
+          "optional": [
+            "Backstory",
+            "Voice Notes"
+          ]
+        }
+      ],
+      "projectChecks": [
+        "Beat sheet has all major beats filled in",
+        "Protagonist has clear want and need defined",
+        "At least one scene exists for each act",
+        "Antagonist has believable motivation"
+      ],
+      "exportReady": [
+        "All beat sheet beats are complete",
+        "Character arcs are defined",
+        "Script pages exist for key scenes"
+      ]
+    },
+    "sampleData": {
+      "description": "Sample screenplay structure for a thriller film",
+      "entities": [
+        {
+          "type": "person",
+          "name": "Sarah Chen",
+          "properties": {
+            "role": "protagonist",
+            "age": 35,
+            "occupation": "FBI Cyber Crimes Agent",
+            "want": "Catch the hacker who destroyed her career",
+            "need": "Learn to trust her instincts again",
+            "description": "Brilliant but disgraced agent seeking redemption.",
+            "status": "main"
+          }
+        },
+        {
+          "type": "person",
+          "name": "Marcus Webb",
+          "properties": {
+            "role": "antagonist",
+            "age": 40,
+            "occupation": "Tech CEO",
+            "motivation": "Expose government surveillance overreach",
+            "description": "Idealistic hacker turned corporate titan with a secret.",
+            "status": "main"
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "Sarah Chen",
+          "verb": "conflicts",
+          "to": "Marcus Webb"
+        }
+      ]
+    },
+    "deploy": {
+      "provider": "cloud-run",
+      "buildCommand": "npm run build",
+      "outputDir": "build",
+      "config": {
+        "port": 3000,
+        "memory": "512Mi"
+      },
+      "oneClickCommand": "gcloud run deploy"
+    }
+  }
+}

package/kits/screenplay-writing/skills/analyze-scene/SKILL.md

@@ -0,0 +1,42 @@
+---
+id: analyze-scene
+name: Analyze Scene
+description: Review a scene for conflict, pacing, purpose, and craft
+version: "1.0.0"
+type: invocable
+parameters: [scenePath]
+requiresVision: true
+requiresData: false
+---
+
+## Analyze Scene
+
+Review a scene for conflict, pacing, purpose, and craft
+
+### Steps
+
+1. Read the scene carefully
+2. Identify the scene's purpose - what story function does it serve?
+3. Check for conflict - what does each character want? What's the obstacle?
+4. Evaluate the dialogue for subtext - are characters saying what they mean?
+5. Assess visual storytelling - could anything be shown instead of told?
+6. Check pacing - does it enter late and leave early?
+7. Review character voice - do characters sound distinct?
+8. Identify the scene's emotional turn - how does it shift?
+9. Provide specific, actionable improvement suggestions
+
+### Inputs Required
+
+- **scenePath** (required): Path to the scene file
+
+### Expected Outputs
+
+- Scene analysis with suggestions
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "analyze scene"
+- "review scene"
+- "scene feedback"
+- "is this scene working"

package/kits/screenplay-writing/skills/beat-sheet/SKILL.md

@@ -0,0 +1,134 @@
+---
+id: beat-sheet
+name: beat-sheet
+description: Generate or analyze screenplay structure using Save the Cat! beat sheet and three-act structure. Use /beats to create a beat sheet for your story.
+version: "1.0.0"
+type: invocable
+parameters: [story premise or existing outline]
+requiresVision: true
+requiresData: false
+---
+
+## Beat Sheet Generator
+
+Help writers structure their screenplays using the Save the Cat! beat sheet methodology.
+
+### Save the Cat! 15 Beats
+
+When generating a beat sheet, include all 15 beats with page targets for a 110-page screenplay:
+
+| Beat | Page | Purpose |
+|------|------|---------|
+| **1. Opening Image** | 1 | Visual that sets tone, shows "before" state |
+| **2. Theme Stated** | 5 | Someone states the theme (hero often misses it) |
+| **3. Setup** | 1-10 | Introduce hero, their world, what's missing |
+| **4. Catalyst** | 12 | Life-changing event that starts the journey |
+| **5. Debate** | 12-25 | Hero hesitates, weighs options |
+| **6. Break into Two** | 25 | Hero makes a choice, enters Act 2 |
+| **7. B Story** | 30 | Introduce subplot (often love story, carries theme) |
+| **8. Fun and Games** | 30-55 | Promise of the premise, what we came to see |
+| **9. Midpoint** | 55 | False victory or false defeat, stakes raise |
+| **10. Bad Guys Close In** | 55-75 | External pressure + internal doubts increase |
+| **11. All Is Lost** | 75 | Lowest point, whiff of death |
+| **12. Dark Night of the Soul** | 75-85 | Hero processes loss, finds inner strength |
+| **13. Break into Three** | 85 | Solution emerges, often from B story |
+| **14. Finale** | 85-110 | Hero confronts flaw, defeats antagonist |
+| **15. Final Image** | 110 | Visual proof of change, mirrors opening |
+
+### When User Invokes /beats
+
+1. **If given a premise**: Generate a complete beat sheet tailored to the story
+2. **If given an outline**: Analyze it against the beat structure, identify missing/weak beats
+3. **If no input**: Ask clarifying questions about genre, protagonist, central conflict
+
+### Beat Sheet Template Output
+
+```markdown
+# Beat Sheet: [TITLE]
+
+**Genre:** [Genre]
+**Logline:** [One-sentence summary]
+
+---
+
+## ACT ONE (Pages 1-25)
+
+### 1. Opening Image (p. 1)
+[Specific visual that establishes tone and "before" state]
+
+### 2. Theme Stated (p. 5)
+[Dialogue or moment where theme is expressed]
+
+### 3. Setup (pp. 1-10)
+[Hero's ordinary world, flaws, what's missing]
+- **Hero:** [Name, role, flaw]
+- **Stasis = Death:** [What will happen if hero doesn't change]
+
+### 4. Catalyst (p. 12)
+[The inciting incident that disrupts the status quo]
+
+### 5. Debate (pp. 12-25)
+[Hero's hesitation, what's at stake]
+
+### 6. Break into Two (p. 25)
+[The choice that launches the hero into Act 2]
+
+---
+
+## ACT TWO (Pages 25-85)
+
+### 7. B Story (p. 30)
+[Subplot introduction, often carries theme]
+
+### 8. Fun and Games (pp. 30-55)
+[Promise of the premise - the scenes that sell the movie]
+- [Key sequence 1]
+- [Key sequence 2]
+- [Key sequence 3]
+
+### 9. Midpoint (p. 55)
+[False victory OR false defeat that raises stakes]
+
+### 10. Bad Guys Close In (pp. 55-75)
+[External enemies regroup, internal team fractures]
+
+### 11. All Is Lost (p. 75)
+[Lowest point, opposite of midpoint, whiff of death]
+
+### 12. Dark Night of the Soul (pp. 75-85)
+[Hero mourns, then finds inner strength]
+
+### 13. Break into Three (p. 85)
+[Solution emerges, often from B story insight]
+
+---
+
+## ACT THREE (Pages 85-110)
+
+### 14. Finale (pp. 85-110)
+[Five-point finale structure:]
+1. **Gathering the Team:** [Hero prepares]
+2. **Executing the Plan:** [Initial attempt]
+3. **High Tower Surprise:** [Unexpected obstacle]
+4. **Dig Deep Down:** [Hero uses lesson learned]
+5. **Execution of New Plan:** [Victory through transformation]
+
+### 15. Final Image (p. 110)
+[Mirror of opening, proof of change]
+```
+
+### Genre-Specific Considerations
+
+**Action/Adventure:** Emphasize set pieces in Fun and Games
+**Comedy:** B Story often IS the love story
+**Horror:** All Is Lost = biggest scare, hero survives
+**Drama:** Internal transformation over external conflict
+**Thriller:** Midpoint revelation changes everything
+
+### Common Beat Sheet Problems
+
+1. **Weak Catalyst**: Must be external and unavoidable
+2. **Missing Theme**: Should be stated by page 5
+3. **Saggy Midpoint**: Needs to truly shift the story
+4. **Rushed Dark Night**: Give hero time to process
+5. **No B Story Payoff**: Theme should culminate here

package/kits/screenplay-writing/skills/create-scene-card/SKILL.md

@@ -0,0 +1,46 @@
+---
+id: create-scene-card
+name: Create Scene Card
+description: Create a new scene card with proper structure
+version: "1.0.0"
+type: invocable
+parameters: [actNumber, sceneName]
+requiresVision: false
+requiresData: false
+---
+
+## Create Scene Card
+
+Create a new scene card with proper structure
+
+### Steps
+
+1. Ask about the scene's location (INT/EXT)
+2. Ask about time of day
+3. Ask which characters are present
+4. Ask about the scene's purpose in the story
+5. Ask about the central conflict
+6. Create the scene card file in the appropriate act folder
+7. Add the scene as a concept in the knowledge graph
+8. Link characters to the scene
+
+### Inputs Required
+
+- **actNumber** (required): Which act (1, 2, or 3)
+- **sceneName** (required): Brief scene name/description
+
+### Expected Outputs
+
+- New scene card file
+- Scene concept in graph
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "new scene"
+- "add scene"
+- "create scene"
+
+### Execution Mode
+
+This workflow can be executed automatically when triggered. Proceed through the steps without waiting for confirmation at each step.

package/kits/screenplay-writing/skills/develop-character/SKILL.md

@@ -0,0 +1,43 @@
+---
+id: develop-character
+name: Develop Character
+description: Deep dive into a character's psychology, motivation, and arc
+version: "1.0.0"
+type: invocable
+parameters: [characterName]
+requiresVision: false
+requiresData: false
+---
+
+## Develop Character
+
+Deep dive into a character's psychology, motivation, and arc
+
+### Steps
+
+1. Review the existing character file to understand current state
+2. Ask about the character's WANT (conscious external goal)
+3. Ask about the character's NEED (unconscious internal goal)
+4. Identify THE LIE the character believes at the start
+5. Explore the GHOST - what backstory wound created this lie?
+6. Map their arc: how do they change from believing the lie to learning the truth?
+7. Define their relationship to other characters
+8. Update the character file with these insights
+
+### Inputs Required
+
+- **characterName** (required): Which character to develop
+
+### Expected Outputs
+
+- Updated character file
+- Character arc summary
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "develop character"
+- "character arc"
+- "motivation"
+- "backstory"
+- "who is"