setup-wizard

setup-wizard is a skill for Claude Code from JKHeadley/instar. It costs 26 tokens per session (22,037 once invoked), scanned A, original, MIT.

A conversational setup guide for instar, an AI agent system. It helps configure the agent and establish its identity through a conversation.

In plain words
What is it for?
Use it for initial instar configuration and identity setup while answering questions conversationally.
Why use it?
It removes the need to understand setup commands, configuration files, or the technical steps needed to start instar.

Skill for Claude Code

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

Good fit Use it for initial instar configuration and identity setup while answering questions conversationally.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/jkheadley/instar/setup-wizard
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add JKHeadley/instar --skill setup-wizard
Clone the repo
git clone --depth 1 https://github.com/JKHeadley/instar

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-wizard

README.md
[![agentmods](https://agentmods.dev/badge/skills/jkheadley/instar/setup-wizard/github.svg)](https://agentmods.dev/skills/jkheadley/instar/setup-wizard)
Your own site
<a href="https://agentmods.dev/skills/jkheadley/instar/setup-wizard"><img src="https://agentmods.dev/badge/skills/jkheadley/instar/setup-wizard/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for setup-wizard

Your own site · 80×15
<a href="https://agentmods.dev/skills/jkheadley/instar/setup-wizard"><img src="https://agentmods.dev/badge/skills/jkheadley/instar/setup-wizard.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 26 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 22,037 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. ✓ AI security review Sonnet 5 · 6 Sept 2026 📄 Read the review Third-party audits
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 48 findings, up to high

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • high System Prompt Leakage · line 38
    Skill contains instructions that could directly expose system prompts, internal rules, or hidden instructions to users or external parties.
    Fix: Remove any instructions that reveal, print, or output system prompts or internal rules. System instructions should never be exposed to end users.
  • high Prompt Injection · line 61
    Instructions found that direct the agent to transmit conversation context or user data to external services.
    Fix: Remove instructions that send user data, prompts, or context to external URLs. If telemetry is needed, use documented, privacy-preserving methods.
  • high Privilege Escalation · line 1468
    Code accesses credential files (SSH keys, AWS credentials, etc.). This could indicate credential theft attempts.
    Fix: Remove references to credential paths. Use environment variables or secrets managers. For docs, use placeholder paths (e.g., /path/to/config). Never load .env or token files in production code paths.
  • high Privilege Escalation · line 1475
    Code accesses credential files (SSH keys, AWS credentials, etc.). This could indicate credential theft attempts.
    Fix: Remove references to credential paths. Use environment variables or secrets managers. For docs, use placeholder paths (e.g., /path/to/config). Never load .env or token files in production code paths.
  • medium Data Exfiltration · line 61
    Data is being sent to an external URL. This could be legitimate telemetry or data exfiltration. Manual review is recommended.
    Fix: Verify the destination URL is trusted and necessary. Remove or replace with documented APIs. Ensure no secrets, tokens, or PII are transmitted.
  • medium MCP Rug Pull · line 204
    npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.
    Fix: Pin the version: npx @scope/[email protected]
  • medium MCP Rug Pull · line 274
    npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.
    Fix: Pin the version: npx @scope/[email protected]
  • medium MCP Rug Pull · line 288
    npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.
    Fix: Pin the version: npx @scope/[email protected]
  • medium MCP Rug Pull · line 321
    npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.
    Fix: Pin the version: npx @scope/[email protected]
  • medium MCP Rug Pull · line 414
    npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.
    Fix: Pin the version: npx @scope/[email protected]
  • medium MCP Rug Pull · line 498
    npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.
    Fix: Pin the version: npx @scope/[email protected]
  • medium MCP Rug Pull · line 505
    npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.
    Fix: Pin the version: npx @scope/[email protected]
  • medium MCP Rug Pull · line 749
    npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.
    Fix: Pin the version: npx @scope/[email protected]
  • medium MCP Rug Pull · line 1281
    npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.
    Fix: Pin the version: npx @scope/[email protected]
  • medium MCP Rug Pull · line 1836
    npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.
    Fix: Pin the version: npx @scope/[email protected]
  • medium MCP Rug Pull · line 1946
    npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.
    Fix: Pin the version: npx @scope/[email protected]
  • medium MCP Rug Pull · line 2020
    npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.
    Fix: Pin the version: npx @scope/[email protected]
  • medium Data Exfiltration · line 208
    Data is being sent to an external URL. This could be legitimate telemetry or data exfiltration. Manual review is recommended.
    Fix: Verify the destination URL is trusted and necessary. Remove or replace with documented APIs. Ensure no secrets, tokens, or PII are transmitted.
  • medium Data Exfiltration · line 208
    Data is being sent to an external URL. This could be legitimate telemetry or data exfiltration. Manual review is recommended.
    Fix: Verify the destination URL is trusted and necessary. Remove or replace with documented APIs. Ensure no secrets, tokens, or PII are transmitted.
  • medium Data Exfiltration · line 301
    Data is being sent to an external URL. This could be legitimate telemetry or data exfiltration. Manual review is recommended.
    Fix: Verify the destination URL is trusted and necessary. Remove or replace with documented APIs. Ensure no secrets, tokens, or PII are transmitted.
How audits are shown
Origin original No closer match found 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.00026 $0.22037
Opus 5.5 $0.00010 $0.08815
Sonnet 5.5 $0.00005 $0.04407
Haiku 4.5 $0.00003 $0.02204

Measured 1mo ago against content hash 813fd9164514, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

setup-wizard scanned grade A with 0 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 1mo 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.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/setup-wizard/SKILL.md · 2,133 lines

How it starts

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

Instar Setup Wizard

You are running the instar setup wizard. Your job is to walk the user through setting up their AI agent — not just configuration files, but helping their agent come to life with a real identity.

CRITICAL: No Commands in User-Facing Text

NEVER show CLI commands, file paths, or code to the user unless they explicitly ask. Speak conversationally. You are the interface — the user should never need to open a terminal or know what commands exist. If something needs to happen, do it yourself via Bash. If you need to explain something, explain the concept in plain language.

Bad: "Run instar status to check your agent." Good: "Your agent is set up and running."

Bad: "Edit .instar/config.json to change the port." Good: "I'll update the port for you. What port do you want?"

The only exception is when the user explicitly asks "what command do I run?" or "show me the CLI."

CRITICAL: NEVER Use AskUserQuestion

The AskUserQuestion tool is BANNED from this wizard. Do not use it at any step, for any reason. Its multichoice overlay hides the text above it in the terminal, making the wizard feel broken and truncated.

Instead, always present choices as inline numbered options in your text output, then wait for the user to type their choice. Example:

How much initiative should the agent take?

  1. Guided — follows your lead, confirms before acting
  2. Proactive — takes initiative, asks when uncertain
  3. Fully autonomous — owns outcomes end-to-end

Type a number or describe what you'd prefer.

This keeps all context visible. The user types "1", "2", "guided", or a free-text answer.

CRITICAL: Terminal Display Rules

This wizard runs in a terminal that may be narrow (80-120 chars). Long text gets truncated and cut off, making the wizard feel broken. Follow these rules strictly:

  1. Keep paragraphs to 2-3 sentences max. Break long explanations into multiple short paragraphs.
  2. Never write a sentence longer than ~100 characters. Break long sentences into two.
  3. Use bullet points instead of dense paragraphs for explanations.
  4. Avoid parenthetical asides — they make sentences too long. Use a separate sentence instead.
  5. When reassuring the user (e.g., "you can change this later"), keep it to ONE short sentence. Don't elaborate.

Read the full file on GitHub · 2,133 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. 1mo ago First seen · 2,133 lines · 26 tokens per session scan F 813fd9164514

Subscribe to this mod's changes

setup-wizard is a skill published in the GitHub repository JKHeadley/instar (84 stars, last pushed today), licensed MIT. It adds 26 tokens to every session and 22,037 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

phaser-pixi-2d-games

Use when building a 2D web game with Phaser (3.x/4.x) or PixiJS 8 in TypeScript - framework vs renderer, Phaser scenes/game objects/arcade physics/groups as pools/scale manager/loader, scene shutdown cleanup, PixiJS 8 async init, Assets bundles, ticker units and destroy, and keeping rules in plain TS modules.

makifbaysal/tasktrooper · 86 tokens

node-typescript-security-pitfalls

Use when reviewing Node.js or TypeScript server code - Express/Fastify/Nest handlers, Next.js server actions and route handlers, childprocess, ORM raw queries, prototype pollution, template engines, JWT and outbound HTTP clients.

makifbaysal/tasktrooper · 53 tokens

node-typescript-service

Use when building or extending a TypeScript service on Node.js - Fastify, NestJS, Express or Hono, runtime validation at the boundary, strict types, the repository's ORM and migrations, async error handling, graceful shutdown.

makifbaysal/tasktrooper · 51 tokens

react-typescript-patterns

Use when writing React + TypeScript components - functional components, explicit typed props, derived state over effects, and no any/unsafe casts.

makifbaysal/tasktrooper · 33 tokens

V3 CLI Modernization

CLI modernization and hooks system enhancement for claude-flow v3. Implements interactive prompts, command decomposition, enhanced hooks integration, and intelligent workflow automation.

ruvnet/ruflo · 35 tokens

V3 Core Implementation

Core module implementation for claude-flow v3. Implements DDD domains, clean architecture patterns, dependency injection, and modular TypeScript codebase with comprehensive testing.

ruvnet/ruflo · 37 tokens