dev-setup

Set up a local Treadstone dev environment with dependencies, Neon, and migrations.

34|1|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/earayu/treadstone --skill dev-setup-earayu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev-setup
Source: https://github.com/earayu/treadstone/tree/main/.agents/skills/dev-setup
Command: npx skills add https://github.com/earayu/treadstone --skill dev-setup-earayu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

First-time Treadstone local development environment setup. Run once after cloning the repo and before starting any development. Covers system dependency installation, Python environment, Neon database connection, migrations, and environment verification. Use this skill when the user/agent just entered the project, needs to rebuild the environment, or encounters setup-related issues like missing dependencies, broken .env, or failed migrations.

Core Features & Use Cases

  • System Dependencies verification and installation guidelines for macOS/Linux.
  • Install repo dependencies and git hooks via make install.
  • Configure Neon Serverless PostgreSQL for local API development.
  • Apply database migrations and verify the environment.
  • Optional: setup local Kubernetes cluster for sandbox development.

Quick Start

Run this skill after cloning the repo to initialize dependencies, Neon, migrations, and environment verification.

Frequently Asked Questions about dev-setup

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

FAQPage Schema
How do I set up a local Treadstone development environment from scratch?

To set up a local Treadstone development environment, run this skill after cloning the repo to install system dependencies, configure the Python environment, connect to Neon database, apply migrations, and verify the setup.

What do I need to configure before running database migrations locally?

Before running database migrations locally, you need to install repo dependencies via make install and configure Neon Serverless PostgreSQL connection settings in your local environment.

How can I verify my local development environment is configured correctly?

You can verify your local development environment by running the built-in environment checks specified in the skill, which confirm dependencies, Neon database connectivity, and migration status.

Does this local dev setup support Kubernetes cluster deployment?

Yes, the local dev setup includes optional steps to configure a local Kubernetes cluster specifically for sandbox development alongside the standard database and dependency configuration.

Why are my local environment setup and dependency installation failing?

Local environment setup and dependency installation may fail due to missing system prerequisites on macOS or Linux, broken .env configuration, or incomplete Neon database connection settings.

Can I use this setup to rebuild a broken local development environment?

Yes, you can use this setup to rebuild a broken local development environment by re-initializing dependencies, reconfiguring Neon, reapplying migrations, and resolving missing dependencies or failed migration issues.