Ship work

SkillDev tools

Hand off completed Home Assistant Homelab work to the operator: summarize diffs, suggest a Conventional Commit, list validation done, and remind them to apply/reload HA and commit. Does not commit or push.

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 Ship work skill

What this skill tells your AI

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

Handoff to operator — not commit/push/PR. Read and summarize the main checkout only.

This skill does not run git commit, git push, open PRs/MRs, create branches, or watch PRs. Folder name ship-work is kept for upstream sync identity only. Override: .agents/rules/operator-owned-git.md.

Prefer a clean review-loop first. Downstream: clock-out for session wrap (optional).

Workflow

- [ ] 1. Summarize the working-tree diff
- [ ] 2. List validation already run
- [ ] 3. Suggest a Conventional Commit message
- [ ] 4. Remind operator: apply/reload HA → live-check → commit
- [ ] 5. Stop

Diff summary

git status + git diff (staged and unstaged). Call out secrets risk, protected paths, and packages touched under packages/.

Validation already done

Cite checks from this lap (e.g. config-validate, YAML/modern-key review, link check). If review-loop was skipped, say so.

Suggested commit

Conventional Commits: type(scope): description (optional body). Examples: fix(packages): correct basement occupancy trigger, chore(agents): shorten ship-work handoff skill.

Operator next

  1. Apply / reload Home Assistant as needed for the change surface.
  2. Validate against the live instance.
  3. Commit (and push) when satisfied — operator owns git.

Report

## Ship work (handoff)

**Result:** ready for operator | blocked
**This skill did not commit or push.**

### Changed

- <path> — <one line>

### Validation

- <check + outcome>

### Suggested commit

():


### Operator next
- Apply/reload HA → live validate → commit

Do not

  • Commit, push, merge, rebase, tag, or open PRs
  • Create branches
  • Run watch-pr, sync-main.sh, or overnight ship loops
  • Write .storage/ or .shopping_list.json

Signals

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