Agent skill

Go CLI Command Design

by hashgraph-online in hashgraph-online/awesome-codex-plugins

Design and review predictable Go command-line interfaces with canonical names and flags; explicit inputs and precedence; human, plain, and structured output; safe prompting; stdout and stderr…

MITAuto-check passedAI & LLM Engineering

Install Go CLI Command Design

skills CLI
$ npx skills add hashgraph-online/awesome-codex-plugins --skill go-cli-command-design -a claude-code

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

GitHub CLI
$ gh skill install hashgraph-online/awesome-codex-plugins go-cli-command-design --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/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/LVTD-LLC/skills/skills/go-cli-command-design .claude/skills/go-cli-command-design && 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
go-cli-command-design
GitHub stars
1.2k
Token cost
~864 tokens
SKILL.md length
325 words
Files
8 (incl. references)
Skills in repo
736
Repo updated
First seen
Licence
MIT

At a glance

Design and review predictable Go command-line interfaces with canonical names and flags; explicit inputs and precedence; human, plain, and structured output; safe prompting; stdout and stderr…

  • Works in 8 steps: State the command purpose, invocation… → Assign each input to a flag, operand,… → Define precedence, validation,… → …
  • Creating a Go CLI
  • SKILL.md covers Core Workflow, Read Next, Guardrails and Source Notes
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Go CLI Command Design is an agent skill from hashgraph-online/awesome-codex-plugins. Design and review predictable Go command-line interfaces with canonical names and flags; explicit inputs and precedence; human, plain, and structured output; safe prompting; stdout and stderr contracts; help; errors; exit codes; cancellation; dependency injection; and platform behavior. Use when creating a Go CLI, changing its public command contract, making command code testable, or reviewing compatibility for people, scripts, AI agents, and CI.

Its SKILL.md is about 860 tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including reference files (for example `agents/openai.yaml`, `guidelines.md` and `references/command-interface/checklist.md`). Compatibility notes: Codex, Claude Code, and other Agent Skills-compatible clients.

It sits in AI & LLM Engineering, covering Structured output and tool calling and Design patterns. The repository describes itself as: A curated list of awesome OpenAI Codex / ChatGPT plugins, skills, and resources. The 1 Codex Marketplace. See live plugins at: https://hol.org/plugins/best-codex-plugins. The licence is MIT.

When your agent uses it

  • Creating a Go CLI
  • Changing its public command contract
  • Making command code testable
  • Reviewing compatibility for people

Example prompts

  • “/go-cli-command-design”

Requirements

  • Compatibility (from SKILL.md): Codex, Claude Code, and other Agent Skills-compatible clients.

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. State the command purpose, invocation syntax, callers, and compatibility promises.
  2. Assign each input to a flag, operand, stdin, environment, or config source.
  3. Define precedence, validation, conflicts, defaults, and blocking behavior.
  4. Reserve stdout for results and requested help; use stderr for diagnostics,
  5. Return errors from command logic and map exit codes at the process boundary.
  6. Inject streams, configuration, and effects behind a small testable runner.
  7. Verify help, invalid usage, operational failures, and supported target behavior.
  8. Verify noninteractive, color-disabled, canceled, and short-reading pipe behavior.

What it can do on your machine

Read from SKILL.md and the folder at commit 16b4156. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    Links to these hosts (documentation or services it may open):

    • pragprog.com
    • pkg.go.dev

    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.

  • Compatibility

    Codex, Claude Code, and other Agent Skills-compatible clients.

    From compatibility in the SKILL.md frontmatter.

Context cost

Go CLI Command Design loads about 864 tokens when it runs, and up to ~6k if it reads all its reference files. Until then it costs about 118 tokens; SKILL.md has 325 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~118
When it runs · the whole SKILL.md, loaded when a task matches
~864
With references · SKILL.md plus every file in references/, read only if the agent opens them
~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 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 hashgraph-online/awesome-codex-plugins at commit 16b4156, republished under its MIT licence (© hashgraph-online). 325 words, ~864 tokens.

Download SKILL.mdSave it as .claude/skills/go-cli-command-design/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
go-cli-command-design
description
Design and review predictable Go command-line interfaces with canonical names and flags; explicit inputs and precedence; human, plain, and structured output; safe prompting; stdout and stderr contracts; help; errors; exit codes; cancellation; dependency injection; and platform behavior. Use when creating a Go CLI, changing its public command contract, making command code testable, or reviewing compatibility for people, scripts, AI agents, and CI.
compatibility
Codex, Claude Code, and other Agent Skills-compatible clients.
license
MIT
metadata.version
0.4.0
metadata.displayName
Go CLI Command Design
metadata.category
Go
metadata.tags
go,golang,cli,command-design,flags,streams,portability

Go CLI Command Design

Design the command as a public interface before treating it as an implementation. Keep results pipeable, failures diagnosable, and process-global state at the edge.

Core Workflow

  1. State the command purpose, invocation syntax, callers, and compatibility promises.
  2. Assign each input to a flag, operand, stdin, environment, or config source.
  3. Define precedence, validation, conflicts, defaults, and blocking behavior.
  4. Reserve stdout for results and requested help; use stderr for diagnostics, invalid-usage help, and progress.
  5. Return errors from command logic and map exit codes at the process boundary.
  6. Inject streams, configuration, and effects behind a small testable runner.
  7. Verify help, invalid usage, operational failures, and supported target behavior.
  8. Verify noninteractive, color-disabled, canceled, and short-reading pipe behavior.
TaskLoad
Design or change a complete command contractguidelines.md, workflows/design-command-interface.md
Implement flags, streams, environment, or errorsreferences/command-interface/rules.md, references/command-interface/examples.md
Understand the design rationalereferences/command-interface/knowledge.md
Review an existing commandreferences/command-interface/checklist.md

Guardrails

  • Prefer a dedicated flag.FlagSet over package-global flags in reusable code.
  • Do not read stdin unless the documented invocation requires it.
  • Do not call os.Exit below the outer process boundary.
  • Treat structured output, exact text, and exit codes as APIs when automation relies on them.
  • Never prompt, animate, or emit ANSI sequences in structured or noninteractive mode.
  • Treat closed downstream pipes as normal pipeline termination when appropriate.
  • Cross-compilation does not replace target-level smoke testing.

Source Notes

Guidance is transformed and paraphrased from Ricardo Gerardi, Powerful Command-Line Applications in Go (Pragmatic Bookshelf, 2021), especially Chapters 1-2. Examples are original adaptations.

Modern interaction, cancellation, and output-mode guidance also incorporates transformed material from Marian Montagnino, Building Modern CLI Applications in Go (Packt, 2023), especially Chapters 1, 5, 8, and 10.

Book: https://pragprog.com/titles/rggo/powerful-command-line-applications-in-go/

Modern API details should be verified against https://pkg.go.dev/flag and the current Go documentation before implementation.

Parser grammar and validation guidance also incorporates transformed material from Inanc Gumus, Go by Example: Programmer's Guide to Idiomatic and Testable Programs (Manning, 2025), Chapter 4.

© hashgraph-online, 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 7 other files (references) in plugins/LVTD-LLC/skills/skills/go-cli-command-design of hashgraph-online/awesome-codex-plugins.

  • SKILL.md
  • agents/openai.yaml
  • guidelines.md
  • references/command-interface/checklist.md
  • references/command-interface/examples.md
  • references/command-interface/knowledge.md
  • references/command-interface/rules.md
  • workflows/design-command-interface.md

Open the folder on GitHubat commit 16b4156

Compare with similar skills

Go CLI Command Design 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.

Go CLI Command Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Go CLI Command Design this skillhashgraph-online/awesome-codex-plugins1.2k—~864Automated safety check: PassMIT
Pydantic AIdavila7/claude-code-templates32k4 repos~2.9kAutomated safety check: PassMIT
Pydanticaimagnus919/agent-skills111—~4kAutomated safety check: PassMIT
Planning With Filesjarrodwatts/claude-code-config1.1k5 repos~967Automated safety check: PassNone
Tool Use Data Synthesissunny-glow/Auto-BenchMax1.3k—~3.3kAutomated safety check: PassNone
Agent Harness ConstructionKartikLabhshetwar/mind-mentor1477 repos~500Automated safety check: PassApache-2.0

Similar skills

  • Pydantic AI

    davila7/claude-code-templates

    Build production-ready AI agents with PydanticAI — type-safe tool use, structured outputs, dependency injection, and multi-model support.

    32k GitHub starsUsed in 4 repos~2.9k tokens
    AI & LLM EngineeringAuto-check passed
  • Pydanticai

    magnus919/agent-skills

    Build type-safe AI agents and graph-based workflows with PydanticAI and PydanticGraph.

    111 GitHub stars~4k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Planning With Files

    jarrodwatts/claude-code-config

    Transforms workflow to use Manus-style persistent markdown files for planning, progress tracking, and knowledge storage.

    1.1k GitHub starsUsed in 5 repos~967 tokens
    AI & LLM EngineeringAuto-check passed
  • Tool Use Data Synthesis

    sunny-glow/Auto-BenchMax

    Synthesize training data for ANY tool-use / agentic benchmark, in ANY repo.

    1.3k GitHub stars~3.3k tokensUpdated 2 mo ago
    AI & LLM EngineeringAuto-check passed
  • Agent Harness Construction

    KartikLabhshetwar/mind-mentor

    Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates.

    147 GitHub starsUsed in 7 repos~500 tokens
    AI & LLM EngineeringAuto-check passed
  • Reference for designing and tuning production LLM prompts: few-shot examples, chain-of-thought, structured outputs, templates and system prompts.

    40k GitHub stars~1.3k tokensUpdated 2 days ago
    AI & LLM EngineeringAuto-check passed

More from hashgraph-online/awesome-codex-plugins

All 736 skills in this repo
  • Anime Reaction Gif

    hashgraph-online/awesome-codex-plugins

    Create original anime-style reaction stickers as looping GIFs and MP4 previews, using generated character pose sheets and timed key poses.

    1.2k GitHub stars~922 tokensUpdated today
    Auto-check passed
  • Calibredb

    hashgraph-online/awesome-codex-plugins

    Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs).

    1.2k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Rust API Test Harness

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when adding, changing, testing, or debugging Rust HTTP APIs and services, especially when Codex needs black-box integration tests, random-port app startup, real database test…

    1.2k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Art

    hashgraph-online/awesome-codex-plugins

    Make a studio's game look like something at build time — a cover from a real frame of the game (free), painted covers, backdrops, textures and character plates from image models through the…

    1.2k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Calle

    hashgraph-online/awesome-codex-plugins

    Use CALL-E from Codex through the calle CLI. An agent skill from hashgraph-online/awesome-codex-plugins.

    1.2k GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Game Balance Economy

    hashgraph-online/awesome-codex-plugins

    Balance game difficulty, resources, rewards, probability, progression, economies, and dominant strategies.

    1.2k GitHub stars~618 tokensUpdated today
    Auto-check passed

Questions about Go CLI Command Design

What does Go CLI Command Design do?

Design and review predictable Go command-line interfaces with canonical names and flags; explicit inputs and precedence; human, plain, and structured output; safe prompting; stdout and stderr…. Go CLI Command Design is an agent skill from hashgraph-online/awesome-codex-plugins. Design and review predictable Go command-line interfaces with canonical names and flags; explicit inputs and precedence; human, plain, and structured output; safe prompting; stdout and stderr contracts; help; errors; exit codes; cancellation; dependency injection; and platform behavior.

When should I use Go CLI Command Design?

Go CLI Command Design fits situations like: creating a Go CLI; changing its public command contract; making command code testable; reviewing compatibility for people.

How do I install Go CLI Command Design in Claude Code?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill go-cli-command-design -a claude-code`. Or copy the skill folder (plugins/LVTD-LLC/skills/skills/go-cli-command-design in hashgraph-online/awesome-codex-plugins) into .claude/skills/go-cli-command-design in your project. Claude Code loads it when a task matches its description.

How do I install Go CLI Command Design in Codex?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill go-cli-command-design -a codex`. Or copy the skill folder (plugins/LVTD-LLC/skills/skills/go-cli-command-design in hashgraph-online/awesome-codex-plugins) into .agents/skills/go-cli-command-design in your project. Codex loads it when a task matches its description.

Can I use Go CLI Command Design 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 hashgraph-online/awesome-codex-plugins --skill go-cli-command-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/go-cli-command-design, .gemini/skills/go-cli-command-design, .github/skills/go-cli-command-design and .opencode/skills/go-cli-command-design in your project.

What does Go CLI Command Design need to run?

SKILL.md names no scripts, command-line tools or credentials: Go CLI Command Design is instructions for the agent only. Compatibility (from SKILL.md): Codex, Claude Code, and other Agent Skills-compatible clients..

Does Go CLI Command Design access the network?

SKILL.md names 2 domains. As links in the text: pragprog.com and pkg.go.dev. This is read from the text; nothing was executed.

Is Go CLI Command Design 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 Go CLI Command Design use?

Go CLI Command Design 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 Go CLI Command Design use?

About 864 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.1k tokens, read only when the agent opens those files.

What are the alternatives to Go CLI Command Design?

Skills that share tags, products or a category with Go CLI Command Design: Pydantic AI (davila7/claude-code-templates, 32k stars), Pydanticai (magnus919/agent-skills, 111 stars), Planning With Files (jarrodwatts/claude-code-config, 1.1k stars) and Tool Use Data Synthesis (sunny-glow/Auto-BenchMax, 1.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Go CLI Command Design?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,232 GitHub stars. The repository holds 736 skills in this directory. The repository was last updated on October 6, 2026.

Source: hashgraph-online/awesome-codex-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.