kbrockhoff/brockhoff-tools-claude
bkff
plugins/bkff/skills/verifytask/SKILL.md
January 24, 2026
Select agents to install to:
npx add-skill https://github.com/kbrockhoff/brockhoff-tools-claude/blob/main/plugins/bkff/skills/verifytask/SKILL.md -a claude-code --skill verifytaskInstallation paths:
.claude/skills/verifytask/# Verify Task Completion
Verifies that a beads task is complete by executing the build system `validate` target. Checks acceptance criteria and runs tests, code quality, documentation, security, and standards checks.
## Usage
```bash
# Verify specific task
/bkff:verifytask --issue=beads-abc123
# Verify current task from development loop
/bkff:verifytask
# Output as JSON (for agent consumption)
/bkff:verifytask --format=json
```
## What Gets Checked
The `validate` target should run:
| Check Type | Description |
|------------|-------------|
| Tests | Unit tests, integration tests |
| Quality | Linting, static analysis (shellcheck, eslint, etc.) |
| Docs | Documentation completeness |
| Security | Security scanning, vulnerability checks |
| Standards | Code standards, formatting |
## Output
### Human-Readable (Pass)
```
Info: Verifying task: beads-abc123
Verification Result
─────────────────────────────────────
Issue: beads-abc123
Target: validate
✓ Verification passed
```
### Human-Readable (Fail)
```
Info: Verifying task: beads-abc123
Verification Result
─────────────────────────────────────
Issue: beads-abc123
Target: validate
✗ Verification failed
Summary:
• Tests failed: 2
• Quality errors: 1
Failures:
tests/test-compliance.sh:-: [test] Test failed: test_check_file_exists
lib/compliance.sh:42: [quality] SC2086: Double quote to prevent globbing
```
### JSON Format
```json
{
"issue_id": "beads-abc123",
"issue_type": "task",
"target": "validate",
"status": "fail",
"timestamp": "2026-01-24T12:00:00Z",
"acceptance_criteria_checked": true,
"failures": [
{
"file": "lib/compliance.sh",
"line": 42,
"type": "quality",
"severity": "error",
"message": "SC2086: Double quote to prevent globbing",
"hint": null
}
],
"summary": {
"tests": {"passed": 0, "failed": 2},
"quality": {"errors": 1, "warnings": 0},
"docs": {"complete": true},