Agent Skills

maroffo/claude-forge

An experiment in organizing Claude Code skills. Token-optimized configurations for Go, Python, Rails, and Terraform with patterns extracted from real projects.

License:MITLanguage:N/A41
claude-forge - An experiment in organizing Claude Code skills. To preview

Deep Analysis

Token优化模块化技能，Go/Python/Rails/Terraform，ast-grep强制

Core Features

Technical Implementation

Highlights
  • Token优化 - 模块化加载
  • 语言特定 - 4主要语言
  • ast-grep强制 - 结构化搜索
  • 跨语言模式 - 一致性
  • project-analyzer - 自动生成
Use Cases
  • Go开发
  • Python开发
  • Rails开发
  • Terraform IaC
  • 代码搜索
Limitations
  • 4语言限定
  • 需要理解各语言
  • 英文文档
Tech Stack
GoPythonRailsTerraformast-grepClaude Code
README
View on GitHub

Claude Code Skills

Token-optimized, modular skills for Claude Code. Language-specific best practices, architectural patterns, and workflows that auto-invoke when relevant.

Quick Start

Install skills:

git clone https://github.com/maroffo/claude-forge.git
cp -r claude-forge/skills/* ~/.claude/skills/

Add to your global ~/.claude/CLAUDE.md:

# Skills
**Core:** golang, python, rails, terraform
**Utilities:** _INDEX.md, _AST_GREP.md, _PATTERNS.md
**Support:** source-control, project-analyzer

See CLAUDE.md.example for a complete global configuration template.

Why Skills?

Modular - Load only relevant expertise per project (Go skills don't load in Rails projects)

Token-efficient - Smaller, focused files vs monolithic global config

Discoverable - _INDEX.md routes Claude to the right skill fast

Cross-referenced - _PATTERNS.md shows same pattern across languages; _AST_GREP.md mandates proper code search

Real-world tested - Evolved through production use across Go, Python, Rails, and Terraform projects

Skills

Languages

  • golang/ - Code conventions, architecture, concurrency, code review
  • python/ - uv package manager, type checking, linting, Docker deployment
  • rails/ - Service-oriented architecture, forms, contracts, Sidekiq, RSpec
  • terraform/ - IaC patterns, modules, state management, Terragrunt

Utilities (cross-cutting)

  • _AST_GREP.md - Structural code search patterns (mandates ast-grep over grep/ripgrep)
  • _INDEX.md - Quick skill lookup by language/task/problem domain
  • _PATTERNS.md - Cross-language patterns (DI, error handling, testing, background jobs)

Support

  • source-control/ - Conventional commits, git workflow, branch strategies, hook protocols
  • project-analyzer/ - Generate CLAUDE.md for new codebases

How It Works

Skills auto-invoke based on your project context. When working in a Go project, golang/ skill loads automatically. When Claude needs to search code, _AST_GREP.md enforces ast-grep usage.

Global ~/.claude/CLAUDE.md handles:

  • Interaction style and personality
  • Cross-project code philosophy
  • Universal git workflow rules
  • TDD requirements

Skills handle:

  • Language-specific idioms and patterns
  • Framework-specific best practices
  • Tool-specific workflows

Both work together: global config sets the foundation, skills provide domain expertise.

Inspiration

Evolved from Harper Reed's dotfiles and Matteo Vaccari's AI-assisted modernization series, refined through production use.

License

MIT