notes-to-stories

Convert unstructured notes into structured user stories with acceptance criteria.

1|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/beekeeper-lab/foundry --skill notes-to-stories
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notes-to-stories
Source: https://github.com/beekeeper-lab/foundry/tree/main/ai-team-library/claude/skills/notes-to-stories
Command: npx skills add https://github.com/beekeeper-lab/foundry --skill notes-to-stories

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Transforms unstructured input such as meeting notes, brainstorming dumps, feature requests, Slack threads, or plain-language descriptions into structured user stories with acceptance criteria, open questions, and identified risks. This capability helps teams convert raw requirements into backlog items that are ready for planning and development.

Core Features & Use Cases

  • Parse raw input into distinct user stories by themes or features.
  • Generate stories in the standard "As a [user], I want [capability], so that [benefit]." format.
  • Define and attach testable acceptance criteria for each story.
  • Identify open questions and assign responsible owners.
  • Assess risks and categorize impact (low/medium/high).
  • Deduplicate against existing backlog items to avoid duplicates.
  • Produce structured outputs: per-story markdown, a summary, open questions, and a risk register.

Quick Start

Provide your raw notes and optional project context, then run this skill to generate structured user stories with acceptance criteria.

Frequently Asked Questions about notes-to-stories

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

FAQPage Schema
How do I convert meeting notes into user stories with acceptance criteria?

To convert meeting notes into user stories, provide raw text input to generate structured stories in the "As a [user], I want [capability], so that [benefit]" format with attached testable acceptance criteria. It parses themes from unstructured text to output distinct backlog-ready items.

Can I turn Slack threads and brainstorming dumps into backlog items?

Yes, you can turn Slack threads and brainstorming dumps into backlog items by processing them as raw input. The tool extracts requirements from chat transcripts and plain-language descriptions to produce structured user stories, a summary, open questions, and a risk register.

What is the best way to identify risks and open questions from feature requests?

The best way to identify risks and open questions from feature requests is to parse the raw text into structured outputs. The tool automatically assesses risks by impact level, identifies open questions, assigns responsible owners, and generates a dedicated risk register for backlog grooming.

Does converting raw notes into user stories support deduplication against existing backlog items?

Yes, converting raw notes into user stories supports deduplication against existing backlog items. This prevents duplicate entries by checking newly generated stories against your current project requirements before finalizing the output for development planning.

How to generate a risk register from unstructured project requirements?

To generate a risk register from unstructured project requirements, input your raw notes for processing. The tool assesses identified risks, categorizes impact as low, medium, or high, and outputs a structured register alongside user stories and open questions to support backlog grooming.

What formats of unstructured notes work for generating user stories?

Formats of unstructured notes that work for generating user stories include meeting notes, brainstorming dumps, feature requests, and chat transcripts. The tool processes these plain-language descriptions across projects to produce structured stories with acceptance criteria and risk assessments.