Agent skill

Test Runner

by pilinux in pilinux/gorest

Run and triage Go tests with correct environment handling; produce compact, actionable failure summaries.

MITAuto-check passedDatabases

Install Test Runner

skills CLI
$ npx skills add pilinux/gorest --skill test-runner -a claude-code

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

GitHub CLI
$ gh skill install pilinux/gorest test-runner --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/test-runner .claude/skills/test-runner && 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
test-runner
GitHub stars
506
Token cost
~263 tokens
SKILL.md length
104 words
Files
1
Skills in repo
20
Repo updated
First seen
Licence
MIT

At a glance

Run and triage Go tests with correct environment handling; produce compact, actionable failure summaries.

  • Databases work in your project
  • SKILL.md covers When to Use, Rules, Commands and Output, plus 1 more section
  • Calls go

What it does

Test Runner is an agent skill from pilinux/gorest. Run and triage Go tests with correct environment handling; produce compact, actionable failure summaries.

Its SKILL.md is about 260 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. The repository describes itself as: Go RESTful API starter kit with Gin, JWT, GORM (MySQL, PostgreSQL, SQLite), Redis, Mongo, 2FA, email verification, password recovery. The licence is MIT.

When your agent uses it

  • Databases work in your project

Example prompts

  • “/test-runner”

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

Test Runner loads about 263 tokens when it runs. Until then it costs about 29 tokens; SKILL.md has 104 words of instructions outside code blocks.

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

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). 104 words, ~263 tokens.

Download SKILL.mdSave it as .claude/skills/test-runner/SKILL.md (or your agent's skills folder).
name
test-runner
description
Run and triage Go tests with correct environment handling; produce compact, actionable failure summaries.
license
MIT
metadata.mode
verify
metadata.purpose
test

Test Runner

When to Use

  • Validate changes with unit/integration tests or triage failing test runs.

Rules

  • Use source setTestEnv.sh when environment variables are required.
  • Focus on the first actionable failure line and include package + test name.
  • Prefer targeted test runs (-run) over full-suite when iterating.

Commands

  • Full suite (with test env): source setTestEnv.sh && go test -v -cover ./...
  • Single package: source setTestEnv.sh && go test -v -cover ./lib/...
  • Single test: source setTestEnv.sh && go test -v -run TestHashPass ./lib/...

Output

  • Result: pass or fail.
  • Failures: package, test name, first actionable error lines.
  • Next: 1-3 focused suggestions (narrow test, inspect file, add mock).
  • logs-repro-harness, linter-runner, db-infra-mocks

© 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/test-runner of pilinux/gorest.

Open the folder on GitHubat commit 38aab64

Compare with similar skills

Test Runner 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.

Test Runner compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Test Runner this skillpilinux/gorest506—~263Automated safety check: PassMIT
Mail Timeveliovgroup/mail-time143—~1kAutomated safety check: PassBSD-3-Clause
Tgf Server Devthkhxm/tgf128—~1.3kAutomated safety check: NotesMIT
Azure Storagemicrosoft/GitHub-Copilot-for-Azure2552 repos~1.3kAutomated safety check: PassMIT
Configure REST Cachestrapi-community/plugin-rest-cache155—~1.1kAutomated safety check: PassMIT
ArchitectYougLin-dev/Aha-Loop181—~2.2kAutomated safety check: PassMIT

Similar skills

  • Mail Time

    veliovgroup/mail-time

    A skill your agent uses when building, wiring, reviewing, or debugging MailTime and ostrio:mailer email queues for horizontally scaled Node.js, Bun, or Meteor apps.

    143 GitHub stars~1k tokensUpdated today
    DatabasesAuto-check passed
  • Tgf Server Dev

    thkhxm/tgf

    基于 tgf v2(github.com/thkhxm/tgf/v2)用确定性的 tgfctl 工作流创建、验证和维护 Go 游戏服务器项目。

    128 GitHub stars~1.3k tokensUpdated 2 mo ago
    DatabasesAuto-check: notes
  • Azure Storage

    microsoft/GitHub-Copilot-for-Azure

    Official

    Azure Storage Services including Blob Storage, File Shares, Queue Storage, Table Storage, and Data Lake.

    255 GitHub starsUsed in 2 repos~1.3k tokens
    DatabasesAuto-check passed
  • Configure REST Cache

    strapi-community/plugin-rest-cache

    Choose and write a Strapi REST Cache configuration for a specific use case.

    155 GitHub stars~1.1k tokensUpdated 10 days ago
    DatabasesAuto-check passed
  • Architect

    YougLin-dev/Aha-Loop

    Designs system architecture and selects technology stack based on vision analysis.

    181 GitHub stars~2.2k tokensUpdated 8 mo ago
    DatabasesAuto-check passed
  • Pocketbase

    pockethost/pockethost

    Models PocketBase backends: collections, relations, auth, API rules, migrations, and architecture.

    1.4k GitHub stars~1k tokensUpdated 10 days ago
    DatabasesAuto-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 12 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 12 days ago
    Auto-check passed
  • Local Build and Run

    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.

    506 GitHub stars~362 tokensUpdated 12 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 12 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 12 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 12 days ago
    Auto-check passed

Questions about Test Runner

What does Test Runner do?

Run and triage Go tests with correct environment handling; produce compact, actionable failure summaries. Test Runner is an agent skill from pilinux/gorest. Run and triage Go tests with correct environment handling; produce compact, actionable failure summaries.

When should I use Test Runner?

Test Runner fits situations like: databases work in your project.

How do I install Test Runner in Claude Code?

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

How do I install Test Runner in Codex?

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

Can I use Test Runner 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 test-runner -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/test-runner, .gemini/skills/test-runner, .github/skills/test-runner and .opencode/skills/test-runner in your project.

What does Test Runner need to run?

Going by SKILL.md and its folder, Test Runner needs the command-line tools its instructions call (go).

Does Test Runner 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 Test Runner 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 Test Runner use?

Test Runner 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 Test Runner use?

About 263 tokens (SKILL.md is roughly 1.1k 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 Test Runner?

Skills that share tags, products or a category with Test Runner: Mail Time (veliovgroup/mail-time, 143 stars), Tgf Server Dev (thkhxm/tgf, 128 stars), Azure Storage (microsoft/GitHub-Copilot-for-Azure, 255 stars) and Configure REST Cache (strapi-community/plugin-rest-cache, 155 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Test Runner?

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.