jbaruch/nanoclaw-host
Skills and rules for the NanoClaw host agent (Claude Code on Mac). Tile promotion, container management, staging checks, and reconciliation.
99
Quality
99%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Securityby
Advisory
Suggest reviewing before use
SKILL.mdskills/reconcile/
- name:
- reconcile
- description:
- Verify that all tessl tiles are in sync between git source, tessl registry, and the NAS orchestrator. Reports drift, unpublished content, untracked files, and version mismatches. Use when tile state seems wrong, container behavior looks stale, you suspect out-of-sync tiles, or need to check tile health before a release. Run after promoting skills or after any manual tile edits.
Reconcile Tiles
Full reconciliation check across all three tile locations.
Usage
./scripts/reconcile-tiles.shWhat it checks
- Registry vs git — diffs every rule and skill file between the registry-installed tiles and the git source baked into the orchestrator image
- Untracked files — checks for stale files on the NAS that aren't in git (leftover from manual copies)
- Version alignment — compares local tile.json version with the version installed in the orchestrator
Exit codes
0— all clean1— issues found (printed to stdout)
Issue types
| Label | Meaning | Fix |
|---|---|---|
| DRIFT | Registry and git have different content | Publish the tile to push git changes into the registry |
| GIT-ONLY | File in git but not in registry | Publish the tile to register the missing file |
| REGISTRY-ONLY | File in registry but not in git | Investigate — may be stale; remove from registry if confirmed orphaned |
| MISMATCH | Version numbers don't match | Publish the tile if git is ahead, or re-install if registry is ahead |
| Untracked | Files on NAS not in git | Delete the untracked files from the NAS |
Remediation workflow
Run reconcile, fix each reported issue, then re-run to confirm a clean result:
# 1. Run reconcile and capture output
./scripts/reconcile-tiles.sh
# 2. For each reported issue, apply the fix from the table above
# 3. Re-run to verify all issues are resolved
./scripts/reconcile-tiles.shRepeat until the script exits 0.
When to run
- After every promote cycle
- After manual tile edits
- When container behavior seems stale or wrong
- Before creating a release or snapshot