Agent Skill

Migrate Nanoclaw skill

migrate-nanoclawnanocoai/nanoclaw.claude/skills/migrate-nanoclaw/SKILL.md

Extracts user customizations from a fork, generates a replayable migration guide, and upgrades to upstream by reapplying customizations on a clean base. Replaces merge-based upgrades with intent-based migration.

31kMIT

always on

48 tokname + description

once used

5,636 tokSKILL.md body

bundled files

11 KB

repo stars

31kGitHub

Install the Migrate Nanoclaw skill

Skills CLI (Claude Code, Codex, Cursor and others)

npx skills add https://github.com/nanocoai/nanoclaw --skill migrate-nanoclaw

Claude Code, by hand (all projects)

git clone --depth 1 https://github.com/nanocoai/nanoclaw.git /tmp/nanoclaw
mkdir -p ~/.claude/skills
cp -R /tmp/nanoclaw/.claude/skills/migrate-nanoclaw ~/.claude/skills/migrate-nanoclaw

For one project only, copy the folder into .claude/skills/ in that project instead. The agent picks it up when a task matches its description.

What it costs your context

Agent Skills load in three steps. Tokens counted with the o200k tokenizer; your model's count will differ a little.

When	What loads	Cost
Every session	Name and description	48 tok
When the agent uses it	The SKILL.md instructions	5,636 tok
Only if opened	1 bundled files (1 KB)	varies

Until it is used, migrate-nanoclaw costs about 28× less than the median MCP server we measured (1,362 tokens on every turn). Installing all 64 skills from nanocoai/nanoclaw would load 3,369 tokens of descriptions. Skills vs MCP study

Checks

The instructions are over 5,000 tokens, the Agent Skills specification's guideline for SKILL.md.

Checked 2026-10-22 · method

What's inside

The headings of its SKILL.md. Read the full file on GitHub.

Context
Principles
Phase 0: Refresh this skill first
Phase 1: Extract
1.0 Preflight
1.1 Assess scope and determine path
Tier 1: Lightweight — suggest /update-nanoclaw instead
Tier 2: Standard
Tier 3: Complex
1.2 Update existing guide (if applicable)
1.3 Explore the codebase
1.4 Analyze customizations
1.5 Confirm with user
1.6 Migration plan (Tier 3 only)
1.7 Write the migration guide
Phase 2: Upgrade
2.0 Preflight
2.1 Safety net
2.2 Preview upstream changes
2.3 Create upgrade worktree
2.4 Reapply skills in worktree
2.5 Reapply customizations in worktree
2.6 Validate in worktree
2.7 Live test (optional)

More skills from nanocoai/nanoclaw

All skills in this repo

add-anydocnanocoai/nanoclaw
Add local office-document-to-Markdown conversion to NanoClaw agent containers with the pinned Firecrawl AnyDoc CLI. Use when agents need to read attached Word, PowerPoint, Excel, OpenDocument, RTF, EPUB, CSV, or text-based PDF files without uploading them to a hosted parser.
31k164 tok idle · 1,758 in use
add-atomic-chat-toolnanocoai/nanoclaw
Add Atomic Chat MCP server so the container agent can call local models served by the Atomic Chat desktop app via its OpenAI-compatible API.
31k433 tok idle · 2,544 in use
add-clidashnanocoai/nanoclaw
Add clidash — a zero-dependency, read-only web dashboard that derives its tabs and tables at runtime from any CLI that lists resources as JSON. Ships pre-wired for NanoClaw's ncl CLI (agent groups, sessions, channels, users, roles), plus message-activity charts, a log tail, and a read-only file viewer for group skills/CLAUDE.md/profiles.
31k2287 tok idle · 1,726 in use
add-codexnanocoai/nanoclaw
Use Codex (OpenAI's codex app-server) as a full agent provider — planning, tool orchestration, MCP tools, server-side history, session resume — alongside or instead of Claude. ChatGPT subscription or OpenAI API key, vault-only via the selected gateway. Per-group via `ncl groups config update --provider codex`. Distinct from using OpenAI as an MCP tool (where Claude remains the planner).
31k1992 tok idle · 2,392 in use
add-cursornanocoai/nanoclaw
Use Cursor (local Agent SDK) as a full agent provider — planning, tool orchestration, MCP tools, session resume — alongside or instead of Claude. Cursor-account sign-in or API key, held by the credential gateway. Per-group via `ncl groups config update --provider cursor`. Distinct from using Cursor as a cloud agent (those run on Cursor VMs and are not this provider).
31k1984 tok idle · 2,979 in use
add-dashboardnanocoai/nanoclaw
Add a monitoring dashboard to NanoClaw. Installs @nanoco/nanoclaw-dashboard and a pusher that sends periodic JSON snapshots.
31k332 tok idle · 1,317 in use
add-deltachatnanocoai/nanoclaw
Add DeltaChat channel integration via @deltachat/stdio-rpc-server. Native adapter — no Chat SDK bridge. Email-based messaging with end-to-end encryption.
31k38 tok idle · 2,646 in use
add-dialnanocoai/nanoclaw
Add Dial channel integration — a real phone number for SMS and AI voice calls via the Dial platform (getdial.ai). Native adapter — no Chat SDK bridge.
31k curl|sh36 tok idle · 5,544 in use