setup

Configures a fresh Harness template repository by choosing Railway or code-only variants and pushing one commit.

Updated Aug 13, 2026
One-click install
npx skills add https://github.com/Evolutionary-Leadership/harness --skill setup-evolutionary-leadership
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup
Source: https://github.com/Evolutionary-Leadership/harness/tree/main/.claude/skills/setup
Command: npx skills add https://github.com/Evolutionary-Leadership/harness --skill setup-evolutionary-leadership

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? A repository freshly created from the Harness template starts unconfigured: it needs a deploy-target decision (Railway or code-only), an optional pre-built Next.js technical foundation, an optional MCP layer, and a change-key prefix, all applied as a single commit before any feature work can begin. ## Core Features & Use Cases - One-shot configuration: Asks a short batch of questions (deploy target, foundation, MCP, change prefix), then applies the choice, pushes exactly one commit to preprod, and deletes itself. - Railway provisioning: On the Railway path, runs a secrets preflight, lets the user pick a workspace when the account has several, and watches provisioning of production, preprod, and per-feature preview environments. - Foundation and MCP payloads: Copies a verified Next.js 16 application (Drizzle, Better Auth, TanStack Query) and an optional MCP endpoint out of quarantine, then runs a local verify chain. - Recovery handling: Detects half-applied and failed-preflight states from a previous run and resumes idempotently instead of starting over. - Use Case: You click "Use this template" on GitHub, open the new repo in Claude Code, and run /setup; after answering a few questions the repository is configured, provisioned, and ready for /feature. ## Quick Start Run /setup in a fresh repository created from the Harness template and answer the questions it asks.

Frequently Asked Questions about setup

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

FAQPage Schema
How do I set up a repository created from the Harness template?

Open the new repository in Claude Code and run /setup. It asks a few short questions about Railway deployment, the technical foundation, MCP, and your change prefix, then pushes one configuration commit and deletes itself.

What is the difference between the Railway and code-only Harness variants?

The Railway variant provisions production and preprod environments with an app service, Postgres, and object storage, plus a preview environment per feature branch. The code-only variant keeps the full branch-and-release flow with no deploy target.

Can I add the MCP endpoint after setup has finished?

No. The setup skill deletes its own payloads when it finishes, so declining MCP during setup is final. Adding it later means wiring the MCP endpoint by hand from the documentation.

What happens if /setup is interrupted partway through?

Rerun /setup. The guard step detects a half-applied state, infers the previous answers from the working tree, and reruns the idempotent apply step instead of starting over or re-asking answered questions.

Why does the secrets preflight fail during Railway setup?

The preflight fails when the Railway account token or the PAT_TOKEN secret is missing or lacks required permissions such as Contents or Secrets read and write. Fix the token in repository Settings under Secrets and variables, then rerun /setup.

What happens if I do not have a change-key prefix from the System Registry?

Setup completes normally, but /feature cannot start until the prefix exists. Get the prefix from the System Registry and add one line, change-prefix: MYPR, to .harness-version at any time.