CtrlK
BlogDocsLog inGet started
Tessl Logo

jbaruch/nanoclaw-host

Skills and rules for the NanoClaw host agent (Claude Code on Mac). Tile promotion, container management, staging checks, repo chain safety, and public sync.

76

Quality

95%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Medium

Suggest reviewing before use

Overview
Quality
Evals
Security
Files

cross-tier-skill-state.mdrules/

alwaysApply:
Yes

Cross-Tier Skill State

Cross-trust-tier skills — those that may run in untrusted, trusted, AND main containers — must persist state under /workspace/state/<skill-name>/. Tier-pinned skills (admin-only, trusted-only) may use /workspace/group/.

Mount semantics

  • /workspace/state/<skill-name>/ is RW in every container regardless of trust tier
  • /workspace/group/ is RW for trusted/main and RO for untrusted
  • The mount is wired in src/container-runner.ts of jbaruch/nanoclaw (search for '/workspace/state')

When to persist vs compute

  • Persist under /workspace/state/<skill-name>/ when the skill needs continuity across runs
  • Skip persistence when the value is derivable on demand — e.g., nanoclaw-core/status computes container uptime from /.dockerenv mtime

Reference implementations

  • nanoclaw-core/check-unanswered/scripts/unanswered-precheck.py reads/writes /workspace/state/check-unanswered/
  • nanoclaw-admin/brief-cleanup writes /workspace/state/brief-cleanup/
  • nanoclaw-core/status avoids persistence entirely

Both patterns are valid — pick the simpler one for the skill.

CHANGELOG.md

README.md

tile.json