init

Guide an interview to write .squadkit/config.json at the repository root.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/smallorbit/smallorbit-plugins --skill init-smallorbit
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: init
Source: https://github.com/smallorbit/smallorbit-plugins/tree/main/plugins/squadkit/skills/init
Command: npx skills add https://github.com/smallorbit/smallorbit-plugins --skill init-smallorbit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Initialize Squadkit across a repository by guiding users through an interview to capture the per-repo commands and writing the .squadkit/config.json at the repo root.

Core Features & Use Cases

  • Interview-driven wizard that collects verify/install/baseBranch commands without presets.
  • Writes a single .squadkit/config.json at the repository root to standardize Squadkit workflows.
  • Avoids modifying worktrees and ensures configs are centralized for downstream Squadkit roles.

Quick Start

Run /squadkit:init to begin the interview and generate the .squadkit/config.json file at the repo root.

Frequently Asked Questions about init

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a config.json file for my repository?▼

The init wizard writes .squadkit/config.json strictly at the repository root to ensure centralized configuration. It intentionally avoids worktree directories so downstream workflows read a single, authoritative config file.

What information do I need to set up Squadkit repo configuration?▼

The Squadkit setup wizard collects five fields including verify, install, and baseBranch commands with no presets. It writes a single JSON config file to the repository root to standardize downstream workflows.

Can I initialize Squadkit config inside a git worktree?▼

No, you cannot initialize Squadkit inside a worktree. The tool enforces repository-root placement only, ensuring the config.json file remains centralized for all downstream Squadkit roles and avoids modifying worktree directories.

Does the Squadkit init wizard provide default command presets?▼

No, the Squadkit init wizard provides no default command presets. It guides you through an interview to manually capture the per-repo verify, install, and baseBranch commands for your specific project.

Why does my Squadkit configuration need to be at the repo root?▼

Your Squadkit configuration must be at the repo root to standardize downstream workflows. Centralized placement guarantees that all Squadkit roles reference a single authoritative config.json file and avoids worktree modifications.