# Create Beads

> Use when you have a design or requirements and need to create beads (epics/tasks) for implementation

- Skill: `tomevault-io/create-beads` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/create-beads`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/create-beads/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/create-beads

---


# Creating Beads

Convert designs into beads. Verify `bd` is installed first or **STOP**.

## Structure

**Multi-task features:** Epic + child tasks
```bash
bd create "Feature Name" --type epic -d "Goal and design summary"
bd create "Task 1" --parent <epic-id> -d "What to do, files to touch"
```

**Small features:** Standalone tasks
```bash
bd create "Task title" -d "Description"
```

## Task Guidelines

- Bite-sized: 2-5 minutes each
- Exact file paths
- Specific code/commands (not "add validation")
- TDD: test first, implement, commit

## Task Description Format

```
Goal: What this accomplishes
Files: exact/paths/here
Steps: 1. Write test 2. Implement 3. Verify
Acceptance: Tests pass, no regressions
```

## After Creating

```bash
bd list --parent <epic-id>  # Show tasks
bd ready                    # Find unblocked work
```

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/pprice) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->