Agent skill · DevOps & Cloud

polar-local-environment

This skill should be used when setting up or managing Polar local development environment with Docker.

fcakyongithub.com/fcakyonGitHub ↗
claude-codecodexcursorApache-2.0
Install
npx skills add fcakyon/claude-codex-settings --skill polar-local-environment --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 9
SKILL.md size: 5 KB
Bundled scripts: none
Version: 1.1.0
Declared author: polar
Path: plugins/polar-skills/skills/polar-local-environment/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 967
Language: Python

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# Local Environment Skill Helps manage the Polar local development environment through the `dev docker` CLI. Use it to start, stop, debug, or reason about the local stack. ## The two-part model `dev docker` deliberately splits the stack so many worktrees can share one set of heavy infra: - **Shared infra** — one copy per machine, Docker project `polar-shared`: postgres, redis, minio, tinybird, and optional prometheus/grafana. Postgres and redis publish no host ports; MinIO exposes 9000/9001 for browser uploads. Use `dev docker exec <service> ...` for services without host ports. - **Per-instance app stack** — one per worktree, project `polar-app-<N>`: api, worker, web. Only **api and web** publish host ports, offset per instance so worktrees don't collide. Knowing this prevents the most common confusion: there is no `localhost:5432` for the database (it lives in the shared stack and is reached through `dev docker exec db ...`). MinIO does expose ports 9000/9001 for browser uploads and console access. ## Instance auto-detection `dev docker` auto-detects the instance for the current worktree, so `-i` is rarely needed. Priority: 1. `POLAR_DOCKER_INSTANCE` pinned in `dev/docker/.env.do

What's inside
Steps it walks through
  1. The two-part model
  2. Instance auto-detection
  3. When to use
  4. Quick reference
  5. Services
  6. Instance port mapping
  7. Rules index
Ships with 8 files
  • rules/manage-instances.md
  • rules/payment-testing.md
  • rules/service-architecture.md
  • rules/shell-and-workflows.md
  • rules/start-environment.md
  • rules/stop-environment.md
  • rules/troubleshooting.md
  • rules/view-logs.md
More from claude-codex-settings
All skills →
About this skill
What does the polar-local-environment skill do?

This skill should be used when setting up or managing Polar local development environment with Docker.

How do I install it?

Run `npx skills add fcakyon/claude-codex-settings --skill polar-local-environment --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From fcakyon/claude-codex-settings, a repository with 967 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going