Back to Skills

chkcompliance

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

Installation paths:

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

Instructions

# Check Repository Compliance

Validates that the current repository meets Brockhoff Cloud spec-driven development standards. Reports which components are compliant and which need attention.

## Usage

```
/bkff:chkcompliance
/bkff:chkcompliance --format=json
```

## Compliance Checks

The following components are validated:

### GitHub Configuration (.github/)
| Check | Path | Description |
|-------|------|-------------|
| github-dir | `.github/` | GitHub configuration directory |
| github-codeowners | `.github/CODEOWNERS` | Code review ownership rules |
| github-contributing | `.github/CONTRIBUTING.md` | Contribution guidelines |
| github-dependabot | `.github/dependabot.yml` | Automated dependency updates |
| github-pr-template | `.github/pull_request_template.md` | PR template for consistency |
| github-issue-templates | `.github/ISSUE_TEMPLATE/` | Issue templates directory |
| github-bug-template | `.github/ISSUE_TEMPLATE/bug_report.md` | Bug report template |
| github-feature-template | `.github/ISSUE_TEMPLATE/feature_request.md` | Feature request template |

### Agent Instructions
| Check | Path | Description |
|-------|------|-------------|
| agents-md | `AGENTS.md` | Agent instructions file with project overview |
| claude-md | `CLAUDE.md` | Must reference AGENTS.md |
| copilot-instructions | `.github/copilot-instructions.md` | Must reference AGENTS.md |

### Beads Issue Tracking
| Check | Path | Description |
|-------|------|-------------|
| beads-init | `.beads/` | Beads must be initialized |
| beads-health | `bd doctor` | Beads health check must pass |

## Output

### Human-Readable (default)
```
Compliance Report
─────────────────────────────────────
  ✓ github-dir
  ✓ github-codeowners
  ✗ github-contributing
    → File missing: .github/CONTRIBUTING.md
  ✓ agents-md
  ✓ claude-md
  ✓ beads-init
  ○ beads-health (skipped)
    → Beads not initialized
─────────────────────────────────────
2 check(s) failed (10 passed, 2 failed)

Run 'bkff:fixcompliance' t

Validation Details

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