Agent Config

Personal configuration repository for AI agents (OpenCode, Claude, containing custom commands, skills, and workflow settings.

🚀 Quick Start

Installation

# Run the interactive CLI
npx @whyleonardo/agent-config

Benefits:

• Interactive prompts guide you through setup
• Choose from preset configurations or customize
• Select only the skills/commands you need
• Beautiful terminal UI
• Always fetches latest version
• Automatic backup of existing configurations

Requirements:

• Node.js ≥18.0.0
• npm (comes with Node.js)

📖 CLI Documentation

✨ What's Included

📂 Structure

.claude/
├── CLAUDE.md           # Global settings and workflow preferences
├── commands/           # Custom slash commands
│   ├── create-feature.md
│   ├── investigate.md
│   ├── investigate-batch.md
│   ├── open-pr.md
│   ├── review-staged.md
│   └── trim.md
└── skills/            # Coding guidelines and best practices
    ├── react/
    ├── reviewing-code/
    ├── software-engineering/
    ├── typescript/
    └── writing/

🎯 Global Settings (CLAUDE.md)

Core principles applied across all projects:

• Git Workflow: Conventional commits, no "Claude Code" in messages
• Code Quality Focus:
  • End-to-end type safety
  • Error monitoring/observability
  • Automated testing
  • Readability/maintainability

⚡ Custom Commands

Command	Description	Trigger
create-feature	Scaffold new features following best practices	/create-feature
investigate	Deep dive into bugs or issues	/investigate
investigate-batch	Quick investigation for simple issues	/investigate-batch
open-pr	Create pull requests with proper context	/open-pr
review-staged	Review staged changes before committing	/review-staged
trim	Enable concise response mode	/trim

🛠️ Skills

Detailed coding guidelines that agents can reference:

Skill	Description
software-engineering	Core engineering principles, design patterns, SOLID
typescript	TypeScript/JavaScript standards and best practices
react	React/Next.js patterns, hooks, component architecture
reviewing-code	Code review guidelines, checklists, and standards
writing	Technical writing and documentation standards

🎨 CLI Preset Configurations

The interactive CLI offers preset configurations:

Full-Stack React

Perfect for React/Next.js full-stack projects

• Skills: TypeScript, React, Software Engineering, Code Review
• Commands: create-feature, investigate, review-staged, open-pr

Backend API

Optimized for Node.js backend development

• Skills: TypeScript, Software Engineering, Code Review
• Commands: create-feature, investigate, review-staged, trim

Frontend Only

Frontend-focused with React

• Skills: TypeScript, React, Writing
• Commands: create-feature, review-staged, open-pr

Minimal

Essentials only for any TypeScript project

• Skills: TypeScript, Software Engineering
• Commands: investigate

📚 CLI Installation Guide

# Install and run
npx @whyleonardo/agent-config

# Follow the prompts:
# 1. Choose AI agent (Claude Code / OpenCode)
# 2. Choose installation target (project/global)
# 3. Select a preset or customize
# 4. Pick skills and commands
# 5. Configure git workflow

Full CLI Documentation →

🔄 Updating

# Run the CLI again - it will detect and backup existing config
npx @whyleonardo/agent-config

🌍 Local vs Global Installation

Local Installation (./.claude/)

Use when:

• Working in a team with shared coding standards
• Want configuration versioned with your project
• Need project-specific customizations

Characteristics:

• Located in project root
• Committed to version control
• Shared with team members
• Overrides global settings

Global Installation (~/.claude/)

Use when:

• Want consistent settings across all projects
• Working on personal projects
• Need default configuration for new projects

Characteristics:

• Located in home directory
• Personal preferences
• Not committed to version control
• Used as fallback when no local config exists

🛠️ Development

CLI Development

cd cli/
npm install
npm run dev        # Watch mode
npm run build      # Build for production
npm start          # Run built CLI

Repository Structure

agent-config/
├── .claude/           # Template content (source of truth)
├── cli/              # NPM package source
│   ├── src/          # TypeScript source
│   ├── dist/         # Built files
│   └── package.json
└── README.md         # This file

🤝 Contributing

Contributions welcome! Feel free to:

• Open an issue for bugs or features
• Submit a pull request with improvements
• Share your custom commands and skills

📖 Learn More

• OpenCode Documentation
• Custom Commands Guide
• Skills Documentation
• Configuration Reference

📝 License

MIT

---

Repository: github.com/whyleonardo/agent-config

NPM Package: @whyleonardo/agent-config

Issues & Support: github.com/whyleonardo/agent-config/issues