go-skills

AI Agent Skills for writing idiomatic, production-quality Go code. 20 modular skills teach AI coding assistants Go best practices derived from:

• •Google Go Style Guide
• •Effective Go
• •Uber Go Style Guide
• •Go Wiki CodeReviewComments

Skills are tuned following agentskills.io best practices: content the agent already knows is omitted, procedural decision trees guide multi-step tasks, 48 reference files load on demand via progressive disclosure, 8 bundled scripts automate common checks, and 4 asset templates ensure consistent output.

Skills Included

Bundled Scripts

8 scripts automate common Go checks. All support --help, --json for structured output, and meaningful exit codes (0 = clean, 1 = issues found, 2 = error). Analysis scripts support --limit to cap output size, and destructive scripts require --force to overwrite existing files.

Quick Install

Using npx skills (Recommended)

The easiest way to install across any AI coding agent. Supports Cursor, Codex, OpenCode, Cline, GitHub Copilot, Windsurf, Roo Code, and 25+ more agents.

npx skills add cxuu/golang-skills --all

Claude Code

# Add the marketplace (one time)
/plugin marketplace add cxuu/golang-skills

# Install the skills
/plugin install golang-skills@cxuu-golang-skills

Cursor (Native Remote Rule)

1. Open Cursor Settings (Cmd+Shift+J on Mac, Ctrl+Shift+J on Windows/Linux)
2. Navigate to Rules → Add Rule → Remote Rule (Github)
3. Enter: https://github.com/cxuu/golang-skills

How It Works

These skills follow the Agent Skills open standard, which works across multiple AI coding tools. When you're writing Go code:

1. Automatic activation: The AI agent loads relevant skills based on context

(e.g., go-naming when you're writing a new function)

1. Procedural guidance: Decision trees and step-by-step procedures for

multi-step tasks like code review and error strategy selection

1. Progressive disclosure: Core rules load immediately; 48 reference files

load on demand when specific situations arise

1. Automation: 8 bundled scripts handle repetitive checks so the agent

focuses on higher-level guidance

1. Conditional cross-references: Skills link to each other with "when"

conditions to avoid unnecessary context loading

Project Structure

skills/
├── go-*/
│   ├── SKILL.md          # Core rules (< 225 lines each)
│   ├── references/       # Detailed guidance, loaded on demand
│   ├── scripts/          # Automation scripts (8 skills)
│   └── assets/           # Output templates (4 skills)
├── evals/
│   ├── evals.json        # 51 trigger evals + 15 quality evals
│   └── files/            # Sample Go files for quality evals
└── source/               # Original style guide sources

License

This project is licensed under the Apache License, Version 2.0. See the LICENSE file for details.