One-click install
npx skills add https://github.com/escotilha/claude-public --skill run-local-escotilha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run-local
Source: https://github.com/escotilha/claude-public/tree/main/skills/run-local
Command: npx skills add https://github.com/escotilha/claude-public --skill run-local-escotilha

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Starting a project locally can be slow and error-prone because you must manually install dependencies, launch multiple services, and verify that everything is actually healthy before you begin development.

Core Features & Use Cases

  • Auto-detect project services: Scans for common ecosystems (Node/Next/Vite, Python/FastAPI/Django, Go, Docker Compose databases/caches) and builds a services plan.
  • Dependency installation orchestration: Installs runtime dependencies across supported package managers (e.g., npm/pnpm/yarn and Python dependency managers) before starting services.
  • Health checks and lifecycle commands: Runs service health verification, then supports stopping and viewing aggregated logs for the same environment.
  • Use Case: You open a new repo, want the backend + frontend + Postgres/Redis to be running and verified, and you want a reusable local config that avoids re-detection on every restart.

Quick Start

Run /run-local to detect your project, install dependencies, start all local services, and verify health.

Frequently Asked Questions about run-local

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

FAQPage Schema
How do I start a full local development environment with frontend, backend, and Docker services in one command?

To start a local development environment, run a single command to auto-detect project services, install dependencies across Node, Python, and Docker Compose, orchestrate startup, and run health checks. This creates a reusable .run-local.json configuration for subsequent restarts.

How do I run health checks on my local dev server and view aggregated logs?

To run health checks on your local dev server, the environment orchestration verifies service availability after startup. You can view aggregated logs for all running backend, frontend, and database services using the built-in logs operation.

Can I use this to orchestrate Docker Compose databases and caches alongside a Node or Python API?

Yes, you can orchestrate Docker Compose databases and caches alongside Node, Next, Vite, Python, FastAPI, Django, and Go services. The tool scans for these common ecosystems and builds a unified services plan to run them together locally.

What is the best way to manage the lifecycle of multiple local development services?

The best way to manage multiple local development services is using lifecycle commands that support start, status, stop, and logs operations. This allows you to control your entire infrastructure stack and monitor health without manual intervention.

Does local development orchestration automatically install dependencies before starting services?

Yes, local development orchestration automatically installs runtime dependencies before starting services. It coordinates installation across supported package managers like npm, pnpm, yarn, and Python dependency managers to ensure all required libraries are present.

Why does my local dev environment need a .run-local.json configuration file?

A local dev environment needs a .run-local.json configuration file to store the detected services plan and avoid re-detection on every restart. This configuration is created on the first run and reused for subsequent start, stop, and status operations.