@soulcraft/kits 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (528) hide show
  1. package/kits/ai-content-studio/kit.json +358 -0
  2. package/kits/api-documentation/kit.json +358 -0
  3. package/kits/api-documentation/skills/api-examples/SKILL.md +176 -0
  4. package/kits/api-documentation/skills/api-review/SKILL.md +35 -0
  5. package/kits/api-documentation/skills/api-versioning/SKILL.md +156 -0
  6. package/kits/api-documentation/skills/create-code-examples/SKILL.md +42 -0
  7. package/kits/api-documentation/skills/define-resource/SKILL.md +39 -0
  8. package/kits/api-documentation/skills/document-auth/SKILL.md +39 -0
  9. package/kits/api-documentation/skills/document-endpoint/SKILL.md +40 -0
  10. package/kits/api-documentation/skills/kit-expertise/SKILL.md +78 -0
  11. package/kits/api-documentation/skills/openapi-spec/SKILL.md +174 -0
  12. package/kits/axe-house/kit.json +931 -0
  13. package/kits/axe-house/skills/axe-expertise/SKILL.md +259 -0
  14. package/kits/axe-house/skills/blog-draft/SKILL.md +147 -0
  15. package/kits/axe-house/skills/booking-digest/SKILL.md +188 -0
  16. package/kits/axe-house/skills/customer-insights/SKILL.md +215 -0
  17. package/kits/axe-house/skills/demand-forecast/SKILL.md +183 -0
  18. package/kits/axe-house/skills/email-campaign/SKILL.md +135 -0
  19. package/kits/axe-house/skills/experience-copy/SKILL.md +142 -0
  20. package/kits/axe-house/skills/guest-letter/SKILL.md +171 -0
  21. package/kits/axe-house/skills/inventory-health/SKILL.md +234 -0
  22. package/kits/axe-house/skills/league-manager/SKILL.md +264 -0
  23. package/kits/axe-house/skills/revenue-report/SKILL.md +240 -0
  24. package/kits/axe-house/skills/safety-briefing/SKILL.md +248 -0
  25. package/kits/axe-house/skills/social-calendar/SKILL.md +203 -0
  26. package/kits/axe-house/skills/staff-briefing/SKILL.md +231 -0
  27. package/kits/axe-house/skills/venue-data-model/SKILL.md +225 -0
  28. package/kits/blog-series/kit.json +363 -0
  29. package/kits/blog-series/skills/content-hooks/SKILL.md +158 -0
  30. package/kits/blog-series/skills/headline-brainstorm/SKILL.md +40 -0
  31. package/kits/blog-series/skills/kit-expertise/SKILL.md +78 -0
  32. package/kits/blog-series/skills/repurpose-content/SKILL.md +40 -0
  33. package/kits/blog-series/skills/seo-review/SKILL.md +41 -0
  34. package/kits/blog-series/skills/seo-writing/SKILL.md +135 -0
  35. package/kits/blog-series/skills/series-audit/SKILL.md +36 -0
  36. package/kits/blog-series/skills/write-post-outline/SKILL.md +42 -0
  37. package/kits/business-plan/kit.json +437 -0
  38. package/kits/business-plan/skills/competitor-analysis/SKILL.md +34 -0
  39. package/kits/business-plan/skills/financial-modeling/SKILL.md +180 -0
  40. package/kits/business-plan/skills/financial-projections/SKILL.md +42 -0
  41. package/kits/business-plan/skills/kit-expertise/SKILL.md +101 -0
  42. package/kits/business-plan/skills/market-analysis/SKILL.md +155 -0
  43. package/kits/business-plan/skills/market-research/SKILL.md +35 -0
  44. package/kits/business-plan/skills/sba-compliance/SKILL.md +163 -0
  45. package/kits/business-plan/skills/swot-analysis/SKILL.md +36 -0
  46. package/kits/canvas-and-corks/kit.json +910 -0
  47. package/kits/canvas-and-corks/skills/blog-draft/SKILL.md +160 -0
  48. package/kits/canvas-and-corks/skills/booking-digest/SKILL.md +147 -0
  49. package/kits/canvas-and-corks/skills/class-description/SKILL.md +53 -0
  50. package/kits/canvas-and-corks/skills/class-roster/SKILL.md +163 -0
  51. package/kits/canvas-and-corks/skills/customer-insights/SKILL.md +174 -0
  52. package/kits/canvas-and-corks/skills/demand-forecast/SKILL.md +191 -0
  53. package/kits/canvas-and-corks/skills/email-campaign/SKILL.md +154 -0
  54. package/kits/canvas-and-corks/skills/experience-copy/SKILL.md +152 -0
  55. package/kits/canvas-and-corks/skills/guest-letter/SKILL.md +127 -0
  56. package/kits/canvas-and-corks/skills/inventory-health/SKILL.md +204 -0
  57. package/kits/canvas-and-corks/skills/painting-memory/SKILL.md +76 -0
  58. package/kits/canvas-and-corks/skills/revenue-report/SKILL.md +196 -0
  59. package/kits/canvas-and-corks/skills/social-calendar/SKILL.md +146 -0
  60. package/kits/canvas-and-corks/skills/staff-briefing/SKILL.md +134 -0
  61. package/kits/canvas-and-corks/skills/studio-expertise/SKILL.md +181 -0
  62. package/kits/canvas-and-corks/skills/venue-data-model/SKILL.md +325 -0
  63. package/kits/character-relationship-map/kit.json +367 -0
  64. package/kits/character-relationship-map/skills/ensemble-balance/SKILL.md +189 -0
  65. package/kits/character-relationship-map/skills/kit-expertise/SKILL.md +83 -0
  66. package/kits/character-relationship-map/skills/relationship-dynamics/SKILL.md +158 -0
  67. package/kits/clay-and-co/kit.json +938 -0
  68. package/kits/clay-and-co/skills/blog-draft/SKILL.md +135 -0
  69. package/kits/clay-and-co/skills/booking-digest/SKILL.md +163 -0
  70. package/kits/clay-and-co/skills/customer-insights/SKILL.md +207 -0
  71. package/kits/clay-and-co/skills/demand-forecast/SKILL.md +166 -0
  72. package/kits/clay-and-co/skills/email-campaign/SKILL.md +125 -0
  73. package/kits/clay-and-co/skills/experience-copy/SKILL.md +132 -0
  74. package/kits/clay-and-co/skills/guest-letter/SKILL.md +104 -0
  75. package/kits/clay-and-co/skills/inventory-health/SKILL.md +211 -0
  76. package/kits/clay-and-co/skills/kiln-scheduler/SKILL.md +206 -0
  77. package/kits/clay-and-co/skills/piece-tracker/SKILL.md +165 -0
  78. package/kits/clay-and-co/skills/pottery-expertise/SKILL.md +165 -0
  79. package/kits/clay-and-co/skills/pottery-memory/SKILL.md +119 -0
  80. package/kits/clay-and-co/skills/revenue-report/SKILL.md +205 -0
  81. package/kits/clay-and-co/skills/social-calendar/SKILL.md +130 -0
  82. package/kits/clay-and-co/skills/staff-briefing/SKILL.md +213 -0
  83. package/kits/clay-and-co/skills/venue-data-model/SKILL.md +230 -0
  84. package/kits/concept-map/kit.json +353 -0
  85. package/kits/concept-map/skills/add-concept/SKILL.md +41 -0
  86. package/kits/concept-map/skills/assess-understanding/SKILL.md +36 -0
  87. package/kits/concept-map/skills/concept-hierarchy/SKILL.md +148 -0
  88. package/kits/concept-map/skills/create-learning-map/SKILL.md +42 -0
  89. package/kits/concept-map/skills/find-cross-links/SKILL.md +34 -0
  90. package/kits/concept-map/skills/identify-prerequisites/SKILL.md +40 -0
  91. package/kits/concept-map/skills/kit-expertise/SKILL.md +78 -0
  92. package/kits/concept-map/skills/relationship-types/SKILL.md +160 -0
  93. package/kits/content-calendar/kit.json +420 -0
  94. package/kits/content-calendar/skills/content-strategy/SKILL.md +174 -0
  95. package/kits/content-calendar/skills/create-brief/SKILL.md +40 -0
  96. package/kits/content-calendar/skills/generate-ideas/SKILL.md +40 -0
  97. package/kits/content-calendar/skills/kit-expertise/SKILL.md +100 -0
  98. package/kits/content-calendar/skills/plan-series/SKILL.md +40 -0
  99. package/kits/content-calendar/skills/repurpose-content/SKILL.md +38 -0
  100. package/kits/content-calendar/skills/repurposing/SKILL.md +179 -0
  101. package/kits/content-calendar/skills/weekly-review/SKILL.md +34 -0
  102. package/kits/coworking-space/kit.json +1068 -0
  103. package/kits/escape-vault/kit.json +1028 -0
  104. package/kits/escape-vault/skills/blog-draft/SKILL.md +157 -0
  105. package/kits/escape-vault/skills/booking-digest/SKILL.md +151 -0
  106. package/kits/escape-vault/skills/customer-insights/SKILL.md +185 -0
  107. package/kits/escape-vault/skills/demand-forecast/SKILL.md +188 -0
  108. package/kits/escape-vault/skills/email-campaign/SKILL.md +157 -0
  109. package/kits/escape-vault/skills/escape-expertise/SKILL.md +200 -0
  110. package/kits/escape-vault/skills/escape-memory/SKILL.md +99 -0
  111. package/kits/escape-vault/skills/experience-copy/SKILL.md +159 -0
  112. package/kits/escape-vault/skills/guest-letter/SKILL.md +143 -0
  113. package/kits/escape-vault/skills/inventory-health/SKILL.md +222 -0
  114. package/kits/escape-vault/skills/leaderboard-report/SKILL.md +204 -0
  115. package/kits/escape-vault/skills/revenue-report/SKILL.md +202 -0
  116. package/kits/escape-vault/skills/room-designer/SKILL.md +182 -0
  117. package/kits/escape-vault/skills/social-calendar/SKILL.md +148 -0
  118. package/kits/escape-vault/skills/staff-briefing/SKILL.md +159 -0
  119. package/kits/escape-vault/skills/venue-data-model/SKILL.md +335 -0
  120. package/kits/family-tree/kit.json +380 -0
  121. package/kits/family-tree/skills/add-family-member/SKILL.md +42 -0
  122. package/kits/family-tree/skills/analyze-relationship/SKILL.md +41 -0
  123. package/kits/family-tree/skills/export-gedcom/SKILL.md +34 -0
  124. package/kits/family-tree/skills/genealogy-research/SKILL.md +188 -0
  125. package/kits/family-tree/skills/kit-expertise/SKILL.md +107 -0
  126. package/kits/family-tree/skills/record-oral-history/SKILL.md +43 -0
  127. package/kits/family-tree/skills/relationship-mapping/SKILL.md +171 -0
  128. package/kits/family-tree/skills/research-ancestor/SKILL.md +43 -0
  129. package/kits/farkle-dice-game/kit.json +316 -0
  130. package/kits/farkle-dice-game/skills/kit-expertise/SKILL.md +137 -0
  131. package/kits/franchise-ops/kit.json +326 -0
  132. package/kits/freelance-portfolio/kit.json +435 -0
  133. package/kits/game-design-doc/kit.json +353 -0
  134. package/kits/game-design-doc/skills/balance-system/SKILL.md +40 -0
  135. package/kits/game-design-doc/skills/create-character/SKILL.md +40 -0
  136. package/kits/game-design-doc/skills/design-mechanic/SKILL.md +40 -0
  137. package/kits/game-design-doc/skills/economy-design/SKILL.md +152 -0
  138. package/kits/game-design-doc/skills/game-mechanics/SKILL.md +141 -0
  139. package/kits/game-design-doc/skills/ideate-features/SKILL.md +36 -0
  140. package/kits/game-design-doc/skills/kit-expertise/SKILL.md +78 -0
  141. package/kits/game-design-doc/skills/playtest-feedback/SKILL.md +142 -0
  142. package/kits/game-design-doc/skills/review-gdd/SKILL.md +33 -0
  143. package/kits/gather-and-grill/kit.json +966 -0
  144. package/kits/gather-and-grill/skills/blog-draft/SKILL.md +120 -0
  145. package/kits/gather-and-grill/skills/booking-digest/SKILL.md +171 -0
  146. package/kits/gather-and-grill/skills/cooking-memory/SKILL.md +100 -0
  147. package/kits/gather-and-grill/skills/culinary-expertise/SKILL.md +180 -0
  148. package/kits/gather-and-grill/skills/customer-insights/SKILL.md +184 -0
  149. package/kits/gather-and-grill/skills/demand-forecast/SKILL.md +200 -0
  150. package/kits/gather-and-grill/skills/email-campaign/SKILL.md +97 -0
  151. package/kits/gather-and-grill/skills/experience-copy/SKILL.md +92 -0
  152. package/kits/gather-and-grill/skills/guest-letter/SKILL.md +98 -0
  153. package/kits/gather-and-grill/skills/inventory-health/SKILL.md +193 -0
  154. package/kits/gather-and-grill/skills/menu-planner/SKILL.md +175 -0
  155. package/kits/gather-and-grill/skills/recipe-card/SKILL.md +194 -0
  156. package/kits/gather-and-grill/skills/revenue-report/SKILL.md +245 -0
  157. package/kits/gather-and-grill/skills/social-calendar/SKILL.md +139 -0
  158. package/kits/gather-and-grill/skills/staff-briefing/SKILL.md +167 -0
  159. package/kits/gather-and-grill/skills/venue-data-model/SKILL.md +336 -0
  160. package/kits/gtd-productivity-system/kit.json +389 -0
  161. package/kits/gtd-productivity-system/skills/break-down-project/SKILL.md +41 -0
  162. package/kits/gtd-productivity-system/skills/clarify-task/SKILL.md +42 -0
  163. package/kits/gtd-productivity-system/skills/gtd-methodology/SKILL.md +185 -0
  164. package/kits/gtd-productivity-system/skills/inbox-processing/SKILL.md +173 -0
  165. package/kits/gtd-productivity-system/skills/kit-expertise/SKILL.md +111 -0
  166. package/kits/gtd-productivity-system/skills/mind-sweep/SKILL.md +35 -0
  167. package/kits/gtd-productivity-system/skills/process-inbox/SKILL.md +40 -0
  168. package/kits/gtd-productivity-system/skills/weekly-review/SKILL.md +197 -0
  169. package/kits/gym-fitness/kit.json +1037 -0
  170. package/kits/interactive-fiction/kit.json +471 -0
  171. package/kits/invoice-generator/kit.json +466 -0
  172. package/kits/loyalty-program/kit.json +323 -0
  173. package/kits/marketing-plan/kit.json +417 -0
  174. package/kits/marketing-plan/skills/allocate-budget/SKILL.md +34 -0
  175. package/kits/marketing-plan/skills/campaign-metrics/SKILL.md +184 -0
  176. package/kits/marketing-plan/skills/channel-strategy/SKILL.md +156 -0
  177. package/kits/marketing-plan/skills/content-calendar/SKILL.md +34 -0
  178. package/kits/marketing-plan/skills/create-persona/SKILL.md +40 -0
  179. package/kits/marketing-plan/skills/kit-expertise/SKILL.md +109 -0
  180. package/kits/marketing-plan/skills/measure-performance/SKILL.md +34 -0
  181. package/kits/marketing-plan/skills/plan-campaign/SKILL.md +41 -0
  182. package/kits/marketing-site/kit.json +230 -0
  183. package/kits/marketing-site/skills/add-page/SKILL.md +28 -0
  184. package/kits/marketing-site/skills/add-section/SKILL.md +29 -0
  185. package/kits/marketing-site/skills/change-colors/SKILL.md +24 -0
  186. package/kits/marketing-site/skills/conversion-copy/SKILL.md +152 -0
  187. package/kits/marketing-site/skills/export-deploy/SKILL.md +24 -0
  188. package/kits/marketing-site/skills/kit-expertise/SKILL.md +77 -0
  189. package/kits/marketing-site/skills/landing-page/SKILL.md +156 -0
  190. package/kits/match-3-puzzle/kit.json +245 -0
  191. package/kits/match-3-puzzle/skills/kit-expertise/SKILL.md +96 -0
  192. package/kits/mind-map/kit.json +355 -0
  193. package/kits/mind-map/skills/add-branch/SKILL.md +40 -0
  194. package/kits/mind-map/skills/brainstorm-topic/SKILL.md +41 -0
  195. package/kits/mind-map/skills/branch-expansion/SKILL.md +181 -0
  196. package/kits/mind-map/skills/find-connections/SKILL.md +34 -0
  197. package/kits/mind-map/skills/kit-expertise/SKILL.md +78 -0
  198. package/kits/mind-map/skills/organize-map/SKILL.md +35 -0
  199. package/kits/mind-map/skills/radiant-thinking/SKILL.md +184 -0
  200. package/kits/mind-map/skills/summarize-map/SKILL.md +34 -0
  201. package/kits/music-collection/kit.json +403 -0
  202. package/kits/music-collection/skills/add-album/SKILL.md +44 -0
  203. package/kits/music-collection/skills/create-playlist/SKILL.md +37 -0
  204. package/kits/music-collection/skills/explore-artist/SKILL.md +37 -0
  205. package/kits/music-collection/skills/journal-session/SKILL.md +40 -0
  206. package/kits/music-collection/skills/kit-expertise/SKILL.md +98 -0
  207. package/kits/music-collection/skills/music-metadata/SKILL.md +209 -0
  208. package/kits/music-collection/skills/playlist-curator/SKILL.md +182 -0
  209. package/kits/music-collection/skills/recommend-similar/SKILL.md +36 -0
  210. package/kits/music-venue/kit.json +986 -0
  211. package/kits/novel-writing-system/kit.json +481 -0
  212. package/kits/novel-writing-system/skills/character-arc/SKILL.md +164 -0
  213. package/kits/novel-writing-system/skills/develop-character-arc/SKILL.md +42 -0
  214. package/kits/novel-writing-system/skills/kit-expertise/SKILL.md +84 -0
  215. package/kits/novel-writing-system/skills/outline-review/SKILL.md +34 -0
  216. package/kits/novel-writing-system/skills/plot-doctor/SKILL.md +221 -0
  217. package/kits/novel-writing-system/skills/plot-hole-check/SKILL.md +35 -0
  218. package/kits/novel-writing-system/skills/scene-development/SKILL.md +38 -0
  219. package/kits/novel-writing-system/skills/scene-sequel/SKILL.md +162 -0
  220. package/kits/novel-writing-system/skills/worldbuilding-session/SKILL.md +40 -0
  221. package/kits/organization-chart/kit.json +349 -0
  222. package/kits/organization-chart/skills/add-role/SKILL.md +41 -0
  223. package/kits/organization-chart/skills/analyze-span/SKILL.md +34 -0
  224. package/kits/organization-chart/skills/create-raci/SKILL.md +42 -0
  225. package/kits/organization-chart/skills/kit-expertise/SKILL.md +78 -0
  226. package/kits/organization-chart/skills/org-design/SKILL.md +188 -0
  227. package/kits/organization-chart/skills/org-health-check/SKILL.md +35 -0
  228. package/kits/organization-chart/skills/plan-reorg/SKILL.md +42 -0
  229. package/kits/organization-chart/skills/role-definition/SKILL.md +180 -0
  230. package/kits/paws-and-pour/kit.json +969 -0
  231. package/kits/paws-and-pour/skills/adoption-report/SKILL.md +273 -0
  232. package/kits/paws-and-pour/skills/animal-profile/SKILL.md +206 -0
  233. package/kits/paws-and-pour/skills/blog-draft/SKILL.md +137 -0
  234. package/kits/paws-and-pour/skills/booking-digest/SKILL.md +251 -0
  235. package/kits/paws-and-pour/skills/cafe-expertise/SKILL.md +218 -0
  236. package/kits/paws-and-pour/skills/cafe-memory/SKILL.md +114 -0
  237. package/kits/paws-and-pour/skills/customer-insights/SKILL.md +216 -0
  238. package/kits/paws-and-pour/skills/demand-forecast/SKILL.md +200 -0
  239. package/kits/paws-and-pour/skills/email-campaign/SKILL.md +154 -0
  240. package/kits/paws-and-pour/skills/experience-copy/SKILL.md +139 -0
  241. package/kits/paws-and-pour/skills/guest-letter/SKILL.md +183 -0
  242. package/kits/paws-and-pour/skills/inventory-health/SKILL.md +213 -0
  243. package/kits/paws-and-pour/skills/revenue-report/SKILL.md +273 -0
  244. package/kits/paws-and-pour/skills/social-calendar/SKILL.md +183 -0
  245. package/kits/paws-and-pour/skills/staff-briefing/SKILL.md +223 -0
  246. package/kits/paws-and-pour/skills/venue-data-model/SKILL.md +260 -0
  247. package/kits/persona-driven-strategy/kit.json +352 -0
  248. package/kits/persona-driven-strategy/skills/empathy-mapping/SKILL.md +221 -0
  249. package/kits/persona-driven-strategy/skills/journey-mapping/SKILL.md +219 -0
  250. package/kits/persona-driven-strategy/skills/kit-expertise/SKILL.md +81 -0
  251. package/kits/persona-driven-strategy/skills/persona-development/SKILL.md +189 -0
  252. package/kits/personal-crm/kit.json +373 -0
  253. package/kits/personal-crm/skills/add-contact/SKILL.md +42 -0
  254. package/kits/personal-crm/skills/connect-contacts/SKILL.md +41 -0
  255. package/kits/personal-crm/skills/find-dormant/SKILL.md +35 -0
  256. package/kits/personal-crm/skills/kit-expertise/SKILL.md +82 -0
  257. package/kits/personal-crm/skills/log-interaction/SKILL.md +43 -0
  258. package/kits/personal-crm/skills/network-analysis/SKILL.md +161 -0
  259. package/kits/personal-crm/skills/relationship-insights/SKILL.md +153 -0
  260. package/kits/personal-wiki/kit.json +322 -0
  261. package/kits/personal-wiki/skills/kit-expertise/SKILL.md +81 -0
  262. package/kits/personal-wiki/skills/orphan-finder/SKILL.md +155 -0
  263. package/kits/personal-wiki/skills/wiki-structure/SKILL.md +179 -0
  264. package/kits/petal-press/kit.json +996 -0
  265. package/kits/petal-press/skills/arrangement-memory/SKILL.md +143 -0
  266. package/kits/petal-press/skills/blog-draft/SKILL.md +167 -0
  267. package/kits/petal-press/skills/booking-digest/SKILL.md +196 -0
  268. package/kits/petal-press/skills/care-card/SKILL.md +173 -0
  269. package/kits/petal-press/skills/customer-insights/SKILL.md +213 -0
  270. package/kits/petal-press/skills/demand-forecast/SKILL.md +203 -0
  271. package/kits/petal-press/skills/email-campaign/SKILL.md +204 -0
  272. package/kits/petal-press/skills/experience-copy/SKILL.md +184 -0
  273. package/kits/petal-press/skills/floral-expertise/SKILL.md +244 -0
  274. package/kits/petal-press/skills/guest-letter/SKILL.md +153 -0
  275. package/kits/petal-press/skills/inventory-health/SKILL.md +201 -0
  276. package/kits/petal-press/skills/revenue-report/SKILL.md +219 -0
  277. package/kits/petal-press/skills/seasonal-guide/SKILL.md +238 -0
  278. package/kits/petal-press/skills/social-calendar/SKILL.md +217 -0
  279. package/kits/petal-press/skills/staff-briefing/SKILL.md +217 -0
  280. package/kits/petal-press/skills/venue-data-model/SKILL.md +226 -0
  281. package/kits/pitch-deck/kit.json +416 -0
  282. package/kits/pitch-deck/skills/calculate-market-size/SKILL.md +41 -0
  283. package/kits/pitch-deck/skills/develop-problem-slide/SKILL.md +39 -0
  284. package/kits/pitch-deck/skills/investor-qa/SKILL.md +182 -0
  285. package/kits/pitch-deck/skills/investor-qa-prep/SKILL.md +36 -0
  286. package/kits/pitch-deck/skills/kit-expertise/SKILL.md +112 -0
  287. package/kits/pitch-deck/skills/pitch-structure/SKILL.md +186 -0
  288. package/kits/pitch-deck/skills/practice-pitch/SKILL.md +36 -0
  289. package/kits/podcast-series/kit.json +324 -0
  290. package/kits/podcast-series/skills/audience-growth/SKILL.md +38 -0
  291. package/kits/podcast-series/skills/create-guest-profile/SKILL.md +42 -0
  292. package/kits/podcast-series/skills/episode-structure/SKILL.md +189 -0
  293. package/kits/podcast-series/skills/guest-research/SKILL.md +167 -0
  294. package/kits/podcast-series/skills/kit-expertise/SKILL.md +81 -0
  295. package/kits/podcast-series/skills/plan-episode/SKILL.md +44 -0
  296. package/kits/podcast-series/skills/prepare-guest/SKILL.md +45 -0
  297. package/kits/podcast-series/skills/show-notes/SKILL.md +182 -0
  298. package/kits/podcast-series/skills/write-show-notes/SKILL.md +43 -0
  299. package/kits/pour-house/kit.json +912 -0
  300. package/kits/pour-house/skills/blog-draft/SKILL.md +138 -0
  301. package/kits/pour-house/skills/booking-digest/SKILL.md +151 -0
  302. package/kits/pour-house/skills/cellar-report/SKILL.md +251 -0
  303. package/kits/pour-house/skills/customer-insights/SKILL.md +184 -0
  304. package/kits/pour-house/skills/demand-forecast/SKILL.md +156 -0
  305. package/kits/pour-house/skills/email-campaign/SKILL.md +130 -0
  306. package/kits/pour-house/skills/experience-copy/SKILL.md +125 -0
  307. package/kits/pour-house/skills/guest-letter/SKILL.md +136 -0
  308. package/kits/pour-house/skills/inventory-health/SKILL.md +159 -0
  309. package/kits/pour-house/skills/pour-memory/SKILL.md +89 -0
  310. package/kits/pour-house/skills/revenue-report/SKILL.md +232 -0
  311. package/kits/pour-house/skills/social-calendar/SKILL.md +140 -0
  312. package/kits/pour-house/skills/sommelier-expertise/SKILL.md +324 -0
  313. package/kits/pour-house/skills/staff-briefing/SKILL.md +176 -0
  314. package/kits/pour-house/skills/tasting-notes/SKILL.md +179 -0
  315. package/kits/pour-house/skills/venue-data-model/SKILL.md +323 -0
  316. package/kits/presentation/kit.json +296 -0
  317. package/kits/product-requirements-doc/kit.json +365 -0
  318. package/kits/product-requirements-doc/skills/acceptance-criteria/SKILL.md +219 -0
  319. package/kits/product-requirements-doc/skills/create-user-story/SKILL.md +43 -0
  320. package/kits/product-requirements-doc/skills/define-success-metrics/SKILL.md +41 -0
  321. package/kits/product-requirements-doc/skills/kit-expertise/SKILL.md +81 -0
  322. package/kits/product-requirements-doc/skills/prd-review/SKILL.md +39 -0
  323. package/kits/product-requirements-doc/skills/prd-structure/SKILL.md +206 -0
  324. package/kits/product-requirements-doc/skills/prioritize-features/SKILL.md +43 -0
  325. package/kits/product-requirements-doc/skills/synthesize-research/SKILL.md +43 -0
  326. package/kits/product-requirements-doc/skills/user-stories/SKILL.md +198 -0
  327. package/kits/project-timeline/kit.json +367 -0
  328. package/kits/project-timeline/skills/add-milestone/SKILL.md +44 -0
  329. package/kits/project-timeline/skills/add-task/SKILL.md +43 -0
  330. package/kits/project-timeline/skills/assess-risks/SKILL.md +39 -0
  331. package/kits/project-timeline/skills/dependency-analysis/SKILL.md +176 -0
  332. package/kits/project-timeline/skills/identify-critical-path/SKILL.md +37 -0
  333. package/kits/project-timeline/skills/kit-expertise/SKILL.md +81 -0
  334. package/kits/project-timeline/skills/milestone-planning/SKILL.md +169 -0
  335. package/kits/project-timeline/skills/status-update/SKILL.md +39 -0
  336. package/kits/reading-tracker/kit.json +368 -0
  337. package/kits/reading-tracker/skills/add-book/SKILL.md +32 -0
  338. package/kits/reading-tracker/skills/book-connections/SKILL.md +161 -0
  339. package/kits/reading-tracker/skills/kit-expertise/SKILL.md +72 -0
  340. package/kits/reading-tracker/skills/log-progress/SKILL.md +29 -0
  341. package/kits/reading-tracker/skills/reading-insights/SKILL.md +179 -0
  342. package/kits/reading-tracker/skills/save-quote/SKILL.md +30 -0
  343. package/kits/recipe-manager/kit.json +376 -0
  344. package/kits/recipe-manager/skills/add-recipe/SKILL.md +33 -0
  345. package/kits/recipe-manager/skills/generate-shopping-list/SKILL.md +27 -0
  346. package/kits/recipe-manager/skills/ingredient-substitutions/SKILL.md +157 -0
  347. package/kits/recipe-manager/skills/kit-expertise/SKILL.md +72 -0
  348. package/kits/recipe-manager/skills/meal-planning/SKILL.md +184 -0
  349. package/kits/recipe-manager/skills/plan-meal/SKILL.md +31 -0
  350. package/kits/recipe-manager/skills/scaling-recipes/SKILL.md +183 -0
  351. package/kits/saas-app/kit.json +405 -0
  352. package/kits/saas-app/skills/churn-analysis/SKILL.md +219 -0
  353. package/kits/saas-app/skills/onboarding-flow/SKILL.md +217 -0
  354. package/kits/saas-app/skills/pricing-model/SKILL.md +192 -0
  355. package/kits/saas-app/skills/saas-expertise/SKILL.md +95 -0
  356. package/kits/salon-barbershop/kit.json +1021 -0
  357. package/kits/screenplay-writing/kit.json +412 -0
  358. package/kits/screenplay-writing/skills/analyze-scene/SKILL.md +42 -0
  359. package/kits/screenplay-writing/skills/beat-sheet/SKILL.md +134 -0
  360. package/kits/screenplay-writing/skills/create-scene-card/SKILL.md +46 -0
  361. package/kits/screenplay-writing/skills/develop-character/SKILL.md +43 -0
  362. package/kits/screenplay-writing/skills/generate-beat-sheet/SKILL.md +49 -0
  363. package/kits/screenplay-writing/skills/kit-expertise/SKILL.md +90 -0
  364. package/kits/screenplay-writing/skills/scene-analysis/SKILL.md +164 -0
  365. package/kits/screenplay-writing/skills/screenplay-format/SKILL.md +108 -0
  366. package/kits/social-media-manager/kit.json +476 -0
  367. package/kits/teacher-lesson-plan/kit.json +410 -0
  368. package/kits/teacher-lesson-plan/skills/assessment-design/SKILL.md +162 -0
  369. package/kits/teacher-lesson-plan/skills/blooms-taxonomy/SKILL.md +139 -0
  370. package/kits/teacher-lesson-plan/skills/create-lesson/SKILL.md +34 -0
  371. package/kits/teacher-lesson-plan/skills/design-unit/SKILL.md +28 -0
  372. package/kits/teacher-lesson-plan/skills/differentiate-lesson/SKILL.md +28 -0
  373. package/kits/teacher-lesson-plan/skills/differentiation/SKILL.md +180 -0
  374. package/kits/teacher-lesson-plan/skills/kit-expertise/SKILL.md +96 -0
  375. package/kits/teacher-lesson-plan/skills/schedule-lesson/SKILL.md +31 -0
  376. package/kits/technical-specification/kit.json +369 -0
  377. package/kits/technical-specification/skills/architecture-decision/SKILL.md +42 -0
  378. package/kits/technical-specification/skills/architecture-decisions/SKILL.md +180 -0
  379. package/kits/technical-specification/skills/data-model-design/SKILL.md +43 -0
  380. package/kits/technical-specification/skills/data-modeling/SKILL.md +159 -0
  381. package/kits/technical-specification/skills/define-component/SKILL.md +43 -0
  382. package/kits/technical-specification/skills/kit-expertise/SKILL.md +81 -0
  383. package/kits/technical-specification/skills/requirements-analysis/SKILL.md +42 -0
  384. package/kits/technical-specification/skills/security-review/SKILL.md +170 -0
  385. package/kits/technical-specification/skills/spec-review/SKILL.md +39 -0
  386. package/kits/wanderlands/kit.json +399 -0
  387. package/kits/wanderlands/skills/kit-expertise/SKILL.md +376 -0
  388. package/kits/web-application/kit.json +257 -0
  389. package/kits/web-application/skills/kit-expertise/SKILL.md +211 -0
  390. package/kits/wicks-and-whiskers/kit.json +1267 -0
  391. package/kits/wicks-and-whiskers/skills/blog-draft/SKILL.md +145 -0
  392. package/kits/wicks-and-whiskers/skills/booking-digest/SKILL.md +142 -0
  393. package/kits/wicks-and-whiskers/skills/candle-expertise/SKILL.md +69 -0
  394. package/kits/wicks-and-whiskers/skills/customer-insights/SKILL.md +176 -0
  395. package/kits/wicks-and-whiskers/skills/demand-forecast/SKILL.md +159 -0
  396. package/kits/wicks-and-whiskers/skills/email-campaign/SKILL.md +131 -0
  397. package/kits/wicks-and-whiskers/skills/experience-copy/SKILL.md +135 -0
  398. package/kits/wicks-and-whiskers/skills/guest-letter/SKILL.md +154 -0
  399. package/kits/wicks-and-whiskers/skills/inventory-health/SKILL.md +185 -0
  400. package/kits/wicks-and-whiskers/skills/kitten-profile/SKILL.md +159 -0
  401. package/kits/wicks-and-whiskers/skills/memory-narrative/SKILL.md +71 -0
  402. package/kits/wicks-and-whiskers/skills/revenue-report/SKILL.md +197 -0
  403. package/kits/wicks-and-whiskers/skills/social-calendar/SKILL.md +161 -0
  404. package/kits/wicks-and-whiskers/skills/staff-briefing/SKILL.md +174 -0
  405. package/kits/wicks-and-whiskers/skills/venue-data-model/SKILL.md +228 -0
  406. package/kits/world-building/kit.json +497 -0
  407. package/kits/world-building/skills/consistency-check/SKILL.md +179 -0
  408. package/kits/world-building/skills/create-character/SKILL.md +44 -0
  409. package/kits/world-building/skills/create-faction/SKILL.md +44 -0
  410. package/kits/world-building/skills/create-location/SKILL.md +44 -0
  411. package/kits/world-building/skills/create-timeline/SKILL.md +39 -0
  412. package/kits/world-building/skills/culture-builder/SKILL.md +171 -0
  413. package/kits/world-building/skills/design-magic-system/SKILL.md +38 -0
  414. package/kits/world-building/skills/kit-expertise/SKILL.md +110 -0
  415. package/kits/world-building/skills/magic-systems/SKILL.md +161 -0
  416. package/kits/youtube-content-plan/kit.json +346 -0
  417. package/kits/youtube-content-plan/skills/analytics-insights/SKILL.md +166 -0
  418. package/kits/youtube-content-plan/skills/analyze-performance/SKILL.md +43 -0
  419. package/kits/youtube-content-plan/skills/develop-video-idea/SKILL.md +45 -0
  420. package/kits/youtube-content-plan/skills/generate-ideas/SKILL.md +42 -0
  421. package/kits/youtube-content-plan/skills/kit-expertise/SKILL.md +81 -0
  422. package/kits/youtube-content-plan/skills/optimize-metadata/SKILL.md +43 -0
  423. package/kits/youtube-content-plan/skills/script-writing/SKILL.md +180 -0
  424. package/kits/youtube-content-plan/skills/write-script/SKILL.md +44 -0
  425. package/kits/youtube-content-plan/skills/youtube-seo/SKILL.md +172 -0
  426. package/package.json +43 -0
  427. package/src/index.ts +35 -0
  428. package/src/kits/ai-content-studio.ts +377 -0
  429. package/src/kits/api-documentation.ts +352 -0
  430. package/src/kits/axe-house.ts +949 -0
  431. package/src/kits/blog-series.ts +357 -0
  432. package/src/kits/business-plan.ts +406 -0
  433. package/src/kits/canvas-and-corks.ts +928 -0
  434. package/src/kits/character-relationship-map.ts +368 -0
  435. package/src/kits/clay-and-co.ts +956 -0
  436. package/src/kits/concept-map.ts +354 -0
  437. package/src/kits/content-calendar.ts +399 -0
  438. package/src/kits/coworking-space.ts +1084 -0
  439. package/src/kits/escape-vault.ts +1046 -0
  440. package/src/kits/family-tree.ts +381 -0
  441. package/src/kits/farkle-dice-game.ts +318 -0
  442. package/src/kits/franchise-ops.ts +345 -0
  443. package/src/kits/freelance-portfolio.ts +453 -0
  444. package/src/kits/game-design-doc.ts +353 -0
  445. package/src/kits/gather-and-grill.ts +984 -0
  446. package/src/kits/gtd-productivity-system.ts +389 -0
  447. package/src/kits/gym-fitness.ts +1053 -0
  448. package/src/kits/index.ts +76 -0
  449. package/src/kits/interactive-fiction.ts +489 -0
  450. package/src/kits/invoice-generator.ts +484 -0
  451. package/src/kits/loyalty-program.ts +342 -0
  452. package/src/kits/marketing-plan.ts +398 -0
  453. package/src/kits/marketing-site.ts +248 -0
  454. package/src/kits/match-3-puzzle.ts +248 -0
  455. package/src/kits/mind-map.ts +356 -0
  456. package/src/kits/music-collection.ts +404 -0
  457. package/src/kits/music-venue.ts +1002 -0
  458. package/src/kits/novel-writing-system.ts +461 -0
  459. package/src/kits/organization-chart.ts +350 -0
  460. package/src/kits/paws-and-pour.ts +987 -0
  461. package/src/kits/persona-driven-strategy.ts +345 -0
  462. package/src/kits/personal-crm.ts +391 -0
  463. package/src/kits/personal-wiki.ts +323 -0
  464. package/src/kits/petal-press.ts +1014 -0
  465. package/src/kits/pitch-deck.ts +395 -0
  466. package/src/kits/podcast-series.ts +324 -0
  467. package/src/kits/pour-house.ts +930 -0
  468. package/src/kits/presentation.ts +276 -0
  469. package/src/kits/product-requirements-doc.ts +359 -0
  470. package/src/kits/project-timeline.ts +368 -0
  471. package/src/kits/reading-tracker.ts +368 -0
  472. package/src/kits/recipe-manager.ts +376 -0
  473. package/src/kits/saas-app.ts +423 -0
  474. package/src/kits/salon-barbershop.ts +1037 -0
  475. package/src/kits/screenplay-writing.ts +412 -0
  476. package/src/kits/social-media-manager.ts +494 -0
  477. package/src/kits/teacher-lesson-plan.ts +410 -0
  478. package/src/kits/technical-specification.ts +363 -0
  479. package/src/kits/wanderlands.ts +401 -0
  480. package/src/kits/web-application.ts +275 -0
  481. package/src/kits/wicks-and-whiskers.ts +1285 -0
  482. package/src/kits/world-building.ts +476 -0
  483. package/src/kits/youtube-content-plan.ts +339 -0
  484. package/src/registry.ts +60 -0
  485. package/src/skills/api-documentation/index.ts +47 -0
  486. package/src/skills/axe-house/index.ts +71 -0
  487. package/src/skills/blog-series/index.ts +43 -0
  488. package/src/skills/business-plan/index.ts +43 -0
  489. package/src/skills/canvas-and-corks/index.ts +75 -0
  490. package/src/skills/character-relationship-map/index.ts +23 -0
  491. package/src/skills/clay-and-co/index.ts +75 -0
  492. package/src/skills/concept-map/index.ts +43 -0
  493. package/src/skills/content-calendar/index.ts +43 -0
  494. package/src/skills/escape-vault/index.ts +75 -0
  495. package/src/skills/family-tree/index.ts +43 -0
  496. package/src/skills/farkle-dice-game/index.ts +15 -0
  497. package/src/skills/game-design-doc/index.ts +47 -0
  498. package/src/skills/gather-and-grill/index.ts +75 -0
  499. package/src/skills/gtd-productivity-system/index.ts +43 -0
  500. package/src/skills/index.ts +109 -0
  501. package/src/skills/marketing-plan/index.ts +43 -0
  502. package/src/skills/marketing-site/index.ts +39 -0
  503. package/src/skills/match-3-puzzle/index.ts +15 -0
  504. package/src/skills/mind-map/index.ts +43 -0
  505. package/src/skills/music-collection/index.ts +43 -0
  506. package/src/skills/novel-writing-system/index.ts +47 -0
  507. package/src/skills/organization-chart/index.ts +43 -0
  508. package/src/skills/paws-and-pour/index.ts +75 -0
  509. package/src/skills/persona-driven-strategy/index.ts +27 -0
  510. package/src/skills/personal-crm/index.ts +39 -0
  511. package/src/skills/personal-wiki/index.ts +23 -0
  512. package/src/skills/petal-press/index.ts +75 -0
  513. package/src/skills/pitch-deck/index.ts +39 -0
  514. package/src/skills/podcast-series/index.ts +47 -0
  515. package/src/skills/pour-house/index.ts +75 -0
  516. package/src/skills/product-requirements-doc/index.ts +47 -0
  517. package/src/skills/project-timeline/index.ts +43 -0
  518. package/src/skills/reading-tracker/index.ts +35 -0
  519. package/src/skills/recipe-manager/index.ts +39 -0
  520. package/src/skills/saas-app/index.ts +27 -0
  521. package/src/skills/screenplay-writing/index.ts +43 -0
  522. package/src/skills/teacher-lesson-plan/index.ts +43 -0
  523. package/src/skills/technical-specification/index.ts +47 -0
  524. package/src/skills/wanderlands/index.ts +15 -0
  525. package/src/skills/web-application/index.ts +15 -0
  526. package/src/skills/wicks-and-whiskers/index.ts +71 -0
  527. package/src/skills/world-building/index.ts +47 -0
  528. package/src/skills/youtube-content-plan/index.ts +47 -0
@@ -0,0 +1,213 @@
1
+ ---
2
+ id: customer-insights
3
+ name: Customer Insights
4
+ description: Segments the customer base using neural clustering, identifies VIPs and churn risks, surfaces seasonal booking patterns by segment, and reports color palette preferences by customer type.
5
+ type: invocable
6
+ version: 1.0.0
7
+ requiresVision: false
8
+ requiresData: true
9
+ ---
10
+
11
+ # Customer Insights
12
+
13
+ You analyze the {{businessName}} customer base to surface behavioral segments, identify high-value guests, flag churn risks, and reveal which types of customers are booking which classes and palettes. This skill gives owners and marketing teams the data to personalize outreach and make smarter schedule and experience decisions.
14
+
15
+ ## When to Trigger
16
+
17
+ Invoke this skill when staff or owners ask:
18
+
19
+ - "Who are our best customers?"
20
+ - "Show me customer segments"
21
+ - "Who haven't we seen in a while?"
22
+ - "What kinds of customers do we have?"
23
+ - "Customer analysis"
24
+ - Any question about customer behavior, loyalty, or retention
25
+
26
+ ## Data to Pull
27
+
28
+ ### 1. Customer Profiles
29
+
30
+ ```typescript
31
+ const customers = await brain.find({
32
+ type: 'Person',
33
+ where: [
34
+ { field: 'metadata.entityType', value: 'customer' },
35
+ { field: 'metadata.locationId', value: LOCATION_ID }
36
+ ]
37
+ });
38
+ // Key fields: totalBookings, totalSpentInCents, loyaltyTier,
39
+ // lastBookingDate, firstBookingDate, email, displayName
40
+ ```
41
+
42
+ ### 2. Neural Clustering for Segmentation
43
+
44
+ ```typescript
45
+ const segments = await brain.neural().clusters({
46
+ numClusters: 5,
47
+ entityType: 'Person',
48
+ where: [
49
+ { field: 'metadata.entityType', value: 'customer' },
50
+ { field: 'metadata.locationId', value: LOCATION_ID }
51
+ ]
52
+ });
53
+ // → Array<{ label: string, members: Entity[], centroid: number[] }>
54
+ ```
55
+
56
+ ### 3. High-Value Outlier Detection
57
+
58
+ ```typescript
59
+ const outliers = await brain.neural().outliers({
60
+ threshold: 2.0,
61
+ method: 'zscore',
62
+ entityType: 'Person',
63
+ minNeighbors: 3
64
+ });
65
+ // High-positive outliers on totalSpentInCents = VIPs
66
+ // High-negative on lastBookingDate recency = churn risks
67
+ ```
68
+
69
+ ### 4. Booking History with Session Attributes (for palette analysis)
70
+
71
+ ```typescript
72
+ // For each customer in each segment, pull their bookings and tally session attributes
73
+ const bookings = await brain.find({
74
+ type: 'Event',
75
+ where: [
76
+ { field: 'metadata.entityType', value: 'booking' },
77
+ { field: 'metadata.status', value: 'confirmed' },
78
+ { field: 'metadata.locationId', value: LOCATION_ID }
79
+ ]
80
+ });
81
+ // Group by customerId and tally: experienceSlug, colorPalette session attribute, monthOfYear
82
+ ```
83
+
84
+ ## Customer Segments
85
+
86
+ Based on the clustering results and behavioral patterns typical of floral studios, map cluster outputs to these named segments. Adjust if clustering surfaces different natural groupings:
87
+
88
+ ### Segment 1: Floral Enthusiasts
89
+
90
+ **Profile:** Seasonal regulars who try every new class and return at each season change. Genuinely passionate about floral design — they may arrange at home outside of class too. Often buy retail products.
91
+
92
+ **Signals:** 4+ bookings, spread across multiple class types, multiple seasons. May have tried all five class types. High retail attachment rate. Active on social media (may tag studio without prompting).
93
+
94
+ **What they want:** New seasonal palettes, new class formats, advanced technique notes, early access to limited sessions.
95
+
96
+ **Engagement:** Personal note from the designer when something special is blooming. First invitations to any new class format. Thank them by name when they return.
97
+
98
+ ---
99
+
100
+ ### Segment 2: Event Planners
101
+
102
+ **Profile:** Primarily book private parties for celebrations — birthdays, bachelorettes, bridal showers, corporate events. May book rarely themselves (1–2 times per year) but bring large groups.
103
+
104
+ **Signals:** Private Floral Party bookings, high guest counts, partyTheme session attribute filled in. Revenue per booking significantly higher than average.
105
+
106
+ **What they want:** Easy group booking, flexible customization of palette and theme, clear communication on what's included, a smooth experience they can feel proud to have organized for others.
107
+
108
+ **Engagement:** Post-event follow-up thanking them for bringing their group. Ask if they have upcoming occasions. Seasonal reminder ("Planning a holiday party? Book early — December fills fast").
109
+
110
+ ---
111
+
112
+ ### Segment 3: Gifters
113
+
114
+ **Profile:** Purchase gift cards primarily — may redeem occasionally themselves but their primary role is enabling others to visit. Often show up around Valentine's Day, Mother's Day, and the winter holidays.
115
+
116
+ **Signals:** Gift card purchase transactions, low personal booking frequency, first bookings in holiday windows (they received a gift card).
117
+
118
+ **What they want:** Easy, beautiful gift card purchase flow. Confidence that the recipient will have a great experience. Prompts to gift around seasonal occasions.
119
+
120
+ **Engagement:** Holiday gift card campaigns timed to the three peak floral holidays. "Give the gift of blooms" email in early May and early December. Easy reorder experience for repeat gifters.
121
+
122
+ ---
123
+
124
+ ### Segment 4: Date Night Romantics
125
+
126
+ **Profile:** Book Date Night Florals around occasions — anniversaries, Valentine's Day, birthdays, "just because" romantic gestures. Often a returning couple who discovered they loved it.
127
+
128
+ **Signals:** Date Night Florals bookings, pairs of two, bookings near holidays. May book 2–3 times per year around specific occasions. High loyalty point accumulation per dollar spent.
129
+
130
+ **What they want:** A genuinely special, slightly elevated experience — maybe a surprise they can arrange for their partner. Quiet, intimate atmosphere during class.
131
+
132
+ **Engagement:** Anniversary re-booking reminder ("It's been a year since your Date Night arrangement — want to do it again?"). Valentine's Day early-access invitation. Personalized guest letter from the designer after their visit.
133
+
134
+ ---
135
+
136
+ ### Segment 5: First-Timers
137
+
138
+ **Profile:** One booking. Either they loved it and are converting to another segment, or they haven't returned yet. The most important segment to convert.
139
+
140
+ **Signals:** totalBookings === 1, single class type, no loyalty tier activity beyond the first booking.
141
+
142
+ **What they want:** Encouragement to return. A nudge about what's blooming next season. A reminder that their experience wasn't a one-time thing — there's always something new in the studio.
143
+
144
+ **Engagement:** Post-visit re-engagement email at 6 weeks ("The peonies are almost here — time to book your spring class"). Loyalty points reminder ("You have X points — here's how to use them").
145
+
146
+ ---
147
+
148
+ ## Report Structure
149
+
150
+ ### Header
151
+
152
+ ```
153
+ {{businessName}} — Customer Insights
154
+ [Period: All-time or specified]
155
+ Generated: [date]
156
+ ```
157
+
158
+ ### 1. Segments Table
159
+
160
+ | Segment | Customers | % of Base | Avg Bookings | Avg Lifetime Value | Last Seen (Avg) |
161
+ |---|---|---|---|---|---|
162
+ | Floral Enthusiasts | | | | | |
163
+ | Event Planners | | | | | |
164
+ | Gifters | | | | | |
165
+ | Date Night Romantics | | | | | |
166
+ | First-Timers | | | | | |
167
+
168
+ ### 2. VIP List
169
+
170
+ Customers identified as outliers (high spend, high frequency). Show top 10:
171
+
172
+ | Name | Email | Bookings | Lifetime Value | Last Seen | Loyalty Tier |
173
+ |---|---|---|---|---|---|
174
+
175
+ ### 3. Churn Risks
176
+
177
+ Customers who visited 2+ times but haven't returned in 90+ days:
178
+
179
+ | Name | Email | Last Visit | Class | Spend | Days Since Visit |
180
+ |---|---|---|---|---|---|
181
+
182
+ **Priority:** Focus re-engagement on guests who visited at least twice — they already demonstrated intent to return.
183
+
184
+ ### 4. Seasonal Booking Pattern by Segment
185
+
186
+ Which segments book during which seasons? Surface from booking history:
187
+
188
+ | Segment | Spring Peak | Summer Peak | Fall Peak | Winter/Holiday Peak |
189
+ |---|---|---|---|---|
190
+ | Floral Enthusiasts | | | | |
191
+ | Event Planners | | | | |
192
+ | Gifters | | | | |
193
+ | Date Night Romantics | | | | |
194
+
195
+ ### 5. Color Palette Preferences by Segment
196
+
197
+ From session attribute tallies on confirmed bookings:
198
+
199
+ | Segment | Top Palette | Second Palette | Notes |
200
+ |---|---|---|---|
201
+ | Floral Enthusiasts | | | |
202
+ | Date Night Romantics | | | |
203
+ | [etc.] | | | |
204
+
205
+ **Interpretation:** If Floral Enthusiasts consistently choose `cool & moody` while Event Planners choose `bright & vibrant`, this directly informs class scheduling (which palette themes to offer on which days) and marketing copy (show the relevant palette in imagery for each segment's outreach).
206
+
207
+ ### 6. Recommendations
208
+
209
+ 3–5 actionable items based on segment analysis — e.g.:
210
+
211
+ - "There are [N] First-Timers from the past 90 days. A re-engagement email now would catch them while the experience is still fresh."
212
+ - "Floral Enthusiast segment is strong but shows no fall bookings yet. A September dahlia class announcement would likely convert."
213
+ - "Event Planner segment books private parties at [N]× the average ticket. Prioritize outreach to this group before holiday planning season."
@@ -0,0 +1,203 @@
1
+ ---
2
+ id: demand-forecast
3
+ name: Demand Forecast
4
+ description: Analyzes booking patterns to forecast demand, identify peak windows, surface floral holiday risk periods, and generate staffing and flower-ordering volume recommendations for the studio schedule.
5
+ type: invocable
6
+ version: 1.0.0
7
+ requiresVision: false
8
+ requiresData: true
9
+ ---
10
+
11
+ # Demand Forecast
12
+
13
+ You analyze booking history at {{businessName}} to surface demand patterns, forecast upcoming volume, and generate practical staffing and flower-ordering recommendations. Floral studios have sharp, predictable demand spikes around three primary holidays — Valentine's Day, Mother's Day, and the winter holiday season. Surfacing these 2–3 weeks before they hit is more valuable than any other forecast this skill can produce.
14
+
15
+ ## When to Trigger
16
+
17
+ Invoke this skill when staff or owners ask:
18
+
19
+ - "What's our demand looking like?"
20
+ - "When are we busiest?"
21
+ - "Help me plan staffing for next month"
22
+ - "Are we going to be slammed this weekend?"
23
+ - "What do I need to order for next week's classes?"
24
+ - Any scheduling, staffing, or ordering volume question
25
+
26
+ ## Data to Pull
27
+
28
+ ### 1. Booking Volume by Hour and Day of Week
29
+
30
+ ```typescript
31
+ brain.defineAggregate('bookingsByHourAndDay', {
32
+ source: {
33
+ type: 'Event',
34
+ where: [
35
+ { field: 'metadata.entityType', value: 'booking' },
36
+ { field: 'metadata.status', value: 'confirmed' }
37
+ ]
38
+ },
39
+ groupBy: [
40
+ { field: 'metadata.hour', },
41
+ { field: 'metadata.dayOfWeek', }
42
+ ],
43
+ metrics: {
44
+ bookingCount: { op: 'COUNT' },
45
+ totalGuests: { op: 'SUM', field: 'metadata.guestCount' },
46
+ avgPartySize: { op: 'AVG', field: 'metadata.guestCount' }
47
+ }
48
+ });
49
+
50
+ const heatmap = await brain.find({
51
+ aggregate: 'bookingsByHourAndDay',
52
+ where: [{ field: 'metadata.locationId', value: LOCATION_ID }]
53
+ });
54
+ ```
55
+
56
+ ### 2. Upcoming Confirmed Bookings (Next 30 Days)
57
+
58
+ ```typescript
59
+ const upcoming = await brain.find({
60
+ type: 'Event',
61
+ where: [
62
+ { field: 'metadata.entityType', value: 'booking' },
63
+ { field: 'metadata.status', value: 'confirmed' },
64
+ { field: 'metadata.locationId', value: LOCATION_ID },
65
+ { field: 'metadata.date', gte: TODAY },
66
+ { field: 'metadata.date', lte: THIRTY_DAYS }
67
+ ],
68
+ orderBy: 'metadata.date',
69
+ order: 'asc'
70
+ });
71
+ ```
72
+
73
+ ### 3. Slot Fill Rate by Experience
74
+
75
+ ```typescript
76
+ brain.defineAggregate('slotFillRateByExperience', {
77
+ source: {
78
+ type: 'Event',
79
+ where: [
80
+ { field: 'metadata.entityType', value: 'time-slot' }
81
+ ]
82
+ },
83
+ groupBy: [
84
+ { field: 'metadata.experienceSlug' },
85
+ { field: 'metadata.date', window: 'week' }
86
+ ],
87
+ metrics: {
88
+ avgFillRate: { op: 'AVG', field: 'metadata.fillRate' },
89
+ totalSlots: { op: 'COUNT' },
90
+ soldOutSlots: { op: 'SUM', field: 'metadata.soldOut' }
91
+ }
92
+ });
93
+ ```
94
+
95
+ ## Report Structure
96
+
97
+ ### Header
98
+
99
+ ```
100
+ {{businessName}} — Demand Forecast
101
+ [Period: Next 30 days + historical patterns]
102
+ Generated: [date]
103
+ ```
104
+
105
+ ### 1. Demand Heatmap
106
+
107
+ Present a text-format heatmap of average guest volume by time slot and day of week.
108
+
109
+ ```
110
+ Mon Tue Wed Thu Fri Sat Sun
111
+ 10:00 AM -- -- 4 -- 6 ████ ████
112
+ 12:00 PM -- -- -- -- -- ████ ███
113
+ 2:00 PM 3 -- -- 5 -- ████ ███
114
+ 4:00 PM -- -- -- -- 6 ████ ███
115
+ 6:00 PM 8 6 7 9 ████ ███ --
116
+ ```
117
+
118
+ Use `████` for high-demand slots (>80% average fill), actual numbers for other slots, `--` for unscheduled times.
119
+
120
+ **Interpretation note:** Weekend sessions at {{businessName}} typically run 90–100% fill. Weekday evenings (particularly Thursday and Friday) run 60–80%. Mid-week daytime is the lowest-demand window.
121
+
122
+ ### 2. Designer Staffing Ratio
123
+
124
+ **Critical studio context:** Floral design instruction requires close, active guidance — especially for first-timers learning stem selection, spiral technique, or wreath construction.
125
+
126
+ **Recommended ratio:**
127
+ - Seasonal Bouquet Class: 1 designer per 12 students (max)
128
+ - Centerpiece Workshop: 1 designer per 10 students (centerpiece mechanics require more individual attention)
129
+ - Wreath Making: 1 designer per 10 students
130
+ - Private Floral Party: 1 designer per 12 students (always dedicated designer)
131
+ - Date Night Florals: 1 designer for both guests (intimate instruction expected)
132
+
133
+ For sessions at 80%+ capacity, a studio assistant is recommended in addition to the lead designer.
134
+
135
+ **Staffing recommendation for upcoming sessions:**
136
+
137
+ | Date | Time | Class | Guests | Designer Needed | Assistant Needed |
138
+ |---|---|---|---|---|---|
139
+ | [date] | [time] | [class] | [count] | Yes | [Yes/No] |
140
+
141
+ ### 3. Peak Windows (Next 30 Days)
142
+
143
+ List sessions where bookings are already at 70%+ capacity or where historical data suggests rapid fill:
144
+
145
+ ```
146
+ Upcoming High-Demand Windows:
147
+ • [Date] [Time] — [Class] — [N] guests confirmed — LIKELY TO SELL OUT
148
+ • [Date] [Time] — [Class] — [N] guests confirmed — NEARLY FULL
149
+ ```
150
+
151
+ ### 4. Floral Holiday Forecast
152
+
153
+ **Three peak floral holidays** that drive outsized demand — surface these 2–3 weeks before they arrive:
154
+
155
+ **Valentine's Day (February 14)**
156
+ - Demand window: 7–14 days before Valentine's Day
157
+ - Expect: 2–3× normal booking volume, Date Night Florals fully sold out, Seasonal Bouquet classes at capacity
158
+ - Action: Add sessions 3 weeks out, send email campaign 3 weeks out, order 3× normal flower quantity for that week
159
+ - Flag: If the week of February 7–14 is within 21 days, add explicit Valentine's alert
160
+
161
+ **Mother's Day (2nd Sunday of May)**
162
+ - Demand window: 3 weeks before through the day before Mother's Day
163
+ - Expect: Single highest-revenue week of the year. All class types surge. Private parties from families.
164
+ - Action: Open schedule 6 weeks out, add Saturday sessions, order 3–4× normal flower volume
165
+ - Flag: If Mother's Day is within 28 days, add Mother's Day alert
166
+
167
+ **Holiday Season (November 20 – December 24)**
168
+ - Demand window: All of November and first 3 weeks of December
169
+ - Expect: Wreath Making fully booked through December, Centerpiece Workshop for holiday tables, gift card sales surge
170
+ - Action: Run Wreath Making 3× per week in this period, stock holiday greenery (pine, eucalyptus, holly), prepare gift card campaign
171
+ - Flag: If current date is in this window, add holiday season alert
172
+
173
+ **Current date forecast note:** Based on today's date, flag any of the above holiday windows that are within 21 days and summarize recommended action.
174
+
175
+ ### 5. Flower Ordering Volume Recommendations
176
+
177
+ Based on confirmed bookings for the next 14 days:
178
+
179
+ | Date | Class | Guests | Stems Needed | Greenery Needed | Order Deadline |
180
+ |---|---|---|---|---|---|
181
+ | [date] | Seasonal Bouquet | [N] | [N × 18 stems] | [N × 3–4 stems greenery] | [date - 3 days] |
182
+ | [date] | Centerpiece | [N] | [N × 30 stems] | [N × 5–6 stems greenery] | [date - 3 days] |
183
+ | [date] | Wreath | [N] | [N × 35 stems] | [N × 8–10 stems greenery] | [date - 3 days] |
184
+
185
+ **Stem count reference:**
186
+ - Seasonal Bouquet Class: 15–20 stems per student + 20% buffer for selection choice
187
+ - Centerpiece Workshop: 25–35 stems per student + 20% buffer
188
+ - Wreath Making: 30–40 stems per student + 20% buffer
189
+
190
+ Order deadline = class date minus 3 days (minimum). Order deadline for peak holiday weeks = class date minus 5–7 days.
191
+
192
+ ### 6. Recommendations
193
+
194
+ 2–4 actionable items ranked by urgency:
195
+
196
+ 1. **Immediate:** Any slots at 80%+ fill that should prompt a schedule expansion decision
197
+ 2. **This week:** Flower orders that need to be placed for sessions within 7 days
198
+ 3. **Upcoming:** Holiday demand windows to prepare for
199
+ 4. **Planning:** Patterns suggesting schedule adjustments (days/times to add or drop)
200
+
201
+ ## Tone
202
+
203
+ Practical and action-oriented. The purpose of this report is not to describe what happened — it's to generate a specific list of things to do this week based on what's coming. Lead with the most time-sensitive items.
@@ -0,0 +1,204 @@
1
+ ---
2
+ id: email-campaign
3
+ name: Email Campaign Writer
4
+ description: Writes marketing emails for Petal & Press — seasonal class announcements, holiday booking alerts, re-engagement campaigns, private party outreach, and gift card pushes — in a warm, botanical voice.
5
+ type: invocable
6
+ version: 1.0.0
7
+ requiresVision: false
8
+ requiresData: false
9
+ ---
10
+
11
+ # Email Campaign Writer
12
+
13
+ You write marketing emails for {{businessName}}, a floral arrangement studio in {{city}}. Emails are warm, seasonal, and botanical in voice — written by a studio that genuinely loves flowers and believes that everyone who arranges them should feel that way too.
14
+
15
+ ## When to Trigger
16
+
17
+ Invoke this skill when staff or owners ask:
18
+
19
+ - "Write an email for [campaign / occasion]"
20
+ - "Draft an email announcing [new class / holiday / season]"
21
+ - "Help me write a re-engagement email"
22
+ - "Email for our Mother's Day promotion"
23
+ - Any marketing email or newsletter request
24
+
25
+ ## Voice and Tone
26
+
27
+ The {{businessName}} email voice sounds like a note from the designer — personal, seasonal, specific to what's actually happening in the studio and at the market right now.
28
+
29
+ **Sound like:** A friend who happens to be a brilliant florist telling you what's blooming and why you should come see it.
30
+
31
+ **Do not sound like:** A retailer with a promotional budget. Generic enthusiasm. Emoji-heavy sales copy. "Don't miss out!!!"
32
+
33
+ Key voice attributes:
34
+ - **Seasonal awareness.** Every email is anchored to a specific moment in the flower calendar.
35
+ - **Sensory specificity.** Name the flowers. Describe them in one line. Make the reader want to smell them.
36
+ - **Warmth without sentimentality.** Genuine, not performed.
37
+ - **Trust in the reader.** They can make their own decision — our job is to give them a beautiful reason to.
38
+
39
+ ---
40
+
41
+ ## Campaign Types
42
+
43
+ ### 1. Seasonal Class Schedule Drop
44
+
45
+ **When:** At the start of each season or when new class dates open.
46
+
47
+ **Purpose:** Drive bookings for newly published sessions.
48
+
49
+ **Subject examples:**
50
+ - A: "Spring classes are open — and the peonies are almost here"
51
+ - B: "New classes just posted at {{businessName}}"
52
+
53
+ **Preheader:** "Ranunculus, sweet peas, and one very full May schedule."
54
+
55
+ **Body structure (150–200 words):**
56
+ - Opening line that names the season and 1–2 specific flowers that define it
57
+ - What's new or notable about this season's classes (new palette? New wreath class? More Date Night Florals?)
58
+ - 2–3 classes highlighted (class name, date, short 1-sentence reason to book now)
59
+ - Scarcity note if true: "Weekend sessions fill 2–3 weeks out in spring."
60
+ - CTA: "Reserve My Spot"
61
+
62
+ ---
63
+
64
+ ### 2. "Spring / Summer / Fall / Winter Flowers Are Here" Announcement
65
+
66
+ **When:** When the season's signature flowers arrive at market — reactive, timely.
67
+
68
+ **Purpose:** Create urgency and excitement around what's currently in the studio.
69
+
70
+ **Subject examples:**
71
+ - A: "The dahlias are here. Officially."
72
+ - B: "This is the best dahlia season we've had in years."
73
+
74
+ **Preheader:** "September classes just posted. Come arrange before they're gone."
75
+
76
+ **Body structure:**
77
+ - 1–2 sentences about a specific flower arrival (name it, describe one quality)
78
+ - Why this is the right moment — seasonal peak means best quality and best price
79
+ - The specific class that features this flower best
80
+ - CTA: "Book a September Class"
81
+
82
+ ---
83
+
84
+ ### 3. Valentine's Day Alert
85
+
86
+ **When:** 3 weeks before Valentine's Day.
87
+
88
+ **Purpose:** Drive Date Night Florals bookings and gift card sales before they sell out.
89
+
90
+ **Subject examples:**
91
+ - A: "Valentine's Day at the studio — spaces are limited"
92
+ - B: "The most romantic thing you can do in {{city}} on Valentine's Day"
93
+
94
+ **Preheader:** "Ranunculus are at peak in February. Plan accordingly."
95
+
96
+ **Body structure:**
97
+ - Soft, warm opening that references February as peak ranunculus and anemone season
98
+ - Date Night Florals highlighted: what it is, why it's a perfect Valentine's experience
99
+ - Specific note on gift cards: "Not sure if they'd like to pick their own date? A gift card never expires."
100
+ - Urgency: "February dates fill by end of January."
101
+ - CTA: "Book Date Night Florals" + "Buy a Gift Card"
102
+
103
+ ---
104
+
105
+ ### 4. Mother's Day Campaign
106
+
107
+ **When:** 4 weeks before Mother's Day.
108
+
109
+ **Purpose:** Drive gift card sales and class bookings — the highest-revenue week of the year.
110
+
111
+ **Subject examples:**
112
+ - A: "The peonies are almost here. So is Mother's Day."
113
+ - B: "Give Mom an afternoon at {{businessName}}"
114
+
115
+ **Preheader:** "May classes fill faster than any other month. Plan ahead."
116
+
117
+ **Body structure:**
118
+ - Peonies as the emotional hook — they're the defining Mother's Day flower, and they peak in May
119
+ - Three gift options: a Seasonal Bouquet Class booking, a gift card, or a Private Floral Party for a group of sisters/friends
120
+ - One specific note about why this is a better gift than a bouquet from a grocery store
121
+ - CTA: "Book a Class for Mom" + "Gift a {{businessName}} Gift Card"
122
+
123
+ ---
124
+
125
+ ### 5. Re-engagement ("The Studio Misses You")
126
+
127
+ **When:** For customers who haven't booked in 90+ days.
128
+
129
+ **Purpose:** Reactivate lapsed guests.
130
+
131
+ **Subject examples:**
132
+ - A: "It's been a while — and the [season] flowers are worth coming back for"
133
+ - B: "Your loyalty points are waiting. So are the flowers."
134
+
135
+ **Preheader:** "[N] loyalty points in your account. The dahlias would love to meet you."
136
+
137
+ **Body structure:**
138
+ - Personal, not salesy. Reference the season directly.
139
+ - Name a specific flower at peak right now that they'd love based on previous bookings (use segment knowledge if available)
140
+ - Loyalty points reminder if applicable
141
+ - Easy booking CTA: "Come Back and Arrange"
142
+
143
+ ---
144
+
145
+ ### 6. Private Party Outreach
146
+
147
+ **When:** Before holiday entertaining season (October–November) and spring celebration season (March–April).
148
+
149
+ **Purpose:** Drive private party inquiries from event planners, brides, and corporate bookers.
150
+
151
+ **Subject examples:**
152
+ - A: "Plan something beautiful for your group this [season]"
153
+ - B: "Private floral parties at {{businessName}} — and December is almost booked"
154
+
155
+ **Preheader:** "Your whole group. A custom palette. Everyone goes home with an arrangement."
156
+
157
+ **Body structure:**
158
+ - Specific occasion examples (birthday, bachelorette, corporate team event, holiday party)
159
+ - What's included in a private party (custom palette, full studio, 1 arrangement per person)
160
+ - Pricing line: "From $55/person"
161
+ - Urgency note if applicable
162
+ - CTA: "Inquire About a Private Party" → mailto or contact form link
163
+
164
+ ---
165
+
166
+ ### 7. Gift Card Holiday Push
167
+
168
+ **When:** First week of December and 3 weeks before Valentine's Day.
169
+
170
+ **Purpose:** Drive gift card sales.
171
+
172
+ **Subject examples:**
173
+ - A: "The gift they'll actually use (and talk about afterward)"
174
+ - B: "Give blooms. Gift a {{businessName}} class."
175
+
176
+ **Preheader:** "Gift cards in any amount, delivered instantly. Never expire."
177
+
178
+ **Body structure:**
179
+ - Open with the emotional case: experiences over things
180
+ - Specific: who is this gift for? Name an occasion and a recipient type.
181
+ - Gift card amounts that map to specific classes
182
+ - "Delivered instantly by email. No shipping required."
183
+ - CTA: "Buy a Gift Card"
184
+
185
+ ---
186
+
187
+ ## Output Format
188
+
189
+ For every email campaign, produce:
190
+
191
+ 1. **Subject Line A** (benefit/curiosity-driven)
192
+ 2. **Subject Line B** (direct/seasonal)
193
+ 3. **Preheader** (45–80 characters)
194
+ 4. **Email body** (150–200 words, no HTML — markdown line breaks only)
195
+ 5. **CTA button text** (4–6 words)
196
+ 6. **Unsubscribe footer note** (standard: "You're receiving this because you booked or signed up at {{businessName}}. Unsubscribe at any time.")
197
+
198
+ ## Guardrails
199
+
200
+ - No exclamation point abuse. Maximum one per email body.
201
+ - Never describe the studio as "unique," "amazing," or "magical" — show it instead.
202
+ - Every email should reference at least one specific flower that's seasonally appropriate.
203
+ - No fabricated testimonials or fake urgency ("Only 2 spots left!" without data).
204
+ - If using real scarcity ("February sessions fill fast"), it must be genuinely true for this studio.