Review loop

SkillAI & models

Pre-handoff quality gate for Home Assistant YAML, docs, and agent context. Lint, validate, and smoke-check the working-tree diff. Use before handing changes to the operator.

Available today. Use it from your connected AI after setup.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the Review loop skill

What this skill tells your AI

The instructions your AI receives, as published by apocrathia/home-assistant-config in .agents/skills/review-loop/SKILL.md and read by ahel’s review.

Pre-handoff quality gate — not build+test+PR. Run in the main checkout: inspect the uncommitted (or named) diff, fix valid issues, re-check, then stop for the operator.

Does not commit, push, open PRs, or run Macroscope/Bugbot/Codex/cargo swarm loops. Override: .agents/rules/operator-owned-git.md.

Upstream of ship-work (handoff). No watch-pr.

Checks

Pick what matches the touched files:

TouchCheck
packages/**, configuration.yaml, automationsconfig-validate
Package structurepackage-organize patterns
Broken automation behaviorautomation-debug
.agents/ / docs linkspython3 .agents/skills/reconcile-context/scripts/check_links.py when relevant
Secretsno hardcoded credentials; !secret only

Also: YAML 2-space; modern automation keys (triggers / conditions / actions); entity/device/area refs look sane; no edits to .storage/ or .shopping_list.json.

Protected paths: confirm before fixing (.agents/rules/protected-paths.md).

Workflow

- [ ] 1. Diff scope (uncommitted default)
- [ ] 2. Run matching checks
- [ ] 3. Triage findings: valid / wrong / unsure
- [ ] 4. Fix valid findings (minimal); re-check
- [ ] 5. Report; hand off — no commit

Cap at a few fix iterations. If blocked (protected path, unsure finding, check failure), stop and surface it.

Report

## Review loop

**Scope:** uncommitted | named paths
**Result:** clean | blocked

### Checks

- <command or skill + outcome>

### Fixes

- <path> — <what changed>

### Left open

- <finding or blocker>

### Next

- [`ship-work`](../ship-work/SKILL.md) handoff when the operator wants a wrap

Signals

GitHub stars
179
Forks
32
Last commit
Sep 2026
Hacker News mentions
1
Advanced
Item type
skill
Key
review-loop-apocrathia
Source
github.com/apocrathia/home-assistant-config