One-click install
npx skills add https://github.com/derrybirkett/shulkerbox --skill bloom-define
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bloom-define
Source: https://github.com/derrybirkett/shulkerbox/tree/main/skills/core/bloom-define
Command: npx skills add https://github.com/derrybirkett/shulkerbox --skill bloom-define

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the blank-page problem by converting a one-line idea or user story into a structured set of product-definition docs you can review and refine before any build starts.

Core Features & Use Cases

  • Seed-to-spine drafting: Populates intent, mission, north-star, product surfaces, architecture, and an IA graph from a short seed.
  • Template-faithful structure: Reads the expected doc shapes from .bloom/idea/templates/ and fills them with honest first drafts.
  • Assumption marking: Inserts <!-- TODO: fill in --> and <!-- assumption --> markers when details cannot be inferred, so you don’t build on guesses.
  • Pre-flight safeguards: Checks that you’re in a bloom product directory, that the seed argument exists, and warns before overwriting non-blank content.

Quick Start

Run /bloom-define with your one-line idea or user story to draft all core docs/ spine files for review.

Frequently Asked Questions about bloom-define

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a product definition from a one-line idea?▼

To generate product definition docs from a short idea, the Skill reads template structures from `.bloom/idea/templates/` and writes drafted content into `docs/` while marking unknowns as TODOs or assumptions.

What is product discovery and when do I need to draft a product spine?▼

Product discovery is the early stage where teams capture intent, mission, and architecture before implementation. You need to draft a product spine when you have a one-line idea or user story and must eliminate blank-page uncertainty before any build starts.

How do I mark assumptions and unknowns in product definition docs?▼

To mark assumptions in product definition docs, insert `<!-- TODO: fill in -->` and `<!-- assumption -->` markers when details cannot be inferred from the seed idea. This ensures unknowns are flagged for validation rather than guessed.

Do I need a specific directory scaffold to draft product architecture and IA?▼

Yes, you need a validated bloom product directory scaffold to draft product architecture and IA. The process checks for the bloom directory, reads expected doc shapes from `.bloom/idea/templates/`, and warns before overwriting non-blank content.

What's the best way to capture product intent and north-star before implementation?▼

The best way to capture product intent and north-star before implementation is to seed-to-spine draft from a one-line idea. This populates template-faithful structures with honest first drafts, capturing intent, mission, and architecture for review.

Why does my template drafting process warn before overwriting content?▼

Your template drafting process warns before overwriting content as a pre-flight safeguard to protect existing work. It checks that the seed argument exists and alerts you before overwriting non-blank content in your `docs/` directory.