story-building

Generate evidence-based user stories from git commits and gap analysis.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Mharbulous/SyncoPaid --skill story-building
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: story-building
Source: https://github.com/Mharbulous/SyncoPaid/tree/main/.claude.backup-20241224/skills/story-building
Command: npx skills add https://github.com/Mharbulous/SyncoPaid --skill story-building

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill generates user stories grounded in git commits and gap analysis, with built-in duplicate detection and vetting, then polishes stories before insertion.

Core Features & Use Cases

  • Evidence-based generation: derives stories from recent commits and documented gaps.
  • Polish-first workflow: prioritizes refining existing stories before generating new ones.
  • Deterministic prioritization: creates an initial priority list which is semantically analyzed for dependencies.
  • Vetting integration: runs a vetting pass to detect duplicates or conflicts before proceeding.

Quick Start

Run the deterministic prioritization workflow to generate a draft priority list, then analyze the top candidates for dependencies and gaps, and finally generate a concrete implementation plan.

Frequently Asked Questions about story-building

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

FAQPage Schema
How do I generate user stories from git commits automatically?

User story generation derives stories directly from recent git commits and documented gaps, applying evidence grounding to ensure each story links to concrete implementation history. The Skill analyzes commits semantically, extracts requirements, and generates acceptance criteria tied to the actual codebase changes.

What's the best way to detect duplicate user stories before adding them to a backlog?

Duplicate detection runs as a vetting pass before story acceptance, comparing new candidates against existing stories in the database to prevent redundant entries. This ensures your backlog remains clean and deduplication happens automatically during generation.

Can I use story prioritization in CI pipelines or only interactively?

Story prioritization works in both CI pipelines and interactive workflows, supporting multi-node batching. Deterministic prioritization creates an initial priority list that can be integrated into automated processes or run on demand.

How do I ensure user stories meet acceptance criteria and scope requirements?

The Skill enforces 3–5 acceptance criteria per story, validates evidence grounding, enforces scope containment, and generates unique IDs during the vetting step. All stories are validated before insertion into the database.

Does story-building polish existing stories before generating new ones?

Yes, the Skill prioritizes polishing existing stories flagged as "polish first" before generating new ones. This workflow refines the backlog incrementally rather than creating only new content.

What database and language does story-building use to store stories?

Story-building uses Python with sqlite3 to access the story-tree database stored at .claude/data/story-tree.db. The Skill does not perform repository commits itself; it only manages story data and vetting.