Agent skill
beads-validation
Validates beads issues after creation. Checks dependencies, PRD mapping, order. Use when: after creating issues in project-init, before TDD loop. Triggers: "validate beads", "check issues", "verify tasks".
Install this agent skill to your Project
npx add-skill https://github.com/timequity/plugins/tree/main/vibe-coder/skills/beads-validation
SKILL.md
Beads Validation Skill
Validates that beads issues are correctly created and ready for TDD.
When to Use
-
After creating issues (in rust-project-init):
- Check all PRD features have corresponding issues
- Check priorities are valid
- Check issue IDs exist before adding dependencies
-
Before TDD loop (in /ship Phase 2.5):
- Check for circular dependencies
- Check
bd readyreturns expected first task - Check no issues are incorrectly blocked
Validation Checks
1. PRD → Issues Mapping
# Count features in PRD
grep -c "^###\|^-" docs/PRD.md | head -1
# Count issues created
bd list --status=open | wc -l
# Each MVP feature should have an issue
2. Dependency Validity
# List all dependencies
bd list --status=open --json | jq '.[] | .dependencies'
# Check each dependency ID exists
bd show {dep_id} # Should not error
3. Circular Dependency Check
# bd doctor checks for cycles
bd doctor
4. Ready State Check
# Should have at least one ready issue
bd ready --limit=1
# If empty, something is blocked incorrectly
5. Priority Validation
# All priorities should be 1, 2, or 3
bd list --json | jq '.[] | .priority' | sort -u
Script Usage
# After creating issues
python3 scripts/validate_beads.py --check-created --prd docs/PRD.md
# Before TDD
python3 scripts/validate_beads.py --check-deps --check-ready
Output:
## Beads Validation
[PASS] PRD features: 4, Issues created: 4
[PASS] All dependency IDs exist
[PASS] No circular dependencies
[PASS] Ready queue has 1 issue (notes-abc)
[PASS] All priorities valid (1-3)
Result: 5/5 checks passed
Common Issues
No Ready Issues
[FAIL] No issues ready to work on
Cause: All issues blocked by dependencies Fix: Check dependency chain, ensure at least one issue has no blockers
Missing Features
[WARN] PRD has 5 features, only 3 issues created
Fix: Create missing issues with bd create
Invalid Dependency
[FAIL] Dependency notes-xyz does not exist
Fix: Check issue ID before bd dep add
Circular Dependency
[FAIL] Circular dependency: A → B → C → A
Fix: Remove one dependency to break cycle
Integration
Called automatically in:
rust-project-init.md→ After creating issuesship.md→ Phase 2.5: Before TDD loop
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
timequity/plugins
claude-code-course
Learn Claude Code in 5 hands-on lessons. From basics to building applications. Use when: user wants to learn Claude Code, asks "how do I...", or is new. Triggers: "learn", "teach me", "how does this work", "I'm new", "course".
timequity/plugins
foundations
Claude Code basics for new users. Covers essential concepts and commands. Use when: user is new to Claude Code or routed here by learning-path assessment.
timequity/plugins
advanced
Claude Code mastery for power users. Build agents, MCP servers, publish plugins. Use when: user wants to create agents, build integrations, or publish plugins.
timequity/plugins
lessons
Lesson content for Claude Code Course. Use when: loading lesson content. Internal skill - contains lesson files.
timequity/plugins
intermediate
Claude Code customization for comfortable users. Covers skills, commands, MCP, hooks. Use when: user knows basics and wants to customize Claude Code.
timequity/plugins
course-help
Help and navigation for Claude Code Course. Use when: user asks about the course, lessons, or progress. Triggers: "help", "course help", "what lessons", "my progress".
Didn't find tool you were looking for?