Back to Skills

verifyepic

verified

Output format (human or json)

View on GitHub

Marketplace

brockhoff-tools

kbrockhoff/brockhoff-tools-claude

Plugin

bkff

Repository

kbrockhoff/brockhoff-tools-claude

plugins/bkff/skills/verifyepic/SKILL.md

Last Verified

January 24, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/kbrockhoff/brockhoff-tools-claude/blob/main/plugins/bkff/skills/verifyepic/SKILL.md -a claude-code --skill verifyepic

Installation paths:

Claude
.claude/skills/verifyepic/
Powered by add-skill CLI

Instructions

# Verify Epic Completion

Verifies that a beads epic is complete by:
1. Checking all child features are closed
2. Executing the build system `verify` target for epic scope
3. Running comprehensive cross-feature validation

## Usage

```bash
# Verify epic
/bkff:verifyepic --issue=beads-abc123

# Output as JSON
/bkff:verifyepic --issue=beads-abc123 --format=json
```

## Verification Process

1. **Acceptance Criteria Check**: Epic must have defined acceptance criteria
2. **Child Features Check**: All child features must be in 'closed' status
3. **Verify Target**: Run comprehensive verification for epic scope

## What Gets Checked

The `verify` target at epic scope should run:

| Check Type | Description |
|------------|-------------|
| Cross-Feature Tests | Integration across all features |
| Epic Documentation | Epic-level documentation complete |
| System Integration | End-to-end system tests |
| All feature checks | Everything from feature verification |

## Output

### With Open Child Features

```
Warning: Epic has 3 open child feature(s)

Verification Result
─────────────────────────────────────
  Issue:          beads-abc123
  Target:         verify

✗ Verification failed

Summary:

Failures:
  beads:-: [standards] Epic has 3 open child feature(s) that must be completed first
```

### Verification Passed

```
Info: Verifying epic: beads-abc123

Verification Result
─────────────────────────────────────
  Issue:          beads-abc123
  Target:         verify

✓ Verification passed
```

## Requirements

- Beads epic must have acceptance criteria defined
- All child features must be in 'closed' status
- Build system must have a `verify` target in Makefile
- `bd` CLI must be available

## Exit Codes

- `0` - Verification passed
- `1` - Verification failed
- `2` - Missing acceptance criteria
- `3` - Missing verify target

## Related Skills

- `/bkff:verifytask` - Verify task completion
- `/bkff:verifyfeat` - Verify feature completion

## Implementation

```bash
#!/usr

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
2783 chars