Back to Skills

verifytask

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/verifytask/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/verifytask/SKILL.md -a claude-code --skill verifytask

Installation paths:

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

Instructions

# 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},
    

Validation Details

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