Studio Kickstart

Bootstrap agent-ready apps with framework scaffolding, quality gates, agent docs, and reusable Studio Skills.

kickstart is a CLI for starting serious projects without rebuilding the same setup every time: create the app, add the core stack, wire database/auth starters, install tests and formatting, write agent instructions, inject repeatable workflows for AI coding agents, and keep skills in sync as the library evolves.

Features

Framework scaffolding for Next.js, Expo, Turborepo + Solito, and bare projects.
Skills Sync — every project gets a .studio-skills.json lockfile; kickstart skills sync re-applies skills from it; --upgrade bumps to the latest release.
MCP Servers — scaffolded projects get Supabase and GitHub MCP pre-wired in .claude/settings.json. Pass --mcp none to opt out.
Skill Pack selection so new projects install focused Studio Skills instead of the full library by default.
Design Staging Bridge via .design-staging/.gitkeep for Open Design exports and Artifact-Pro handoffs.
Sandcastle installed in scaffolded projects for agent-assisted implementation work.
Production Pipeline guidance for CodeRabbit review of Sandcastle-generated PRs before merge.
Supabase, Better-Auth, WatermelonDB, Husky, lint-staged, Vitest, Playwright, and Prettier setup.
Verified skill adapters for Claude Code, Codex, and Pi, plus a portable Agent Skills fallback.

   SETUP           SCAFFOLD          SKILLS          GUARDRAILS        SHIP
  ┌──────┐        ┌────────┐        ┌──────┐        ┌────────┐       ┌──────┐
  │ Init │  ───▶  │ App    │  ───▶  │ Agent│  ───▶  │ Tests  │ ───▶  │ Repo │
  │ Config        │ Stack  │        │ Work │        │ Hooks  │       │ Push │
  └──────┘        └────────┘        └──────┘        └────────┘       └──────┘
  --init          --web             skills install  pre-commit       --github
                  --mobile          skills sync
                  --universal
                  --other

Commands

What you are doing	Command	Result
Configure the CLI	`kickstart --init`	Saves defaults in `~/.studio-skills/config.json`
Create a guided project	`kickstart`	Prompts for stack, name, local model mode, and GitHub mode
Create a web app	`kickstart --web my-app --github skip`	Scaffolds Next.js with Studio defaults
Create a mobile app	`kickstart --mobile my-app --github private`	Scaffolds Expo with mobile defaults
Create a universal app	`kickstart --universal my-app --github public`	Scaffolds Turborepo + Solito
Create a bare project	`kickstart --other my-app --github skip`	Git init + agent setup, bring your own framework
Choose skill packs	`kickstart --web my-app --skill-pack essential,security`	Installs only selected Studio skill packs
Install everything	`kickstart --web my-app --all-skills`	Installs the full Studio Skills library
Choose MCP servers	`kickstart --web my-app --mcp supabase,github,filesystem`	Wires selected MCP servers into `.claude/settings.json`
Skip MCP wiring	`kickstart --web my-app --mcp none`	Skips MCP config entirely
List skills	`kickstart skills list`	Reads available skills from the configured skills repo
Install one skill	`kickstart skills install tdd --agent codex`	Copies that skill into the selected agent target
Re-apply skills	`kickstart skills sync`	Re-copies skills from the locked ref in `.studio-skills.json`
Upgrade skills	`kickstart skills sync --upgrade`	Fetches the latest release tag and upgrades all installed skills

Quick Start

Install the CLI:

npm install -g studio-kickstart
kickstart --init

Create a project interactively:

kickstart

Or run it non-interactively:

kickstart --web my-app --github skip
kickstart --mobile my-mobile-app --github private
kickstart --universal my-platform --github public
kickstart --other my-app --github skip
kickstart --web lean-app --skill-pack essential,security
kickstart --web my-app --mcp none
kickstart --web pinned-app --skills-ref v1.2.0

Use a custom skills repository:

kickstart --skills https://github.com/your-org/your-skills.git --web custom-app
kickstart skills list --skills https://github.com/your-org/your-skills.git

What Gets Set Up

Area	Included
Framework	Next.js, Expo, Turborepo + Solito, or bare (git init + pnpm init)
Repository	Optional GitHub repo creation through `gh`
Database	Supabase client starter
Auth	Better-Auth starter
Offline-first	WatermelonDB starter for mobile and universal projects
Quality gates	Husky, lint-staged, Vitest, Playwright, Prettier, and Sandcastle
Agent docs	`AGENTS.md`, `CLAUDE.md`, and `GEMINI.md`
Skills	Selected Studio Skill Packs injected into `.claude/skills/` and `.agents/skills/`
Skills lockfile	`.studio-skills.json` records the repo URL, ref, packs, and installed skills
MCP servers	`.claude/settings.json` pre-wired with Supabase and GitHub MCP (default)
Design staging	`.design-staging/.gitkeep` for Open Design exports and Artifact-Pro handoffs
PR pipeline	CodeRabbit guidance for auditing Sandcastle-generated PRs before merge
Local models	Optional guidance for Ollama, LM Studio, llama.cpp, Open WebUI, or another runtime
Containers	Docker-compatible runtime guidance for Docker Desktop, Docker Engine, Podman, or OrbStack

Local model support is optional. If a user selects "Do not assume local models", generated agent docs tell Claude Code, Codex, Gemini CLI, or another active agent to use its configured model instead.

Skills Sync

Every kickstart scaffold and kickstart skills install writes a .studio-skills.json lockfile to the project root:

{
  "kickstartVersion": "1.2.0",
  "repoUrl": "https://github.com/Soham407/studio-kickstart.git",
  "ref": "v1.2.0",
  "packs": ["essential"],
  "installedAt": "2026-06-01T00:00:00.000Z",
  "lastSyncedAt": "2026-06-01T00:00:00.000Z",
  "skills": [
    { "name": "manual-sdd", "category": "architecture" },
    { "name": "tdd", "category": "architecture" }
  ]
}

Re-apply skills from the lockfile (safe, idempotent):

kickstart skills sync

Upgrade to the latest release tag in the skills repo:

kickstart skills sync --upgrade

Run from any subdirectory with --project:

kickstart skills sync --project /path/to/my-app

MCP Servers

Scaffolded projects get .claude/settings.json pre-wired with Supabase and GitHub MCP servers. Replace the placeholder values before use:

Server	Token
`supabase`	`SUPABASE_ACCESS_TOKEN` — create at supabase.com/dashboard/account/tokens
`github`	`GITHUB_TOKEN` — create at github.com/settings/tokens

Available servers: supabase, github, filesystem.

kickstart --web my-app --mcp supabase,github,filesystem
kickstart --web my-app --mcp none

Skill Packs

New projects install the Essential Pack by default unless another pack is selected.

Pack	Contents
Essential Pack	Manual-SDD, Antivibe, Watermelon Architect, Matt Pocock TypeScript, Usage Limit Reducer
Agency Pack	Agentic SEO, Marp Slides, Spider-King lead extraction, Email Campaigns
Security & Safety	Shannon-Pro, Tech Debt Audit
All Skills	Complete library for projects that want every workflow available

Interactive runs use a multi-select prompt. Scripted runs can use:

kickstart --web my-app --skill-pack essential
kickstart --web my-app --skill-pack essential,agency,security
kickstart --web my-app --all-skills

Agent Targets

Skills are plain Markdown workflows. The CLI can install them into agent-specific discovery paths:

Agent	Target
Claude Code	`.claude/skills/`
Codex	`.agents/skills/`
Pi	`.agents/skills/`
Portable Agent Skills fallback	`.agents/skills/`

Scaffolds write flattened, standard-compliant skills to both .agents/skills/ and .claude/skills/. Git-backed installs default to the immutable v1.2.0 release tag. Pass --skills-ref latest to follow the repository default branch explicitly.

Install examples:

kickstart skills install tdd
kickstart skills install tdd --agent codex
kickstart skills install hue --agent pi

All 31 Skills

The generated catalog is skills.json. A directory becomes an installable skill when it lives under architecture/, coding/, business/, or design/ and contains a SKILL.md.

Architecture

Skill	Path	What it does
`antivibe`	`architecture/antivibe`	Explains AI-written code with curated resources so users understand the what and why.
`caveman`	`architecture/caveman`	Ultra-compressed communication mode for reducing token use.
`claude-plugin-powerpack`	`architecture/claude-plugin-powerpack`	Documents the recommended Claude Code plugin stack: skill-creator, superpowers, context-mode, claude-mem, frontend-design, and get-shit-done-cc.
`diagnose`	`architecture/diagnose`	Reproduce, minimize, hypothesize, instrument, fix, and regression-test bugs.
`git-guardrails-claude-code`	`architecture/git-guardrails-claude-code`	Sets up Claude Code hooks that block dangerous git commands.
`grill-me`	`architecture/grill-me`	Stress-tests a plan through focused questioning.
`grill-with-docs`	`architecture/grill-with-docs`	Challenges a plan against project docs and updates domain decisions.
`improve-codebase-architecture`	`architecture/improve-codebase-architecture`	Finds deeper refactoring and architecture opportunities.
`manual-sdd`	`architecture/manual-sdd`	Applies a skills-first spec-driven development workflow.
`migrate-to-shoehorn`	`architecture/migrate-to-shoehorn`	Migrates test data from `as` assertions to `@total-typescript/shoehorn`.
`prototype`	`architecture/prototype`	Builds throwaway terminal or UI prototypes before committing to a design.
`scaffold-exercises`	`architecture/scaffold-exercises`	Creates exercise folders with problems, solutions, and explainers.
`setup-matt-pocock-skills`	`architecture/setup-matt-pocock-skills`	Adds repo-level agent skill docs and issue-tracker conventions.
`setup-pre-commit`	`architecture/setup-pre-commit`	Adds Husky pre-commit hooks with formatting, type checks, and tests.
`tdd`	`architecture/tdd`	Runs a red-green-refactor loop for features and bug fixes.
`to-issues`	`architecture/to-issues`	Breaks plans or PRDs into independently grabbable implementation issues.
`to-prd`	`architecture/to-prd`	Turns conversation context into a PRD and publishes it to the issue tracker.
`triage`	`architecture/triage`	Triage issues through role-driven workflow states.
`write-a-skill`	`architecture/write-a-skill`	Creates new agent skills with proper structure and progressive disclosure.
`zoom-out`	`architecture/zoom-out`	Maps an unfamiliar code area at a higher level.
`tech-debt-audit`	`architecture/tech-debt-audit`	Produces a file-cited codebase health and architecture audit.
`usage-limit-reducer`	`architecture/usage-limit-reducer`	Diagnoses token usage and applies usage-reduction rules.

Business

Skill	Path	What it does
`agentic-seo`	`business/agentic-seo`	Audits documentation and websites for AI-agent discoverability.
`email-campaigns`	`business/email-campaigns`	Designs and sends HTML email campaigns through Resend.
`marp-slides`	`business/marp-slides`	Creates MARP presentation decks with charts, themes, and visual components.
`shannon-security`	`business/shannon-security`	Guides white-box application security testing with Shannon.
`spider-king-lead-extraction`	`business/spider-king-lead-extraction`	Restores web protocols for reproducible browser-independent collection.

Design

Skill	Path	What it does
`artifact-pro-open-design`	`design/artifact-pro-open-design`	Converts Open Design JSON exports into NativeWind v4 production UI.
`hue`	`design/hue`	Generates new design language skills from references, screenshots, or prompts.

Coding

Skill	Path	What it does
`matt-pocock-typescript`	`coding/matt-pocock-typescript`	Applies the bundled TypeScript engineering workflows.
`watermelon-architect`	`coding/watermelon-architect`	Guides offline-first WatermelonDB synchronization design.

How Skills Work

Every installable skill follows the same shape:

skill-folder/
└── SKILL.md
    ├── frontmatter: name, description, type, category, tags
    ├── trigger rules: when the agent should use it
    ├── workflow: steps the agent must follow
    ├── references: optional files loaded only when needed
    └── verification: evidence required before the work is done

Design principles:

Workflow over prose. A skill should tell the agent what to do, not just describe a topic.
Progressive disclosure. Keep SKILL.md small enough to load first; put heavier references in nearby files.
Clear triggers. The description should say when the skill applies.
Verifiable output. The skill should define what proof is needed: tests, docs, screenshots, commands, or file changes.

Sandcastle Status

Sandcastle is wired into scaffolded projects.

Matt Pocock's Sandcastle is a TypeScript library for orchestrating coding agents in isolated sandboxes with sandcastle.run(). Its current quick start is:

npm install --save-dev @ai-hero/sandcastle
npx sandcastle init

kickstart installs @ai-hero/sandcastle as a dev dependency in generated projects alongside Husky, lint-staged, Vitest, Playwright, and Prettier. The CLI package itself does not depend on Sandcastle at runtime; Sandcastle belongs in the project being scaffolded, where it can run AFK agent orchestration, review pipelines, and sandboxed parallel work.

Project Structure

Studio_Skills/
├── bin/
│   └── kickstart.js              # CLI command definitions
├── lib/
│   ├── scaffold.js               # Project bootstrap orchestration
│   ├── skills.js                 # Skill clone/copy/install/sync logic
│   ├── mcp.js                    # MCP server registry and config writing
│   ├── skill-catalog.js          # Skill discovery and linting
│   ├── wizard.js                 # First-time setup wizard
│   ├── config.js                 # ~/.studio-skills/config.json
│   └── updater.js                # Best-effort npm update checks
├── scripts/
│   ├── generate-skills-catalog.js
│   └── lint-skills.js
├── architecture/                 # Installable engineering workflow skills
├── coding/                       # Coding references and future coding skills
├── business/                     # Studio operation skills
├── design/                       # Design system skills
├── .design-staging/              # Created in scaffolded projects for Open Design exports
├── test/                         # Node test runner tests
├── skills.json                   # Generated public skill catalog
├── ARCHITECTURE.md
└── README.md

Requirements

Node.js 20+
pnpm
GitHub CLI authenticated with gh auth login when using --github private or --github public
Docker-compatible runtime optional for container workloads
Local model runtime optional

Local Development

npm install
npm test
npm run skills:lint
npm run skills:catalog
npm pack --dry-run

Run all checks:

npm run check

Similar Projects

Studio Kickstart sits between framework scaffolding, agent skills, and project guardrails:

create-next-app, create-expo-app, and Solito starters for framework scaffolding
create-t3-app for opinionated full-stack setup
anthropics/skills, openai/skills, and addyosmani/agent-skills for agent skill packaging
obra/superpowers for workflow-oriented agent skills
Matt Pocock's sandcastle for sandboxed coding-agent orchestration
Aider, OpenCode, Gemini CLI, Cline, Roo Code, Continue, Cursor, and Windsurf for agent workflow expectations

The intended differentiation is the combination: project scaffolding, tool setup, agent docs, reusable skills with sync, MCP wiring, and future sandboxed agent orchestration from one guided bootstrapper.

Contributing

Start with CONTRIBUTING.md for skill structure and pull request expectations, and ARCHITECTURE.md for how the CLI and skills library fit together.

License

MIT

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Studio Kickstart

Features

Commands

Quick Start

What Gets Set Up

Skills Sync

MCP Servers

Skill Packs

Agent Targets

All 31 Skills

Architecture

Business

Design

Coding

How Skills Work

Sandcastle Status

Project Structure

Requirements

Local Development

Similar Projects

Contributing

License

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Name		Name	Last commit message	Last commit date
Latest commit History 23 Commits
.github		.github
architecture		architecture
bin		bin
business		business
coding		coding
design		design
docs		docs
lib		lib
scripts		scripts
test		test
.gitignore		.gitignore
.npmignore		.npmignore
ARCHITECTURE.md		ARCHITECTURE.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
package-lock.json		package-lock.json
package.json		package.json
skills.json		skills.json
sync-script.sh		sync-script.sh

Folders and files

Latest commit

History

Repository files navigation

Studio Kickstart

Features

Commands

Quick Start

What Gets Set Up

Skills Sync

MCP Servers

Skill Packs

Agent Targets

All 31 Skills

Architecture

Business

Design

Coding

How Skills Work

Sandcastle Status

Project Structure

Requirements

Local Development

Similar Projects

Contributing

License

About

Topics

Resources

License

Code of conduct

Contributing

Security policy

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages