Agent skill

Local Stack

by theopenco in theopenco/llmgateway

Run an isolated per-worktree LLM Gateway stack — own Postgres, Redis, storage Redis, and app ports — and tear it down safely.

Custom licenceAuto-check: notesDatabases

Install Local Stack

skills CLI
$ npx skills add theopenco/llmgateway --skill local-stack -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install theopenco/llmgateway local-stack --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/theopenco/llmgateway.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/local-stack .claude/skills/local-stack && rm -rf skills-src

Use ~/.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/

Facts

Skill name
local-stack
GitHub stars
1.7k
Token cost
~1.6k tokens
SKILL.md length
528 words
Files
1
Skills in repo
19
Repo updated
First seen
Licence
Custom licence

At a glance

Run an isolated per-worktree LLM Gateway stack — own Postgres, Redis, storage Redis, and app ports — and tear it down safely.

  • Tasks that involve Git worktrees
  • SKILL.md covers Pick a slot, Configure .envrc, Start and How the wiring works, plus 1 more section
  • Calls pnpm, docker and node
  • Tasks that involve Containers

What it does

Local Stack is an agent skill from theopenco/llmgateway. Run an isolated per-worktree LLM Gateway stack — own Postgres, Redis, storage Redis, and app ports — and tear it down safely. Use before running unit tests, starting dev servers, reseeding, or running docker compose in a worktree; when choosing STACKSUFFIX, port slots, or .envrc; when a port is taken, a local server behaves like another worktree's code, or a relocated frontend fails CORS or login.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Databases, covering Git worktrees, Containers and Model routing and gateways. It works with Redis, Docker and PostgreSQL. The repository describes itself as: Route, manage, and analyze your LLM requests across multiple providers with a unified API interface.

When your agent uses it

  • Tasks that involve Git worktrees
  • Tasks that involve Containers
  • Tasks that involve Model routing and gateways

Example prompts

  • “/local-stack”

Requirements

  • Docker

What it can do on your machine

Read from SKILL.md and the folder at commit 414b1b9. 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:

    • pnpm
    • docker
    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pnpm and 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

Local Stack loads about 1.6k tokens when it runs. Until then it costs about 103 tokens; SKILL.md has 528 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~103
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

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:99
    de --enable-source-maps --env-file=../../.env dist/serve.js )   # build first: turbo run build --filter=api

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 528 words (~1,631 tokens).

“Several worktrees share this machine, and only one stack can own the default ports (:4001, :5432, :6379). Before assuming local edits are live, confirm which tree serves a port: lsof -a -p -d cwd -Fn. Give each worktree its own…”

— opening of SKILL.md by theopenco, Custom licence
name
local-stack

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/local-stack of theopenco/llmgateway.

Open the folder on GitHubat commit 414b1b9

Compare with similar skills

Local Stack 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.

Local Stack compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Local Stack this skilltheopenco/llmgateway1.7k—~1.6kAutomated safety check: NotesCustom licence
Manor Dev Stack Run Verifymanor-os/manor-ai162—~607Automated safety check: NotesCustom licence
Cloudrun DevelopmentTencentCloudBase/CloudBase-AI-Toolkit1.1k1 repos~7.2kAutomated safety check: PassMIT
Use Sealoshashgraph-online/awesome-codex-plugins1.2k—~2.2kAutomated safety check: PassApache-2.0
Create Environmentgodatadriven/whirl205—~1.9kAutomated safety check: PassApache-2.0
E2Eopenathleteorg/openathlete100—~675Automated safety check: PassAGPL-3.0

Similar skills

  • A skill your agent uses when starting, verifying, debugging, or repairing the local Manor self-hosted dev stack, Docker Compose services, seeded demo login, API/web/worker health…

    162 GitHub stars~607 tokensUpdated 1 mo ago
    DatabasesAuto-check: notes
  • Cloudrun Development

    TencentCloudBase/CloudBase-AI-Toolkit

    CloudBase Run backend development rules (Function mode/Container mode).

    1.1k GitHub starsUsed in 1 repo~7.2k tokens
    DatabasesAuto-check passed
  • Use Sealos

    hashgraph-online/awesome-codex-plugins

    Deploy and operate apps on Sealos Cloud: sign in to a Sealos account, deploy any project or self-hosted app (from the template store, an official Docker image, or project source code), provision…

    1.2k GitHub stars~2.2k tokensUpdated today
    DatabasesAuto-check passed
  • Create Environment

    godatadriven/whirl

    Create a new Whirl environment in the envs/ directory. An agent skill from godatadriven/whirl.

    205 GitHub stars~1.9k tokensUpdated 6 days ago
    Backend & APIsAuto-check passed
  • E2E

    openathleteorg/openathlete

    Run, debug or extend the OpenAthlete Playwright end-to-end tests, which exercise the production Docker images (API, worker, web, PostgreSQL, Redis) through the API and a real browser on desktop and…

    100 GitHub stars~675 tokensUpdated today
    Testing & QAAuto-check passed
  • Code Patterns

    Aedelon/claude-code-blueprint

    Reference patterns for REST APIs, pytest/vitest testing, Docker multi-stage builds, GitHub Actions CI/CD, PostgreSQL, TypeScript generics, Python async, and React Server Components.

    120 GitHub stars~1.2k tokensUpdated 7 mo ago
    DevOps & CloudAuto-check passed

More from theopenco/llmgateway

All 19 skills in this repo
  • Blog

    theopenco/llmgateway

    Write and validate an LLM Gateway marketing blog post in the repository's current house style, including structured frontmatter and a gpt-image-2 OpenGraph image.

    1.7k GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Model Benchmarks

    theopenco/llmgateway

    Run and report repository model or provider-mapping benchmarks.

    1.7k GitHub stars~1.1k tokensUpdated today
    Auto-check: notes
  • Skill Authoring

    theopenco/llmgateway

    Create, update, and audit repository-local agent skills against the current LLM Gateway codebase.

    1.7k GitHub stars~662 tokensUpdated today
    Auto-check passed
  • Security Audit

    theopenco/llmgateway

    Security best practices, vulnerability review, and full security audits for LLM Gateway.

    1.7k GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Changelog

    theopenco/llmgateway

    Write a new LLM Gateway changelog entry. An agent skill from theopenco/llmgateway.

    1.7k GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Knowledge Base

    theopenco/llmgateway

    Write a new LLM Gateway docs Knowledge base page under apps/docs/content/(product)/learn with light and dark dashboard screenshots.

    1.7k GitHub stars~1.7k tokensUpdated today
    Auto-check passed

Questions about Local Stack

What does Local Stack do?

Run an isolated per-worktree LLM Gateway stack — own Postgres, Redis, storage Redis, and app ports — and tear it down safely. Local Stack is an agent skill from theopenco/llmgateway. Run an isolated per-worktree LLM Gateway stack — own Postgres, Redis, storage Redis, and app ports — and tear it down safely.

When should I use Local Stack?

Local Stack fits situations like: tasks that involve Git worktrees; tasks that involve Containers; tasks that involve Model routing and gateways.

How do I install Local Stack in Claude Code?

Run `npx skills add theopenco/llmgateway --skill local-stack -a claude-code`. Or copy the skill folder (.agents/skills/local-stack in theopenco/llmgateway) into .claude/skills/local-stack in your project. Claude Code loads it when a task matches its description.

How do I install Local Stack in Codex?

Run `npx skills add theopenco/llmgateway --skill local-stack -a codex`. Or copy the skill folder (.agents/skills/local-stack in theopenco/llmgateway) into .agents/skills/local-stack in your project. Codex loads it when a task matches its description.

Can I use Local Stack 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 theopenco/llmgateway --skill local-stack -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/local-stack, .gemini/skills/local-stack, .github/skills/local-stack and .opencode/skills/local-stack in your project.

What does Local Stack need to run?

Going by SKILL.md and its folder, Local Stack needs the command-line tools its instructions call (pnpm, docker and node). Our summary lists: Docker.

Does Local Stack 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 Local Stack 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 Local Stack use?

Local Stack has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Local Stack use?

About 1.6k tokens (SKILL.md is roughly 6.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 Local Stack?

Skills that share tags, products or a category with Local Stack: Manor Dev Stack Run Verify (manor-os/manor-ai, 162 stars), Cloudrun Development (TencentCloudBase/CloudBase-AI-Toolkit, 1.1k stars), Use Sealos (hashgraph-online/awesome-codex-plugins, 1.2k stars) and Create Environment (godatadriven/whirl, 205 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Local Stack?

theopenco (a GitHub organization) maintains it in theopenco/llmgateway, which has 1,675 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 7, 2026.

Source: theopenco/llmgateway on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.