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.

99

Quality

99%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Overview
Quality
Evals
Security
Files

SKILL.mdskills/promote/

name:
promote
description:
Promote agent-created skills and rules from NAS staging to tile GitHub repos. Runs tessl skill review --optimize locally before pushing, so GHA review passes first try. Use when there are new items on staging, after check-staging shows pending items, or when asked to deploy skills, push to production, or publish rules to a tile repo.

Promote from Staging

Promotes skills and rules from the agent's NAS staging area to tile GitHub repos via scripts/promote-to-tile-repo.sh.

Before promoting

Run ./scripts/check-staging.sh to see what's pending. Review each item before promoting.

Determine the target tile

Each item belongs to exactly one tile:

ContentTarget tileGitHub repo
Admin/operational skillsnanoclaw-adminjbaruch/nanoclaw-admin (private)
Trusted shared operationalnanoclaw-trustedjbaruch/nanoclaw-trusted
Security rules for untrustednanoclaw-untrustedjbaruch/nanoclaw-untrusted
Shared behavior (all containers)nanoclaw-corejbaruch/nanoclaw-core
Host agent conventionsnanoclaw-hostjbaruch/nanoclaw-host

Run the promote script

# Promote a specific skill to a tile
TILE_NAME=nanoclaw-admin ./scripts/promote-to-tile-repo.sh heartbeat

# Promote all skills + rules for a tile
TILE_NAME=nanoclaw-admin ./scripts/promote-to-tile-repo.sh all

# Promote only rules
TILE_NAME=nanoclaw-trusted ./scripts/promote-to-tile-repo.sh --rules-only

The script:

  1. Clones the tile repo from GitHub
  2. Validates tile placement (blocks admin content from untrusted/core)
  3. Checks for cross-tile duplicates
  4. Copies skills and rules into the tile repo clone
  5. Runs tessl skill review --optimize --yes on each promoted skill (shift-left: fixes quality issues before CI)
  6. Commits and pushes to the tile repo
  7. GitHub Actions runs skill review (85% threshold), lint, and tessl publish

Step 5 requires tessl on the host machine. If unavailable, the script warns and skips (GHA still gates).

After promoting

  1. Check the GitHub Actions run on the tile repo to confirm publish succeeded
  2. Tell the agent to run /verify-tiles to clean up staging copies

If GHA still fails

The local tessl skill review --optimize should prevent most failures. If GHA still fails:

tessl skill review --optimize --yes tiles/{tile-name}/skills/{skill-name}/SKILL.md

Then commit and push to the tile repo.

skills

promote

SKILL.md

tile.json