Back to Skills

fixcompliance

verified

Show what would be fixed without making changes

View on GitHub

Marketplace

brockhoff-tools

kbrockhoff/brockhoff-tools-claude

Plugin

bkff

Repository

kbrockhoff/brockhoff-tools-claude

plugins/bkff/skills/fixcompliance/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/fixcompliance/SKILL.md -a claude-code --skill fixcompliance

Installation paths:

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

Instructions

# Fix Repository Compliance

Automatically creates or updates files to bring the repository into compliance with Brockhoff Cloud spec-driven development standards.

## Usage

```
/bkff:fixcompliance
/bkff:fixcompliance --check=agents-md
/bkff:fixcompliance --dry-run
```

## What Gets Fixed

### GitHub Configuration (.github/)

| File | Action |
|------|--------|
| `.github/CODEOWNERS` | Creates with default ownership pattern (`* @OWNER`) |
| `.github/CONTRIBUTING.md` | Creates with standard contribution guidelines |
| `.github/dependabot.yml` | Creates with GitHub Actions update configuration |
| `.github/pull_request_template.md` | Creates with summary, test plan, and checklist sections |
| `.github/ISSUE_TEMPLATE/bug_report.md` | Creates bug report template with frontmatter |
| `.github/ISSUE_TEMPLATE/feature_request.md` | Creates feature request template with frontmatter |

### Agent Instructions

| File | Action |
|------|--------|
| `AGENTS.md` | Creates with project overview, bkff-git skills, and beads workflow sections |
| `CLAUDE.md` | Creates or prepends "Follow all instructions in AGENTS.md" |
| `.github/copilot-instructions.md` | Creates or prepends "Follow all instructions in AGENTS.md" |

### Beads Issue Tracking

| Component | Action |
|-----------|--------|
| `.beads/` | Runs `bd init` to initialize beads |
| Beads health | Runs `bd doctor --fix` to resolve issues |

## Output

```
Fixing Compliance Issues
─────────────────────────────────────
Info: Created .github/CODEOWNERS
Info: Created .github/CONTRIBUTING.md
Info: Created .github/dependabot.yml
Info: Created .github/pull_request_template.md
Info: Created .github/ISSUE_TEMPLATE/bug_report.md
Info: Created .github/ISSUE_TEMPLATE/feature_request.md
Info: Created AGENTS.md
Info: Created CLAUDE.md
Info: Created .github/copilot-instructions.md
Info: Initializing beads...
✓ Beads initialized
Info: Running beads health check...
─────────────────────────────────────
✓ Compliance fixes applied

Run 'bkff:c

Validation Details

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