nanoclawbster: Skill for Claude Code

.claude/skills/setup/SKILL.md

setup is a skill for Claude Code from sskarz/nanoclawbster. It costs 55 tokens per session (2,598 once invoked), scanned D, a copy of setup, MIT.

An installation and configuration guide for NanoClawbster, including its Discord connection and background service.

In plain words
What is it for?
It helps install dependencies, connect Discord, configure credentials, build the container, register an administrator channel, and start or troubleshoot the service.
Why use it?
It provides the steps needed to prepare a new installation and check that it is running.

Skill for Claude Code

Written for Claude Code: installed under .claude/. Also seen: names the AskUserQuestion tool; mentions Claude Code.

This is sskarz/nanoclawbster's own configuration. It tells Claude Code how to work on nanoclawbster itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything nanoclawbster configures →

Reuse

Borrowing it

Nothing to install: this file belongs to sskarz/nanoclawbster. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/sskarz/nanoclawbster/main/.claude/skills/setup/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/sskarz/nanoclawbster

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for setup

README.md
[![agentmods](https://agentmods.dev/badge/skills/sskarz/nanoclawbster/setup.svg)](https://agentmods.dev/skills/sskarz/nanoclawbster/setup)
Your own site
<a href="https://agentmods.dev/skills/sskarz/nanoclawbster/setup"><img src="https://agentmods.dev/badge/skills/sskarz/nanoclawbster/setup.svg" alt="Measured on agentmods" height="20"></a>
Per session 55 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,598 The whole file, excluding the scripts and references it only reads on demand.
Security scan D 3 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin 88% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00055 $0.02598
Opus 5 $0.00028 $0.01299
Sonnet 5 $0.00011 $0.00520
Haiku 4.5 $0.00006 $0.00260

Measured 6d ago against content hash 846be719c9c1, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade D, and why

setup scanned grade D with 3 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Asks for rootmediumPrivilege escalation

A mod that escalates privileges can change anything on the machine, not only the project.

- Linux: `curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt-get install -y nodejs`, or nvm

Downloads and executes remote codehighSupply chain

curl | sh runs whatever the server returns today, which is not necessarily what it returned when this was reviewed.

- Linux: install with `curl -fsSL https://get.docker.com | sh && sudo usermod -aG docker $USER`. Note: user may need to log out/in for group membership.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

- Linux: `curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt-get install -y nodejs`, or nvm
Origin

This is a copy

88% identical to setup — 110 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

.claude/skills/setup/SKILL.md · 181 lines

How it starts

The opening of the file, as written. The whole thing — 181 lines — stays where its author put it; the contents beside it link to each section on GitHub.

NanoClawbster Setup

Primary Path: bash setup.sh

For new installations, the recommended approach is a single command:

bash setup.sh

This runs the bootstrap (Node.js + npm install) then automatically launches an interactive wizard that handles:

  1. Docker — detects, installs, or starts Docker
  2. Credentials — prompts for Discord bot token, Claude auth (API key or OAuth), and assistant name
  3. Container image — builds the agent container with streamed output
  4. Admin channel — auto-detects the bot owner via Discord API, creates a DM channel, and registers it as the admin group
  5. Service — builds TypeScript and installs/starts the system service (systemd on Linux, launchd on macOS, nohup fallback for WSL)
  6. Verification — confirms everything is running and prints a summary

The wizard detects existing state (.env, registered groups, running service) at each step and offers to skip or reconfigure.

Secondary Path: Claude Code Skill

For power users or troubleshooting individual steps, use npx tsx setup/index.ts --step <name> with the steps below. Steps emit structured status blocks to stdout. Verbose logs go to logs/setup.log.

Principle: When something is broken or missing, fix it. Don't tell the user to go fix it themselves unless it genuinely requires their manual action (e.g. pasting a secret token). If a dependency is missing, install it. If a service won't start, diagnose and repair. Ask the user for permission when needed, then do the work.

UX Note: Use AskUserQuestion for all user-facing questions.

1. Bootstrap (Node.js + Dependencies)

Run bash setup.sh and parse the status block.

  • If NODE_OK=false → Node.js is missing or too old. Use AskUserQuestion: Would you like me to install Node.js 22? If confirmed:
    • macOS: brew install node@22 (if brew available) or install nvm then nvm install 22
    • Linux: curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt-get install -y nodejs, or nvm
    • After installing Node, re-run bash setup.sh
  • If DEPS_OK=false → Read logs/setup.log. Try: delete node_modules and package-lock.json, re-run bash setup.sh. If native module build fails, install build tools (xcode-select --install on macOS, build-essential on Linux), then retry.
  • If NATIVE_OK=false → better-sqlite3 failed to load. Install build tools and re-run.
  • Record PLATFORM and IS_WSL for later steps.

Read the full file on GitHub · 181 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago First seen · 181 lines · 55 tokens per session scan D 846be719c9c1

Subscribe to this mod's changes

setup is a skill published in the GitHub repository sskarz/nanoclawbster (2 stars, last pushed 1mo ago), licensed MIT. It adds 55 tokens to every session and 2,598 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it D with 3 findings (asks for root, downloads and executes remote code, makes network calls). It is 88% identical to setup, differing in 110 lines, and is treated as a copy.

Related

Other skills, from other repositories

host-ssh

Run PowerShell on a GuideAnts SSH machine (Windows OpenSSH) via the machine registry in the guide Environment. Use when the user needs host OS tasks — drives, dotnet, Playwright, processes — not file I/O on paths already visible in the workspace file list.

Elumenotion/GuideAnts · 61 tokens

html-craft

Create and verify single-file interactive HTML pages in the sandbox: build or edit the file, then prove the result with headless-Chromium screenshots, in-page DOM/geometry assertions, and JS-error capture (Playwright). No GPU, no service, no network. Use when the user wants an HTML page, animation, demo, dashboard, or…

Elumenotion/GuideAnts · 84 tokens

mssql-query

Query the stack's SQL Server (mssql-express) from the sandbox: probe, databases, tables, schema, sample rows, read-only SQL, and opt-in DML/DDL. Connection string comes from GADBCONNECTIONSTRING in the Guide's Environment variables. Use when the user wants to inspect or query the GuideAnts database.

Elumenotion/GuideAnts · 73 tokens

audiocpp-asr-extended

Transcription beyond the GuideAnts wrapper contract: transcribe workspace files by path (no upload, no 50 MB gateway cap), pass language hints, and sideload other qwen3-family ASR snapshots from Hugging Face through the wrapper. Use when a transcription needs a language hint, the file is large, or the user wants to…

Elumenotion/GuideAnts · 88 tokens

audiocpp-diarize

Speaker diarization: figure out who spoke when in a recording and produce a speaker-labeled transcript, by spawning a private audio.cpp engine with the sortformer diarization model and labeling each turn with the local ASR engine. Use when the user asks to diarize a meeting or call recording, separate or identify…

Elumenotion/GuideAnts · 81 tokens

audiocpp-tts-controls

Advanced synthesis controls on the loaded audio.cpp TTS model: deterministic output via seed, forcing the spoken language, voice-design from a text description (instructions), and enumerating builtin speaker ids — none of which the built-in GuideAnts audio tools expose. Use when the user wants reproducible audio, a…

Elumenotion/GuideAnts · 83 tokens