Agent skill

Local Build and Run

by pilinux in pilinux/gorest

Builds and runs a Go project locally to reproduce compile or runtime problems safely, using test environment variables and mocks instead of production credentials.

MITAuto-check passedDevelopment

Install Local Build and Run

skills CLI
$ npx skills add pilinux/gorest --skill build-run -a claude-code

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

GitHub CLI
$ gh skill install pilinux/gorest build-run --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/pilinux/gorest.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/build-run .claude/skills/build-run && 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
build-run
GitHub stars
506
Token cost
~362 tokens
SKILL.md length
160 words
Files
1
Skills in repo
20
Repo updated
First seen
Licence
MIT

At a glance

Builds and runs a Go project locally to reproduce compile or runtime problems safely, using test environment variables and mocks instead of production credentials.

  • Checking that a Go project still compiles
  • SKILL.md covers When to Use, Rules, Commands and Output, plus 3 more sections
  • Calls go
  • Reproducing a failing integration test locally

What it does

The skill is a short procedure for confirming that a Go project compiles, reproducing a runtime issue or validating environment-dependent changes without touching production. It forbids production credentials and external services unless you supply safe mocks or stubs, and it loads local settings with source setTestEnv.sh. The listed commands are go build, go fmt, go vet, go mod tidy, a single go test run for a named test, and starting the example app with go run.

The agent reports a result of success or failure, the first relevant error or stack lines, a minimal reproduction of one to three commands and suggested next steps, such as which logs to check or which mocks to add. It points to AGENTS.md and setTestEnv.sh for details and names the related skills test-runner, ci-orchestrator and fix-suggester.

When your agent uses it

  • Checking that a Go project still compiles
  • Reproducing a failing integration test locally
  • Validating a change that depends on environment settings

Example prompts

  • “Does the project compile? Run the build and report the first error.”
  • “Reproduce the failing integration test TestLogin and show me the first failing lines.”
  • “Start the example app with the test environment and tell me if it boots.”

Requirements

  • The Go toolchain
  • The project's setTestEnv.sh script for local test settings

What it can do on your machine

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

    • go

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

  • Network

    No URLs in SKILL.md.

    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 Build and Run loads about 362 tokens when it runs. Until then it costs about 28 tokens; SKILL.md has 160 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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 pilinux/gorest at commit 38aab64, republished under its MIT licence (© pilinux). 160 words, ~362 tokens.

Download SKILL.mdSave it as .claude/skills/build-run/SKILL.md (or your agent's skills folder).
name
build-run
description
Build and run the project locally to reproduce compile/runtime issues in a safe, non-production way.
license
MIT
metadata.mode
verify
metadata.purpose
build-run

Build and Run

When to Use

  • Confirm the codebase compiles, reproduce a runtime issue locally, or validate environment-dependent changes.

Rules

  • Do not use production credentials or external services unless the user provides safe mocks/stubs.
  • Use source setTestEnv.sh for local env needed by tests or the app.
  • Prefer reproducible, minimal commands and capture key output lines.

Commands

  • Compile: go build -v ./...
  • Format: go fmt ./...
  • Vet: go vet -v ./...
  • Tidy deps: go mod tidy
  • Run tests that reproduce an issue: source setTestEnv.sh && go test -run <TestName> ./pkg/path
  • Start example app: cd example2/cmd/app && go run main.go (use with test env)

Output

  • Result: success or failure.
  • Key logs: first relevant error or stack lines.
  • Minimal repro: 1-3 commands.
  • Next steps: which logs/files to inspect or which mocks to add.

Examples

  • "Does the project compile?" - run go build -v ./... and report.
  • "Reproduce failing integration test X" - provide commands and first failing lines.
  • test-runner, ci-orchestrator, fix-suggester

References

  • AGENTS.md (build and run commands), setTestEnv.sh, llms.txt

© pilinux, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/build-run of pilinux/gorest.

Open the folder on GitHubat commit 38aab64

Compare with similar skills

Local Build and Run 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 Build and Run compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Local Build and Run this skillpilinux/gorest506—~362Automated safety check: PassMIT
AO Desktop App LauncherOrchestratorInc/agent-orchestrator13k—~2.4kAutomated safety check: PassApache-2.0
Golang Troubleshootingsamber/cc-skills-golang3.4k—~3.3kAutomated safety check: PassMIT
Golang Samber Oopscontext-labs/whip1.1k1 repos~2.6kAutomated safety check: PassMIT
Golang Troubleshootingcontext-labs/whip1.1k—~3.2kAutomated safety check: PassMIT
Golang PerformanceMadAppGang/claude-code285—~5kAutomated safety check: PassMIT

Similar skills

  • AO Desktop App Launcher

    OrchestratorInc/agent-orchestrator

    Launches, restarts and troubleshoots the real AO Electron desktop app from a checkout, with isolated or real local data and checks for stale processes.

    13k GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Golang Troubleshooting

    samber/cc-skills-golang

    Troubleshoot Golang programs systematically - find and fix the root cause.

    3.4k GitHub stars~3.3k tokensUpdated 9 days ago
    DevelopmentAuto-check passed
  • Golang Samber Oops

    context-labs/whip

    Structured error handling in Golang with samber/oops — error builders, stack traces, codes, context, wrapping, attributes, user-facing vs developer messages, panic recovery, logger integration.

    1.1k GitHub starsUsed in 1 repo~2.6k tokens
    DevelopmentAuto-check passed
  • Golang Troubleshooting

    context-labs/whip

    Troubleshoot Golang programs — find and fix the root cause. An agent skill from context-labs/whip.

    1.1k GitHub stars~3.2k tokensUpdated 5 days ago
    DevelopmentAuto-check passed
  • Golang Performance

    MadAppGang/claude-code

    A skill your agent uses when profiling Go applications (pprof), running benchmarks, optimizing memory/CPU usage, or debugging performance bottlenecks in production Go code.

    285 GitHub stars~5k tokensUpdated 6 mo ago
    DevelopmentAuto-check passed
  • Local Dev

    SmilyOrg/photofield

    Run, test, and debug the photofield server locally. An agent skill from SmilyOrg/photofield.

    608 GitHub stars~2.4k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed

More from pilinux/gorest

All 20 skills in this repo
  • Config Loader Helper

    pilinux/gorest

    Diagnoses configuration failures in the gorest project by listing the required environment variables grouped by feature and giving minimal commands for a safe local test setup.

    506 GitHub stars~441 tokensUpdated 14 days ago
    Auto-check passed
  • Enumerates Go declarations and signatures from the syntax tree, then proposes small, mechanically safe refactors with file and line citations.

    506 GitHub stars~414 tokensUpdated 14 days ago
    Auto-check passed
  • Code Navigation

    pilinux/gorest

    Rapid, focused navigation to locate definitions/usages and map the impact of proposed changes.

    506 GitHub stars~354 tokensUpdated 14 days ago
    Auto-check passed
  • Cited Code Explainer

    pilinux/gorest

    Explains how a module behaves in a few short, read-only sections, with a path-and-line citation behind every non-trivial claim.

    506 GitHub stars~244 tokensUpdated 14 days ago
    Auto-check passed
  • Cited File Reader

    pilinux/gorest

    Reads only the lines needed from a source file and answers with a short summary and path:line citations, without changing anything.

    506 GitHub stars~250 tokensUpdated 14 days ago
    Auto-check passed
  • Fix Suggester

    pilinux/gorest

    Diagnose failures and propose minimal, test-backed fixes with verification and rollback instructions.

    506 GitHub stars~251 tokensUpdated 14 days ago
    Auto-check passed

Works with

Categories

Questions about Local Build and Run

What does Local Build and Run do?

Builds and runs a Go project locally to reproduce compile or runtime problems safely, using test environment variables and mocks instead of production credentials. The skill is a short procedure for confirming that a Go project compiles, reproducing a runtime issue or validating environment-dependent changes without touching production.sh.

When should I use Local Build and Run?

Local Build and Run fits situations like: checking that a Go project still compiles; reproducing a failing integration test locally; validating a change that depends on environment settings.

How do I install Local Build and Run in Claude Code?

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

How do I install Local Build and Run in Codex?

Run `npx skills add pilinux/gorest --skill build-run -a codex`. Or copy the skill folder (.agents/skills/build-run in pilinux/gorest) into .agents/skills/build-run in your project. Codex loads it when a task matches its description.

Can I use Local Build and Run 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 pilinux/gorest --skill build-run -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/build-run, .gemini/skills/build-run, .github/skills/build-run and .opencode/skills/build-run in your project.

What does Local Build and Run need to run?

Going by SKILL.md and its folder, Local Build and Run needs the command-line tools its instructions call (go). Our summary lists: The Go toolchain; The project's setTestEnv.sh script for local test settings.

Does Local Build and Run access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Local Build and Run safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Local Build and Run use?

Local Build and Run 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 Local Build and Run use?

About 362 tokens (SKILL.md is roughly 1.4k 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 Build and Run?

Skills that share tags, products or a category with Local Build and Run: AO Desktop App Launcher (OrchestratorInc/agent-orchestrator, 13k stars), Golang Troubleshooting (samber/cc-skills-golang, 3.4k stars), Golang Samber Oops (context-labs/whip, 1.1k stars) and Golang Troubleshooting (context-labs/whip, 1.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Local Build and Run?

pilinux (a GitHub user) maintains it in pilinux/gorest, which has 506 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on September 25, 2026.

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