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.