Agent Skills Repository

A personal repository for versioned Claude Code skills. Skills are modular AI-powered review/automation tools that can auto-invoke based on context.

Available Skills

Skill	Description
gin-go	Gin framework-specific review for routing, middleware, handlers, and request/response patterns
go-repository	Repository pattern enforcement for codebases using Jet ORM, domain models, and adapter patterns
go-review-ddd	DDD architecture review enforcing layer boundaries, pointer semantics, and domain-driven design patterns
go-style	Go style and idioms from the official Go Code Review Comments wiki

Installation

Run the installation script to symlink all skills to ~/.claude/skills/:

./install.sh

This creates symlinks from this repository to your Claude skills directory, so:

• Skills stay versioned in git
• Updates are applied via git pull
• Changes are reflected immediately (no copying)

Usage

After installation, skills are available in Claude Code:

/go-review-ddd

Skills with disable-model-invocation: false will auto-invoke when relevant (e.g., go-review-ddd triggers after writing Go code in DDD projects).

Skill Relationships

Skills work together with complementary focuses:

• go-review-ddd - Architectural patterns (DDD, layers, service structure)
• go-repository - Repository-specific patterns (Jet ORM, adapters, transactions)
• go-style - General Go idioms (formatting, errors, naming, concurrency)
• gin-go - Gin framework patterns (routing, middleware, binding)

For a typical Go file in a DDD project:

1. go-review-ddd checks architecture and layer boundaries
2. go-repository checks repository patterns (if applicable)
3. go-style checks Go idioms and style
4. gin-go checks Gin-specific patterns (if Gin is imported)

Adding New Skills

1. Create a new directory under skills/
2. Add a SKILL.md file with frontmatter and instructions
3. Run ./install.sh to install the new skill

Skill Definition Format

Each skill uses a SKILL.md file with YAML frontmatter:

---
name: skill-name
description: What the skill does
disable-model-invocation: false    # true = user-invoked only
allowed-tools: Read, Grep, Glob    # Tool restrictions
---
# Skill instructions and rules...

Project Structure

skills/
├── gin-go/
│   └── SKILL.md        # Gin framework patterns
├── go-repository/
│   └── SKILL.md        # Repository pattern with Jet ORM
├── go-review-ddd/
│   └── SKILL.md        # DDD architecture patterns
└── go-style/
    └── SKILL.md        # Official Go style guide
install.sh              # Creates symlinks to ~/.claude/skills/
README.md
CLAUDE.md               # Claude Code project context