Self-improve

SkillDev tools

Light Home Assistant Homelab work loop: find-work, pick with the operator, implement-change, review-loop, ship-work handoff, then STOP. Use when the operator says self-improve or wants one guided contribution lap.

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 Self-improve skill

What this skill tells your AI

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

One light lap: discover → pick (with operator) → implement → review → handoff → STOP. All edits happen in the main checkout.

No autonomous PR merging, no overnight ship loops, no merge cleanup via clock-out, no watch-pr. Git stays operator-owned: .agents/rules/operator-owned-git.md.

Work sources: .agents/context/work-sources.md (incl. read-only .shopping_list.json).

Lap

flowchart TD
  start[Session /self-improve]
  start --> findWork["find-work (read-only)"]
  findWork --> pick[Operator picks Launch N]
  pick --> impl[implement-change]
  impl --> review[review-loop]
  review --> ship["ship-work (handoff only)"]
  ship --> stop[STOP]
- [ ] 1. Run [`find-work`](../find-work/SKILL.md) (read-only)
- [ ] 2. Operator picks a launch brief (or names a task)
- [ ] 3. [`implement-change`](../implement-change/SKILL.md)
- [ ] 4. [`review-loop`](../review-loop/SKILL.md)
- [ ] 5. [`ship-work`](../ship-work/SKILL.md) handoff
- [ ] 6. STOP — do not loop, merge, or clock-out-merge-cleanup

Fuzzy briefs → alignment, then stop for proceed. Protected paths → confirm before editing.

Picking

SituationAction
Operator names Launch N / a taskDo that
Operator only ran find-workStop after briefs
Vague shopping-list titleAlignment / scope first
Dedupe blocked or protected-pathStop; surface why

Do not walk briefs autonomously into commit/PR. Do not start the next find-work lap until the operator asks.

Do not

  • Commit, push, open PRs, or create branches
  • Assume overnight Cursor Automations or merge cleanup
  • Write .shopping_list.json or .storage/
  • Treat ship-work as commit/push — it is handoff only
  • Run clock-out as merge teardown (session wrap only, if asked)

Signals

GitHub stars
179
Forks
32
Last commit
Sep 2026
Advanced
Item type
skill
Key
self-improve-apocrathia
Source
github.com/apocrathia/home-assistant-config