What is run-gopherstack?

A development skill for building and checking Gopherstack, a local Go program that imitates many AWS services through one HTTP server. It can start the server, call it with AWS tools or HTTP requests, capture a dashboard screenshot, and run tests.

Use it to build Gopherstack, run its local server, exercise services, inspect the dashboard, and run unit or integration tests.

It provides a defined procedure for manually checking this AWS emulator instead of relying on ad-hoc commands.

How BlackbirdWorks/gopherstack configures Claude Code

Reuse

Borrowing it

Nothing to install: this file belongs to BlackbirdWorks/gopherstack. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/BlackbirdWorks/gopherstack/main/.claude/skills/run-gopherstack/SKILL.md

Clone the repo

git clone --depth 1 https://github.com/BlackbirdWorks/gopherstack

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/blackbirdworks/gopherstack/run-gopherstack/github.svg)](https://agentmods.dev/skills/blackbirdworks/gopherstack/run-gopherstack)

Your own site

<a href="https://agentmods.dev/skills/blackbirdworks/gopherstack/run-gopherstack"><img src="https://agentmods.dev/badge/skills/blackbirdworks/gopherstack/run-gopherstack/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/blackbirdworks/gopherstack/run-gopherstack"><img src="https://agentmods.dev/badge/skills/blackbirdworks/gopherstack/run-gopherstack.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 75 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 2,032 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00075	$0.02032
Opus 5.5	$0.00030	$0.00813
Sonnet 5.5	$0.00015	$0.00406
Haiku 4.5	$0.00007	$0.00203

Measured yesterday against content hash 0e37598145fd, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

run-gopherstack scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

The scan reads SKILL.md. This mod also ships 1 executable file (driver.sh), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

the AWS CLI, raw `curl`, and headless Chrome.

.claude/skills/run-gopherstack/SKILL.md · 176 lines

How it starts

The opening of the file, as written. The whole thing — 176 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Run Gopherstack

Gopherstack is a single Go binary that emulates ~161 AWS services over one HTTP port (default 8000), plus a SvelteKit dashboard SPA embedded in the binary at /dashboard/. It is driven programmatically by .claude/skills/run-gopherstack/driver.sh — a wrapper around the server process, the AWS CLI, raw curl, and headless Chrome.

All paths below are relative to the repo root. Run every command from there.

Prerequisites

Already present in this container; no apt-get was needed:

Go 1.26.5 (go version)
aws CLI (v1 / botocore 1.43), curl, jq
google-chrome (dashboard screenshots)
Docker daemon (integration tests only — docker info must succeed)
Node 24 + npm — only needed if you change ui/

Build

go build -o bin/gopherstack .

~16 s warm. That is enough: the dashboard SPA is committed under dashboard/static/spa and //go:embed-ed by dashboard/ui.go, so you do not need npm to get a working dashboard. task build re-runs npm --prefix ui ci + a Vite build first — use it only when you edited ui/.

For integration tests, build the static Linux binary the test container copies:

task build-linux

Run (agent path)

.claude/skills/run-gopherstack/driver.sh up          # start on :8123, block until healthy
.claude/skills/run-gopherstack/driver.sh up 8126 --demo   # any serve flags pass through
.claude/skills/run-gopherstack/driver.sh health     # GET /_gopherstack/health
.claude/skills/run-gopherstack/driver.sh logs 40
.claude/skills/run-gopherstack/driver.sh down

up prints e.g. up on http://localhost:8123 (161 services). State (pid, port, log, data dir) lives in $TMPDIR/gopherstack-driver, so aws/api/shot in later shells find the running server.

Call it with the AWS CLI

.claude/skills/run-gopherstack/driver.sh aws sts get-caller-identity
.claude/skills/run-gopherstack/driver.sh aws s3 mb s3://my-bucket
.claude/skills/run-gopherstack/driver.sh aws dynamodb list-tables
.claude/skills/run-gopherstack/driver.sh aws sqs create-queue --queue-name q

Read the full file on GitHub · 176 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

driver.sh 5.3 KB runs code

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

yesterday First seen · 176 lines · 75 tokens per session scan A 0e37598145fd

Subscribe to this mod's changes

run-gopherstack is a skill published in the GitHub repository BlackbirdWorks/gopherstack (17 stars, last pushed yesterday), licensed MIT. It adds 75 tokens to every session and 2,032 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-11-07.

Backend and APIs Cloud DevOps and cloud aws localstack terraform

run-gopherstack next to 6 skills from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
run-gopherstackBlackbirdWorks/gopherstack	Skill	17	yesterday	MIT	A	75	Claude Code
amplify-workflowawslabs/agent-plugins	Skill	937	2d ago	Apache-2.0	A	214	Claude Code
aws-lambda-durable-functionsawslabs/agent-plugins	Skill	937	2d ago	Apache-2.0	A	109	Claude Code
snsitsmostafa/aws-agent-skills	Skill	1.2k	5d ago	MIT	A	32	Claude Code
aws-lambdaawslabs/agent-plugins	Skill	937	2d ago	Apache-2.0	A	74	Claude Code
huawei-cloud-apig-instance-managementhuaweicloud/huaweicloud-devkit	Skill	70	yesterday	Apache-2.0	A	206	Claude Code
cloud-native-aws-serverlessj4flmao/agent-skills	Skill	39	4d ago	MIT	A	133	Claude Code, Codex

gopherstack: Skill for Claude Code