Agent skill

Setup Wizard

by Touch-N-Stars in Touch-N-Stars/Touch-N-Stars

Work on the first-run / equipment setup wizard (src/components/setupWizard/) or on location and coordinate handling.

GPL-3.0Auto-check passed

Install Setup Wizard

skills CLI
$ npx skills add Touch-N-Stars/Touch-N-Stars --skill setup-wizard -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Touch-N-Stars/Touch-N-Stars setup-wizard --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Touch-N-Stars/Touch-N-Stars.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/setup-wizard .claude/skills/setup-wizard && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
setup-wizard
GitHub stars
123
Token cost
~1.2k tokens
SKILL.md length
512 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
GPL-3.0

At a glance

Work on the first-run / equipment setup wizard (src/components/setupWizard/) or on location and coordinate handling.

  • Reordering a wizard step
  • SKILL.md covers Adding a step, Auto-open on a new PINS profile, z-index staffing and Third-party INDI driver installs, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • A modal opened from the wizard appears behind it

What it does

Setup Wizard is an agent skill from Touch-N-Stars/Touch-N-Stars. Work on the first-run / equipment setup wizard (src/components/setupWizard/) or on location and coordinate handling. Use when adding or reordering a wizard step, when a modal opened from the wizard appears behind it, or when touching latitude/longitude/elevation UI anywhere in the app.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: a WebApp to controll NINA. The licence is GPL-3.0.

When your agent uses it

  • Reordering a wizard step
  • A modal opened from the wizard appears behind it
  • Touching latitude/longitude/elevation UI anywhere in the app

Example prompts

  • “/setup-wizard”

What it can do on your machine

Read from SKILL.md and the folder at commit c7af082. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Setup Wizard loads about 1.2k tokens when it runs. Until then it costs about 75 tokens; SKILL.md has 512 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~75
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Touch-N-Stars/Touch-N-Stars at commit c7af082, republished under its GPL-3.0 licence (© Touch-N-Stars). 512 words, ~1,184 tokens.

Download SKILL.mdSave it as .claude/skills/setup-wizard/SKILL.md (or your agent's skills folder).
name
setup-wizard
description
Work on the first-run / equipment setup wizard (src/components/setupWizard/) or on location and coordinate handling. Use when adding or reordering a wizard step, when a modal opened from the wizard appears behind it, or when touching latitude/longitude/elevation UI anywhere in the app.

Setup wizard and location handling

src/components/setupWizard/ is the cancellable first-run and equipment wizard. It opens before setup is complete and is ordered ahead of the tutorial and What's New. Cancel and finish are the same transaction — both call completeSetupWizard(), so the app is usable either way.

Adding a step

One entry in the computed steps list in SetupWizard.vue:194, plus one v-else-if branch. Nothing else in the wizard shell is step-count aware.

The step order carries reasons, and they are written as comments next to the entries — read them before reordering. The load-bearing ones:

  • Localization before Wi-Fi, so the regulatory country, timezone, locale and remote keyboard layout are set before networking is configured.
  • Mount before location, because the location sync needs a connected mount.
  • Telescope before camera, because the camera step's image-scale readout needs TelescopeSettings.FocalLength.
  • Guiding after mount and before camera, because PHD2 needs a connected mount, and once the imaging camera is connected PHD2 can no longer scan for the guide camera.
  • Dither last, as its own step, because the calculator needs the imaging camera and telescope values as well as the guide setup.

PINS-only steps (localization, wifi, updates, slewRate, guider, dither) are spliced in conditionally, which is why steps are tracked by id, not by index (currentStepId): the list grows underneath the user when isPINS flips. A persisted id that no longer exists falls back to index 0 rather than rendering nothing.

The wizard hides itself while pinsStore.shouldShowUpgradeOverlay is true and persists settingsStore.setupWizard.currentStepId — a PINS upgrade restarts services and can temporarily interrupt the app connection.

Auto-open on a new PINS profile

After the first-run pass, App.vue reopens the wizard (at localization) when on PINS the active profile has no device selected and its Id is not yet in the localStorage list setupWizardSeenProfiles — a freshly flashed image or a profile added in the profile manager. Criteria live in src/utils/setupWizardProfile.js. Equipment is read from profileInfo, not existingEquipmentList: clearAllStates() empties that list on every transient connection loss while the profile stays.

Show full SKILL.md (183 more words)Show less

z-index staffing

Modals opened from inside the wizard teleport to body, so they need explicit layering or they open invisibly behind it:

LayerValue
Modal.vue defaultz-40
LoadingOverlayz-[60]
Wizard overlayz-70
Modals opened from the wizardz-[75]
LocationSyncModalz-[76] — it blocks the mount connect
PINS upgrade overlay, DialogModalz-[80]

Indi3rdpartyInstallPanel.vue:19 documents this at the call site.

Third-party INDI driver installs

ALLOWED_INDI_DRIVER_TYPES in src/plugins/pins/composables/indiInstallUtils.js:39 accepts eight types: camera, filterwheel, flatpanel, focuser, rotator, switches, telescope, weather. It must stay in sync with TYPE_OPTIONS in PinsIndiRegistryEditModal.vue:303 — the registry an installed driver is written into. Both are currently identical; dome and safetymonitor are covered by neither.

Location handling

The refs in src/utils/location.js are module singletons (latitude, longitude, altitude, syncDirection, ninaCoords, mountCoords), shared between the wizard's location step and LocationSettingsPins.vue. Always call useLocationStore().loadFromAstrometrySettings() when entering a location UI instead of trusting what the previous screen left behind.

  • getCurrentLocation() writes strings (toFixed). Use text inputs, not NumberInputPicker. saveCoordinates() sanitizes them, including a decimal comma.
  • With syncDirection === 'TOTELESCOPE', saveCoordinates() disconnects and reconnects the mount and takes PHD2 with it. That takes several seconds, so a loading flag is mandatory.

© Touch-N-Stars, GPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/setup-wizard of Touch-N-Stars/Touch-N-Stars.

Open the folder on GitHubat commit c7af082

Compare with similar skills

Setup Wizard next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Setup Wizard compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Setup Wizard this skillTouch-N-Stars/Touch-N-Stars123—~1.2kAutomated safety check: PassGPL-3.0
Wizardvinvcn/mattpocock-skills-zh-CN4.7k—~556Automated safety check: NotesMIT
Wizardbestofjs/bestofjs3.1k12 repos~1kAutomated safety check: NotesMIT
Ink Tui Wizardnovuhq/novu40k—~1.9kAutomated safety check: PassMIT
Faf Wizardsickn33/agentic-awesome-skills47k2 repos~1.8kAutomated safety check: PassMIT
Wizardnodetool-ai/nodetool560—~1kAutomated safety check: NotesAGPL-3.0

Similar skills

  • Wizard

    vinvcn/mattpocock-skills-zh-CN

    生成一个交互式 bash wizard,逐步引导人完成只有他们能执行的手动流程。用于 provisioning 基础设施、设置 credentials 或 CI secrets、走查不熟悉的第三方 dashboard,或运行一次性 migration 或 cutover。对于 agent 自己就能执行的步骤,不要调用它。

    4.7k GitHub stars~556 tokensUpdated today
    DevelopmentAuto-check: notes
  • Wizard

    bestofjs/bestofjs

    Generate an interactive bash wizard that walks a human through steps only they can perform.

    3.1k GitHub starsUsed in 12 repos~1k tokens
    Auto-check: notes
  • Ink Tui Wizard

    novuhq/novu

    Build terminal user interfaces (TUIs) using Ink (React for CLIs) and @inkjs/ui with a reactive, session-driven wizard pattern.

    40k GitHub stars~1.9k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Faf Wizard

    sickn33/agentic-awesome-skills

    Done-for-you .faf generator. An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~1.8k tokens
    Backend & APIsAuto-check passed
  • Wizard

    nodetool-ai/nodetool

    Generate an interactive Bash procedure for steps requiring human access, credentials, or manual decisions.

    560 GitHub stars~1k tokensUpdated today
    Auto-check: notes
  • Wizard

    devcxl/mattpocock-skills-zh

    生成一个交互式 bash 向导,引导人类完成只有他们能执行的步骤。适用于配置基础设施、设置凭证或 CI 密钥、操作不熟悉的第三方面板、或执行一次性迁移或切换。不要让代理替自己执行本应由人类完成的步骤。

    440 GitHub stars~482 tokensUpdated today
    DevelopmentAuto-check: notes

More from Touch-N-Stars/Touch-N-Stars

  • API Endpoint

    Touch-N-Stars/Touch-N-Stars

    Add or change an API call between the app and its backends — the Touch'N'Stars plugin server (C), the NINA Advanced API, or the PINS daemon.

    123 GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Changelog

    Touch-N-Stars/Touch-N-Stars

    Write or fix a CHANGELOG.md release entry. An agent skill from Touch-N-Stars/Touch-N-Stars.

    123 GitHub stars~725 tokensUpdated today
    Auto-check passed
  • Equipment

    Touch-N-Stars/Touch-N-Stars

    Work on equipment devices — INDI driver selection, device lists, connect/disconnect, and the NINA profile values behind them (camera, mount, focuser, filter wheel, rotator, switch, weather, flat…

    123 GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Feature Kickoff

    Touch-N-Stars/Touch-N-Stars

    Turn a rough feature idea into a written goal and testable acceptance criteria before any code is written.

    123 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • I18n

    Touch-N-Stars/Touch-N-Stars

    Add, rename, or remove user-facing strings in src/locales. An agent skill from Touch-N-Stars/Touch-N-Stars.

    123 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Tns Review

    Touch-N-Stars/Touch-N-Stars

    Review changed Touch'N'Stars code with three parallel agents, one each for functionality, UI and maintainability, against this project's own rules (NINA/PINS dual mode, polling contract…

    123 GitHub stars~1.7k tokensUpdated today
    Auto-check passed

Questions about Setup Wizard

What does Setup Wizard do?

Work on the first-run / equipment setup wizard (src/components/setupWizard/) or on location and coordinate handling. Setup Wizard is an agent skill from Touch-N-Stars/Touch-N-Stars. Work on the first-run / equipment setup wizard (src/components/setupWizard/) or on location and coordinate handling.

When should I use Setup Wizard?

Setup Wizard fits situations like: reordering a wizard step; A modal opened from the wizard appears behind it; touching latitude/longitude/elevation UI anywhere in the app.

How do I install Setup Wizard in Claude Code?

Run `npx skills add Touch-N-Stars/Touch-N-Stars --skill setup-wizard -a claude-code`. Or copy the skill folder (.claude/skills/setup-wizard in Touch-N-Stars/Touch-N-Stars) into .claude/skills/setup-wizard in your project. Claude Code loads it when a task matches its description.

How do I install Setup Wizard in Codex?

Run `npx skills add Touch-N-Stars/Touch-N-Stars --skill setup-wizard -a codex`. Or copy the skill folder (.claude/skills/setup-wizard in Touch-N-Stars/Touch-N-Stars) into .agents/skills/setup-wizard in your project. Codex loads it when a task matches its description.

Can I use Setup Wizard in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Touch-N-Stars/Touch-N-Stars --skill setup-wizard -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/setup-wizard, .gemini/skills/setup-wizard, .github/skills/setup-wizard and .opencode/skills/setup-wizard in your project.

What does Setup Wizard need to run?

SKILL.md names no scripts, command-line tools or credentials: Setup Wizard is instructions for the agent only.

Does Setup Wizard access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Setup Wizard safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Setup Wizard use?

Setup Wizard is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Setup Wizard use?

About 1.2k tokens (SKILL.md is roughly 4.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Setup Wizard?

Skills that share tags, products or a category with Setup Wizard: Wizard (vinvcn/mattpocock-skills-zh-CN, 4.7k stars), Wizard (bestofjs/bestofjs, 3.1k stars), Ink Tui Wizard (novuhq/novu, 40k stars) and Faf Wizard (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Setup Wizard?

Touch-N-Stars (a GitHub organization) maintains it in Touch-N-Stars/Touch-N-Stars, which has 123 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 8, 2026.

Source: Touch-N-Stars/Touch-N-Stars on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.