Skill

polar-local-environment

Manages Polar's Docker local dev environment: start/stop/restart services, view/follow logs, shell access, status checks for FastAPI API, Next.js web, PostgreSQL, Redis.

Docker

Next.js

npx claudepluginhub fcakyon/claude-codex-settings --plugin polar-skills

Tool Access

This skill uses the workspace's default tool permissions.

Preview

This skill enables Claude to help manage the Polar local development environment using Docker. Use this when the user needs to start, stop, debug, or understand the local development stack.

Supporting Assets

rules/manage-instances.mdrules/service-architecture.mdrules/start-environment.mdrules/stop-environment.mdrules/troubleshooting.mdrules/view-logs.md

SKILL.md

Similar Skills

docker-local-dev

Generates Docker Compose and Dockerfile configurations for local development via interactive Q&A. Supports PHP/Laravel, WordPress, Drupal, Node.js, Python stacks with Nginx, Supervisor/PM2, databases, Redis, email testing.

20 files

devops-skills

reference

Provides reference for docker-local Laravel dev environment including service credentials/ports, CLI commands (status/up/down/logs), file paths, project structure, and .env requirements. Use for setup, health checks, and troubleshooting.

docker-local

docker-compose

328

Guides Docker Compose configuration for multi-container apps including services, networking, volumes, health checks, environment variables, and CLI commands. Use for local orchestration of app, DB, cache, queues.

1 file

partme-ai-full-stack-skills

Stats

Parent Repo Stars573

Parent Repo Forks51

Last CommitApr 1, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Local Environment Skill

This skill enables Claude to help manage the Polar local development environment using Docker. Use this when the user needs to start, stop, debug, or understand the local development stack.

Instance Auto-Detection

The dev docker command automatically detects the correct instance number. No manual -i flag is needed in most cases.

Detection priority:

CONDUCTOR_PORT env var → (port - 55000) / 10 + 1

Workspace path hash → stable instance derived from the repo root path

You can override with -i N if needed, but auto-detection handles Conductor workspaces automatically.

When to Use

User asks to start/stop the local environment

User needs to view logs or debug issues

User wants to run multiple isolated instances

User needs to understand the service architecture

User encounters container or service errors

Quick Reference

Task

Command

Start full stack

dev docker up -d

Stop services

dev docker down

View all logs

dev docker logs

View service logs

dev docker logs {service}

Follow logs

dev docker logs -f

Check status

dev docker ps

Restart service

dev docker restart {service}

Shell access

dev docker shell {service}

Fresh start

dev docker cleanup -f && dev docker up -d

With monitoring

dev docker up --monitoring -d

Force rebuild

dev docker up -b -d

Services

Service

Default Port

Description

api

8000

FastAPI backend

worker

Background job processor

web

3000

Next.js frontend

5432

PostgreSQL database

redis

6379

Redis cache

minio

9000/9001

S3-compatible storage

prometheus

9090

Metrics (optional)

grafana

3001

Dashboards (optional)

Instance Port Mapping

Port = Base Port + (Instance × 100)

Instance

API

Web

Redis

MinIO

8000

3000

5432

6379

9000

8100

3100

5532

6479

9100

8200

3200

5632

6579

9200

Rules Index

Rule

Local Environment Skill

This skill enables Claude to help manage the Polar local development environment using Docker. Use this when the user needs to start, stop, debug, or understand the local development stack.

Instance Auto-Detection

The dev docker command automatically detects the correct instance number. No manual -i flag is needed in most cases.

Detection priority:

CONDUCTOR_PORT env var → (port - 55000) / 10 + 1
Workspace path hash → stable instance derived from the repo root path

You can override with -i N if needed, but auto-detection handles Conductor workspaces automatically.

When to Use

User asks to start/stop the local environment
User needs to view logs or debug issues
User wants to run multiple isolated instances
User needs to understand the service architecture
User encounters container or service errors

Quick Reference

Task	Command
Start full stack	`dev docker up -d`
Stop services	`dev docker down`
View all logs	`dev docker logs`
View service logs	`dev docker logs {service}`
Follow logs	`dev docker logs -f`
Check status	`dev docker ps`
Restart service	`dev docker restart {service}`
Shell access	`dev docker shell {service}`
Fresh start	`dev docker cleanup -f && dev docker up -d`
With monitoring	`dev docker up --monitoring -d`
Force rebuild	`dev docker up -b -d`

Services

Service	Default Port	Description
api	8000	FastAPI backend
worker	-	Background job processor
web	3000	Next.js frontend
db	5432	PostgreSQL database
redis	6379	Redis cache
minio	9000/9001	S3-compatible storage
prometheus	9090	Metrics (optional)
grafana	3001	Dashboards (optional)

Instance Port Mapping

Port = Base Port + (Instance × 100)

Instance	API	Web	DB	Redis	MinIO
0	8000	3000	5432	6379	9000
1	8100	3100	5532	6479	9100
2	8200	3200	5632	6579	9200

Rules Index

Rule	Category	Description
service-architecture	Reference	Service details