@soulcraft/kits 1.0.0

package/kits/reading-tracker/skills/reading-insights/SKILL.md

@@ -0,0 +1,179 @@
+---
+id: reading-insights
+name: reading-insights
+description: Generate insights from reading history and patterns
+version: "1.0.0"
+type: invocable
+requiresVision: true
+requiresData: false
+---
+
+## Reading Insights Skill
+
+When the user invokes `/insights`, help them analyze their reading history to discover patterns and generate actionable insights.
+
+### Invocation Patterns
+
+- `/insights` - Full reading analysis
+- `/insights year` - This year's reading analysis
+- `/insights genre [genre]` - Genre-specific insights
+- `/insights growth` - Learning/growth analysis
+
+### Analysis Dimensions
+
+**Quantity Metrics**
+- Books completed
+- Pages/words read
+- Reading pace
+- DNF (did not finish) rate
+
+**Quality Metrics**
+- Ratings distribution
+- Memorable books
+- Re-read frequency
+- Recommendation rate
+
+**Diversity Metrics**
+- Genre spread
+- Author diversity
+- Publication date range
+- Format variety
+
+### Output Format
+
+```markdown
+## Reading Insights: [Time Period]
+
+### Overview
+- **Books read**: X
+- **Average rating**: X.X/5
+- **Total pages**: ~X
+- **Reading pace**: X books/month
+
+### Reading Patterns
+
+#### Genre Distribution
+| Genre | Count | % | Avg Rating |
+|-------|-------|---|------------|
+| [Genre 1] | X | X% | X.X |
+| [Genre 2] | X | X% | X.X |
+
+#### Monthly Trend
+```
+Books │
+  8   │       █
+  6   │   █   █   █
+  4   │ █ █ █ █ █ █
+  2   │ █ █ █ █ █ █ █
+      └─────────────────
+        J F M A M J J...
+```
+
+### Top Rated Books
+1. **[Title]** by [Author] - ⭐ [Rating]
+   - Why it resonated: [Brief note]
+2. [Continue...]
+
+### Reading Themes
+
+**Dominant Themes This Period**
+1. [Theme]: [Books that explored this]
+2. [Theme]: [Books that explored this]
+
+**Emerging Interests**
+- [New topic/genre you're exploring]
+- [Pattern in recent reads]
+
+### Growth Analysis
+
+**Knowledge Deepened In**
+- [Subject 1]: [Books that built expertise]
+- [Subject 2]: [Books that built expertise]
+
+**New Territory Explored**
+- [First book in new genre/topic]
+- [Expansion of comfort zone]
+
+### Reading Velocity
+
+| Period | Books | Avg Days/Book |
+|--------|-------|---------------|
+| Q1 | X | X days |
+| Q2 | X | X days |
+
+**Factors Affecting Pace**
+- [Observation about reading speed]
+
+### DNF Analysis
+- **DNF count**: X
+- **Common reasons**: [Why you quit books]
+- **Pattern**: [Any genre/type you consistently DNF]
+
+### Recommendations
+
+**Based on Your History**
+You tend to love books that are [characteristic]. Consider:
+- [Book suggestion 1]: [Why]
+- [Book suggestion 2]: [Why]
+
+**Gaps to Fill**
+- You haven't read much [genre/topic] - consider exploring
+- [Author] would fit your taste based on [pattern]
+
+### Goals & Progress
+
+**If goals set**:
+- Goal: X books | Progress: Y (Z%)
+- Genre goals: [Progress]
+
+**Suggested Goals**
+Based on patterns, consider:
+- Read X books from [underexplored area]
+- Try [format you haven't explored]
+```
+
+### Pattern Recognition
+
+**What to Look For**
+- Seasonal reading habits
+- Preferred book lengths
+- Rating consistency
+- Author loyalty
+- Format preferences
+
+**Questions to Ask**
+- What books do I rate highest?
+- What makes me DNF?
+- When do I read most?
+- What's my comfort zone?
+- Where am I growing?
+
+### Goal Setting Based on Insights
+
+**Quantity Goals**
+- Based on past pace
+- Realistic stretch
+
+**Quality Goals**
+- Read more highly-rated books
+- Reduce DNF rate
+- More intentional selection
+
+**Diversity Goals**
+- New genres to explore
+- Author diversity
+- Time period variety
+- Format experimentation
+
+### Visualization Ideas
+
+**Track Over Time**
+- Books per month/year
+- Genre evolution
+- Rating trends
+- Page count trends
+
+**Compare & Contrast**
+- Fiction vs. non-fiction ratio
+- New authors vs. favorites
+- Library vs. owned

package/kits/reading-tracker/skills/save-quote/SKILL.md

@@ -0,0 +1,30 @@
+---
+id: save-quote
+name: Save Quote
+description: Save a memorable quote from a book
+version: "1.0.0"
+type: invocable
+requiresVision: false
+requiresData: false
+---
+
+## Save Quote
+
+Save a memorable quote from a book
+
+### Steps
+
+1. Create content entity for quote
+2. Link to source book with page number
+3. Optionally link to related themes
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "save quote"
+- "add quote"
+- "memorable passage"
+
+### Execution Mode
+
+This workflow can be executed automatically when triggered. Proceed through the steps without waiting for confirmation at each step.

package/kits/recipe-manager/kit.json

@@ -0,0 +1,376 @@
+{
+  "$schema": "https://soulcraft.com/schemas/kit/v2.json",
+  "id": "recipe-manager",
+  "type": "soulcraft",
+  "role": "primary",
+  "status": "released",
+  "name": "Recipe Manager",
+  "description": "Recipe collection with meal planning, ingredient tracking, and shopping lists",
+  "longDescription": "Build a recipe collection and meal planning app with beautiful gallery views. Link recipes to ingredients, plan weekly meals on a calendar, auto-generate shopping lists, and filter by dietary tags. Uses Brainy for document, thing, event, and topic entity modeling.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Soulcraft Labs",
+    "email": "kits@soulcraft.com",
+    "url": "https://soulcraft.com"
+  },
+  "icon": "🍳",
+  "tags": [
+    "recipes",
+    "cooking",
+    "meal-planning",
+    "ingredients",
+    "brainy",
+    "sveltekit"
+  ],
+  "variables": [
+    {
+      "key": "appName",
+      "label": "App Name",
+      "description": "The name of your recipe manager app",
+      "type": "string",
+      "required": true,
+      "example": "my-recipes"
+    },
+    {
+      "key": "description",
+      "label": "Description",
+      "description": "A short description of your recipe collection",
+      "type": "string",
+      "required": false,
+      "example": "My recipe collection",
+      "default": "A beautiful recipe manager and meal planner"
+    }
+  ],
+  "shared": {
+    "industry": "food-cooking",
+    "category": "creative",
+    "aiExpertise": [
+      "Recipe creation and scaling",
+      "Ingredient substitutions",
+      "Meal planning and nutrition",
+      "Cuisine exploration",
+      "Shopping list optimization"
+    ],
+    "dataModelHints": [
+      "document",
+      "thing",
+      "event",
+      "topic"
+    ],
+    "dataModel": {
+      "entities": [
+        {
+          "domain": "recipe",
+          "type": "Document",
+          "description": "A recipe with ingredients, instructions, and metadata",
+          "products": {
+            "workshop": {
+              "view": "gallery",
+              "icon": "🍳"
+            },
+            "academy": {
+              "mapsTo": "learning-artifact",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "ingredient",
+          "type": "Thing",
+          "description": "A food ingredient used in one or more recipes",
+          "products": {
+            "workshop": {
+              "view": "gallery",
+              "icon": "🥕"
+            },
+            "academy": {
+              "mapsTo": "resource",
+              "assessable": false
+            }
+          }
+        },
+        {
+          "domain": "meal",
+          "type": "Event",
+          "description": "A planned meal on the calendar using one or more recipes",
+          "products": {
+            "workshop": {
+              "view": "timeline",
+              "icon": "🍽️"
+            },
+            "academy": {
+              "mapsTo": "practice-session",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "tag",
+          "type": "Concept",
+          "description": "A dietary or cuisine tag such as Vegan or Italian",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "🏷️"
+            },
+            "academy": {
+              "mapsTo": "knowledge-unit",
+              "assessable": false
+            }
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "recipe",
+          "to": "ingredient",
+          "verb": "Contains",
+          "description": "Recipe requires this ingredient"
+        },
+        {
+          "from": "ingredient",
+          "to": "ingredient",
+          "verb": "Transforms",
+          "description": "Ingredient can substitute for another"
+        },
+        {
+          "from": "meal",
+          "to": "recipe",
+          "verb": "Uses",
+          "description": "Meal is prepared using this recipe"
+        },
+        {
+          "from": "tag",
+          "to": "recipe",
+          "verb": "Categorizes",
+          "description": "Tag applied to this recipe"
+        }
+      ]
+    },
+    "suggestions": [
+      {
+        "label": "Add a recipe",
+        "prompt": "Help me add a new recipe to my collection"
+      },
+      {
+        "label": "Plan a meal",
+        "prompt": "Help me plan meals for this week using recipes in my collection"
+      },
+      {
+        "label": "Find by ingredient",
+        "prompt": "What recipes can I make with ingredients I have on hand?"
+      },
+      {
+        "label": "Scale a recipe",
+        "prompt": "Help me scale a recipe for a different number of servings"
+      },
+      {
+        "label": "Organize by cuisine",
+        "prompt": "Help me organize my recipes by cuisine type"
+      },
+      {
+        "label": "Browse recipes",
+        "prompt": "Show me my recipe collection in the gallery view"
+      }
+    ]
+  },
+  "academy": {
+    "skillPath": "culinary-arts",
+    "level": "beginner",
+    "learningObjectives": [
+      "Write a recipe with ingredient quantities, preparation steps, and timing accurate enough to reproduce",
+      "Identify viable ingredient substitutions and explain how they affect flavour and texture",
+      "Plan a weekly meal calendar that minimises food waste through shared ingredients",
+      "Scale a recipe up or down and recalculate seasoning ratios correctly"
+    ],
+    "assessmentTypes": [
+      "portfolio",
+      "demo"
+    ],
+    "certificationSlug": "recipe-developer"
+  },
+  "workshop": {
+    "difficulty": "intermediate",
+    "templateTier": 4,
+    "aiPersona": {
+      "role": "You are a culinary assistant helping home cooks build a beautiful recipe collection, plan meals, and discover new culinary ideas.",
+      "expertise": [
+        "Recipe creation and adaptation",
+        "Ingredient substitutions",
+        "Meal planning",
+        "Cooking techniques",
+        "Dietary accommodations"
+      ],
+      "tone": "collaborator"
+    },
+    "workspaceConfig": {
+      "paradigm": "creative",
+      "defaultTab": "explore",
+      "defaultView": "gallery",
+      "defaultFile": "recipes/first-recipe.md",
+      "layout": {
+        "leftDock": "files",
+        "rightDock": "views"
+      },
+      "onboarding": {
+        "showGuide": true,
+        "highlightFeatures": [
+          "gallery",
+          "calendar",
+          "ai-chat"
+        ],
+        "suggestedActions": [
+          "Add your favorite recipes",
+          "Use Gallery view to browse recipe photos",
+          "Plan meals in Calendar view",
+          "Ask AI for recipe variations"
+        ]
+      }
+    },
+    "graphGuidance": {
+      "conceptCreation": {
+        "triggers": [
+          "User adds a recipe",
+          "User adds an ingredient",
+          "User plans a meal",
+          "User creates a dietary tag"
+        ],
+        "typeMapping": {
+          "recipe": "document",
+          "ingredient": "thing",
+          "meal": "event",
+          "tag": "topic"
+        }
+      },
+      "relationshipPatterns": [
+        {
+          "from": "document",
+          "to": "thing",
+          "verb": "contains",
+          "description": "Recipe contains ingredient"
+        },
+        {
+          "from": "thing",
+          "to": "thing",
+          "verb": "transforms",
+          "description": "Ingredient substitutes for another"
+        },
+        {
+          "from": "event",
+          "to": "document",
+          "verb": "uses",
+          "description": "Meal uses recipe"
+        },
+        {
+          "from": "topic",
+          "to": "document",
+          "verb": "categorizes",
+          "description": "Tag applied to recipe"
+        }
+      ],
+      "rules": [
+        "Every recipe should have ingredients linked",
+        "Track dietary tags for filtering",
+        "Link substitutions between ingredients"
+      ]
+    },
+    "qualityGates": {
+      "fileChecks": [
+        {
+          "path": "package.json",
+          "required": [
+            "svelte",
+            "@sveltejs/kit",
+            "@soulcraft/brainy"
+          ],
+          "optional": [
+            "typescript"
+          ]
+        },
+        {
+          "path": "src/lib/types.ts",
+          "required": [
+            "Recipe",
+            "Ingredient"
+          ],
+          "optional": [
+            "Meal",
+            "Tag"
+          ]
+        }
+      ],
+      "projectChecks": [
+        "App starts with npm run dev",
+        "Can create new recipes",
+        "Can add ingredients",
+        "Can plan meals",
+        "Search returns matching recipes"
+      ],
+      "exportReady": [
+        "No TypeScript errors",
+        "All routes load correctly",
+        "Error handling in place"
+      ]
+    },
+    "sampleData": {
+      "description": "Sample recipes demonstrating the app features",
+      "entities": [
+        {
+          "type": "document",
+          "name": "Classic Pasta Carbonara",
+          "properties": {
+            "servings": 4,
+            "prepTime": 15,
+            "cookTime": 20,
+            "description": "Traditional Roman pasta with crispy guanciale and creamy egg sauce.",
+            "status": "tested",
+            "rating": 5
+          }
+        },
+        {
+          "type": "thing",
+          "name": "Spaghetti",
+          "properties": {
+            "category": "pasta",
+            "unit": "grams",
+            "description": "Long thin pasta, essential for carbonara."
+          }
+        },
+        {
+          "type": "topic",
+          "name": "Italian",
+          "properties": {
+            "color": "#E91E63",
+            "description": "Traditional Italian cuisine."
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "Classic Pasta Carbonara",
+          "verb": "contains",
+          "to": "Spaghetti"
+        },
+        {
+          "from": "Italian",
+          "verb": "categorizes",
+          "to": "Classic Pasta Carbonara"
+        }
+      ]
+    },
+    "templateMetadata": {
+      "runnable": true,
+      "runnableCommand": "npm run dev"
+    },
+    "deploy": {
+      "provider": "cloud-run",
+      "buildCommand": "npm run build",
+      "outputDir": "build",
+      "config": {
+        "port": 3000,
+        "memory": "512Mi"
+      },
+      "oneClickCommand": "gcloud run deploy"
+    }
+  }
+}

package/kits/recipe-manager/skills/add-recipe/SKILL.md

@@ -0,0 +1,33 @@
+---
+id: add-recipe
+name: Add New Recipe
+description: Create a recipe with ingredients and instructions
+version: "1.0.0"
+type: invocable
+requiresVision: true
+requiresData: false
+---
+
+## Add New Recipe
+
+Create a recipe with ingredients and instructions
+
+### Steps
+
+1. Create recipe form with name, servings, prep/cook time
+2. Add ingredient selector with quantity input
+3. Add instructions as rich text or steps
+4. Upload recipe image
+5. Add dietary tags
+6. Create document entity and ingredient relationships
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "add recipe"
+- "new recipe"
+- "create recipe"
+
+### Execution Mode
+
+This workflow can be executed automatically when triggered. Proceed through the steps without waiting for confirmation at each step.

package/kits/recipe-manager/skills/generate-shopping-list/SKILL.md

@@ -0,0 +1,27 @@
+---
+id: generate-shopping-list
+name: Generate Shopping List
+description: Create shopping list from planned meals
+version: "1.0.0"
+type: invocable
+requiresVision: false
+requiresData: false
+---
+
+## Generate Shopping List
+
+Create shopping list from planned meals
+
+### Steps
+
+1. Get meals for date range
+2. Aggregate ingredients across recipes
+3. Group by category (produce, dairy, etc.)
+4. Export as checklist
+
+### When to Use
+
+This workflow is helpful when the user mentions:
+- "shopping list"
+- "grocery list"
+- "what to buy"