golang-agent-skills: Instructions file for Codex

AGENTS.md

This file provides guidance to AI coding agents (Claude Code, Cursor, Copilot, etc.) when working with code in this repository.

Repository Overview

A collection of skills for AI coding agents working with Go (Golang). Skills are packaged instructions and scripts that extend agent capabilities.

Project Structure

skills/
  {skill-name}/               # kebab-case directory name
    SKILL.md                   # Required: skill definition
    scripts/                   # Optional: executable scripts
      {script-name}.sh         # Bash scripts (preferred)
    references/                # Optional: detailed reference docs
      {topic}.md               # Markdown reference files
    assets/                    # Optional: templates, examples

Naming Conventions

• Skill directory: kebab-case (e.g., go-best-practices, docker-deploy)
• SKILL.md: Always uppercase, always this exact filename
• Scripts: kebab-case.sh (e.g., lint-check.sh, generate-dockerfile.sh)
• References: kebab-case.md (e.g., allocation-guide.md, channel-patterns.md)

SKILL.md Format

---
name: {skill-name}
description: >
  {One sentence describing when to use this skill.
  Include trigger phrases like "Review my Go code",
  "Optimize performance", etc.}
---

# {Skill Title}

{Brief description of what the skill does.}

## How It Works
{N-step explanation of the skill workflow}

## Rules
{Categorized rules, prioritized by impact}

Guidelines for Modifications

Adding a New Skill

1. Create a new directory under skills/ with a kebab-case name
2. Add a SKILL.md with valid YAML frontmatter (name and description required)
3. Keep SKILL.md under 500 lines — put detailed reference material in references/
4. Write specific descriptions — helps the agent know exactly when to activate
5. Use progressive disclosure — reference supporting files read only when needed
6. Add scripts for repeatable automation tasks