Verifier Web
polarsource/polar
Evidence-capture protocol for verifying web/dashboard/backoffice/checkout changes in the Polar local stack by driving the real UI with Playwright.
This skill should be used when setting up or managing Polar local development environment with Docker.
Install Polar Local Environment
$ npx skills add fcakyon/claude-codex-settings --skill polar-local-environment -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install fcakyon/claude-codex-settings polar-local-environment --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/fcakyon/claude-codex-settings.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/polar-skills/skills/polar-local-environment .claude/skills/polar-local-environment && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "polar-local-environment" agent skill from https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/polar-skills/skills/polar-local-environment into .claude/skills/polar-local-environment/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "polar-local-environment", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/polar-skills/skills/polar-local-environmentType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add fcakyon/claude-codex-settings --skill polar-local-environment -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install fcakyon/claude-codex-settings polar-local-environment --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/fcakyon/claude-codex-settings.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/polar-skills/skills/polar-local-environment .agents/skills/polar-local-environment && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "polar-local-environment" agent skill from https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/polar-skills/skills/polar-local-environment into .agents/skills/polar-local-environment/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "polar-local-environment", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add fcakyon/claude-codex-settings --skill polar-local-environment -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install fcakyon/claude-codex-settings polar-local-environment --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/fcakyon/claude-codex-settings.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/polar-skills/skills/polar-local-environment .cursor/skills/polar-local-environment && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "polar-local-environment" agent skill from https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/polar-skills/skills/polar-local-environment into .cursor/skills/polar-local-environment/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "polar-local-environment", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/fcakyon/claude-codex-settings.git --path plugins/polar-skills/skills/polar-local-environment--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add fcakyon/claude-codex-settings --skill polar-local-environment -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install fcakyon/claude-codex-settings polar-local-environment --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/fcakyon/claude-codex-settings.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/polar-skills/skills/polar-local-environment .gemini/skills/polar-local-environment && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "polar-local-environment" agent skill from https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/polar-skills/skills/polar-local-environment into .gemini/skills/polar-local-environment/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "polar-local-environment", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install fcakyon/claude-codex-settings polar-local-environmentInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add fcakyon/claude-codex-settings --skill polar-local-environment -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/fcakyon/claude-codex-settings.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/polar-skills/skills/polar-local-environment .github/skills/polar-local-environment && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "polar-local-environment" agent skill from https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/polar-skills/skills/polar-local-environment into .github/skills/polar-local-environment/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "polar-local-environment", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add fcakyon/claude-codex-settings --skill polar-local-environment -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install fcakyon/claude-codex-settings polar-local-environment --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/fcakyon/claude-codex-settings.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/polar-skills/skills/polar-local-environment .opencode/skills/polar-local-environment && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "polar-local-environment" agent skill from https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/polar-skills/skills/polar-local-environment into .opencode/skills/polar-local-environment/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "polar-local-environment", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
polar-local-environment- GitHub stars
- 1.2k
- Token cost
- ~1.4k tokens
- SKILL.md length
- 631 words
- Files
- 9
- Skills in repo
- 44
- Repo updated
- First seen
- Licence
- MIT
At a glance
This skill should be used when setting up or managing Polar local development environment with Docker.
- Works in 3 steps: POLAR_DOCKER_INSTANCE pinned in… → The cross-worktree registry… → Otherwise the lowest free number, then…
- Tasks that involve DataFrames
- SKILL.md covers The two-part model, Instance auto-detection, When to use and Quick reference, plus 3 more sections
- Calls docker
What it does
Polar Local Environment is an agent skill from fcakyon/claude-codex-settings. This skill should be used when setting up or managing Polar local development environment with Docker.
Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files (for example `rules/manage-instances.md`, `rules/payment-testing.md` and `rules/service-architecture.md`).
It sits in Data & Analytics, covering DataFrames and Containers. It works with Docker. The repository describes itself as: Battle-tested Claude Code, OpenAI Codex, Cursor configs, plugins, hooks and agents with Kimi, MiniMax and GLM API support. The licence is MIT.
When your agent uses it
- Tasks that involve DataFrames
- Tasks that involve Containers
Example prompts
- “/polar-local-environment”
Requirements
- Docker
Workflow steps
3 steps, taken from the first numbered list in SKILL.md.
- POLAR_DOCKER_INSTANCE pinned in dev/docker/.env.docker (dev docker set-instance N)
- The cross-worktree registry (~/.config/polar/docker-instances.json)
- Otherwise the lowest free number, then registered
What it can do on your machine
Read from SKILL.md and the folder at commit 7a519d8. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
docker
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use docker, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Polar Local Environment loads about 1.4k tokens when it runs. Until then it costs about 32 tokens; SKILL.md has 631 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check: notes
The automated check noted patterns worth knowing about, such as sudo or a known installer.
- NoteMentions a .env fileSKILL.md:38
R_DOCKER_INSTANCE` pinned in `dev/docker/.env.docker` (`dev docker set-instance N`)
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from fcakyon/claude-codex-settings at commit 7a519d8, republished under its MIT licence (© fcakyon). 631 words, ~1,364 tokens.
Download SKILL.mdSave it as
.claude/skills/polar-local-environment/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.- name
- polar-local-environment
- description
- This skill should be used when setting up or managing Polar local development environment with Docker.
- license
- MIT
- metadata.author
- polar
- metadata.version
- 1.1.0
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. Usedev 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:
POLAR_DOCKER_INSTANCEpinned indev/docker/.env.docker(dev docker set-instance N)- The cross-worktree registry (
~/.config/polar/docker-instances.json) - Otherwise the lowest free number, then registered
Run dev docker ports to see the resolved instance and its URLs (add --json
for tooling). To wire this worktree into Claude Code's preview, run
dev docker launch-json, which writes a per-instance .claude/launch.json with
the correct ports (it's gitignored, so regenerate after set-instance).
When to use
- Start / stop / restart the local environment
- View logs or debug a service that won't come up
- Run several isolated worktree instances in parallel
- Understand the service architecture or find a service's real port
- Diagnose container or first-boot errors
Quick reference
| Task | Command |
|---|---|
| Start full stack (background) | dev docker up -d |
| Start and block until healthy | dev docker up -d --wait |
| Start in foreground (stream logs) | dev docker up --no-detach |
| Rebuild with fresh base images | dev docker up -b --pull -d |
| Show this instance's ports/URLs | dev docker ports (--json for tooling) |
| Write Claude Code preview config | dev docker launch-json |
| Stop app stack | dev docker down |
| Stop app and shared infra | dev docker down --all |
| Follow logs | dev docker logs -f [service] |
| Print logs and exit | dev docker logs --no-follow [service] |
| Status | dev docker ps |
| Restart a service | dev docker restart <service> |
| Shell into a service | dev docker shell <service> |
| One-off command in a service | dev docker exec <service> <cmd> |
| Reset this instance | dev docker cleanup -f |
| Wipe ALL shared data | dev docker cleanup --all -f |
| List every instance | dev docker list |
| With monitoring | dev docker up --monitoring -d |
Show full SKILL.md (210 more words)Show less
Services
| Service | Project | Host port (instance 0 / N) | Notes |
|---|---|---|---|
| api | polar-app-<N> | 8000 / 8100+N | FastAPI; /healthz healthcheck |
| web | polar-app-<N> | 3000 / 3100+N | Next.js; healthchecked |
| worker | polar-app-<N> | none | Background jobs |
| db | polar-shared | none (exec) | PostgreSQL; DB polar_dev_<N> |
| redis | polar-shared | none (exec) | Redis DB index = N |
| minio | polar-shared | 9000, 9001 | S3; buckets polar-s3-<N>; console at 9001 |
| tinybird | polar-shared | none (exec) | Analytics |
| prometheus / grafana | polar-shared | none (exec) | --monitoring only |
Discover the exact host ports for the current worktree with dev docker ports.
Instance port mapping
Only api and web get host ports: Port = Base + Instance (Base 8100 for api,
3100 for web) for instances 1–99. Instance 0 uses the legacy 8000 / 3000.
| Instance | API | Web |
|---|---|---|
| 0 | 8000 | 3000 |
| 1 | 8101 | 3101 |
| 2 | 8102 | 3102 |
| 5 | 8105 | 3105 |
Everything else is per-instance but not on a host port: database polar_dev_<N>,
redis DB index <N>, buckets polar-s3-<N> / polar-s3-public-<N>. Reach them
via dev docker exec <service> or docker exec polar-shared-<service>-1.
Rules index
| Rule | Category | Description |
|---|---|---|
| service-architecture | Reference | Service details, ports, healthchecks |
| start-environment | Operations | Starting the stack (flags, --wait, --pull) |
| stop-environment | Operations | Stopping and cleanup (app vs shared) |
| manage-instances | Operations | Parallel worktree instances |
| view-logs | Debugging | Viewing service logs |
| shell-and-workflows | Operations | Shell access and common dev workflows |
| troubleshooting | Debugging | Common errors and fixes |
| payment-testing | Operations | Login codes, Stripe webhooks, backoffice |
© fcakyon, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 8 other files in plugins/polar-skills/skills/polar-local-environment of fcakyon/claude-codex-settings.
- SKILL.md
- 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
Open the folder on GitHubat commit 7a519d8
Compare with similar skills
Polar Local Environment next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Polar Local Environment this skillfcakyon/claude-codex-settings | 1.2k | — | ~1.4k | Automated safety check: Notes | MIT | |
| Verifier Webpolarsource/polar | 10k | — | ~3k | Automated safety check: Notes | MIT | |
| Local Environmentpolarsource/polar | 10k | — | ~1.4k | Automated safety check: Notes | MIT | |
| Tao Analyze Gaps Visual ChangenetNVIDIA/skills | 3.5k | — | ~4.3k | Automated safety check: Notes | Apache-2.0 | |
| Time Series Analytics Useropen-edge-platform/edge-ai-libraries | 169 | — | ~3.1k | Automated safety check: Pass | Apache-2.0 | |
| Version Bumpergodatadriven/whirl | 205 | — | ~1.2k | Automated safety check: Pass | Apache-2.0 |
Similar skills
Local Environment
polarsource/polar
Local development environment management for Polar using Docker
- Official
Tao Analyze Gaps Visual Changenet
NVIDIA/skills
Performs gap analysis on NVIDIA TAO VCN Classify (Visual Component Net) experiments by invoking the pinned TAO data-services container directly via docker run … gapanalysis vcnaoi … — picks the…
Time Series Analytics User
open-edge-platform/edge-ai-libraries
Build a new time-series analytics use case on top of the deployed Time Series Analytics microservice — bring it up with Docker Compose (from a repo clone, or by fetching the compose files from…
Version Bumper
godatadriven/whirl
Bump the Airflow or Python version across all project files.
Deploying Go SDK Bundles
astronomer/agents
Builds, packs, and deploys compiled Airflow Go SDK bundles so the ExecutableCoordinator can run them.
More from fcakyon/claude-codex-settings
All 44 skills in this repoSlides
fcakyon/claude-codex-settings
Create and edit presentation slide decks (.pptx) with PptxGenJS, bundled layout helpers, and render/validation utilities.
Dokploy Deploy
fcakyon/claude-codex-settings
This skill should be used when user asks to "deploy with Dokploy", "use Dokploy Cloud", "manage self-hosted Dokploy", "deploy Docker Compose on Dokploy", "manage Dokploy databases", "configure…
Openobserve API
fcakyon/claude-codex-settings
This skill should be used when user asks to "query OpenObserve", "create OpenObserve dashboard", "edit OpenObserve panel", "fetch OpenObserve logs", "run OpenObserve search", "list OpenObserve…
Openship Config
fcakyon/claude-codex-settings
This skill should be used when the user asks to "create openship.json", "configure an OpenShip deployment", "make a repo deployable on OpenShip", or fix "openship config validate" errors.
Python Guidelines
fcakyon/claude-codex-settings
This skill should be used when writing, reviewing, or refactoring Python code.
Hetzner Deploy
fcakyon/claude-codex-settings
This skill should be used when user asks to "deploy to Hetzner", "create Hetzner server", "manage Hetzner Cloud", "hcloud CLI", or works with Hetzner Cloud infrastructure including servers…
Related
Works with
Categories
Questions about Polar Local Environment
What does Polar Local Environment do?
This skill should be used when setting up or managing Polar local development environment with Docker. Polar Local Environment is an agent skill from fcakyon/claude-codex-settings. This skill should be used when setting up or managing Polar local development environment with Docker.
When should I use Polar Local Environment?
Polar Local Environment fits situations like: tasks that involve DataFrames; tasks that involve Containers.
How do I install Polar Local Environment in Claude Code?
Run `npx skills add fcakyon/claude-codex-settings --skill polar-local-environment -a claude-code`. Or copy the skill folder (plugins/polar-skills/skills/polar-local-environment in fcakyon/claude-codex-settings) into .claude/skills/polar-local-environment in your project. Claude Code loads it when a task matches its description.
How do I install Polar Local Environment in Codex?
Run `npx skills add fcakyon/claude-codex-settings --skill polar-local-environment -a codex`. Or copy the skill folder (plugins/polar-skills/skills/polar-local-environment in fcakyon/claude-codex-settings) into .agents/skills/polar-local-environment in your project. Codex loads it when a task matches its description.
Can I use Polar Local Environment in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add fcakyon/claude-codex-settings --skill polar-local-environment -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/polar-local-environment, .gemini/skills/polar-local-environment, .github/skills/polar-local-environment and .opencode/skills/polar-local-environment in your project.
What does Polar Local Environment need to run?
Going by SKILL.md and its folder, Polar Local Environment needs the command-line tools its instructions call (docker). Our summary lists: Docker.
Does Polar Local Environment access the network?
SKILL.md contains no URLs. Its commands use docker, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Polar Local Environment safe to install?
Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.
What licence does Polar Local Environment use?
Polar Local Environment is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Polar Local Environment use?
About 1.4k tokens (SKILL.md is roughly 5.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Polar Local Environment?
Skills that share tags, products or a category with Polar Local Environment: Verifier Web (polarsource/polar, 10k stars), Local Environment (polarsource/polar, 10k stars), Tao Analyze Gaps Visual Changenet (NVIDIA/skills, 3.5k stars) and Time Series Analytics User (open-edge-platform/edge-ai-libraries, 169 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Polar Local Environment?
fcakyon (a GitHub user) maintains it in fcakyon/claude-codex-settings, which has 1,171 GitHub stars. The repository holds 44 skills in this directory. The repository was last updated on October 8, 2026.
Source: fcakyon/claude-codex-settings on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.