agents-config

Personal AI agent configuration with settings and skills, synced across machines across agent harnesses via symlinks. Supports configurable agent harnesses.

Quick start

git clone https://github.com/artivilla/agents-config.git
cd agents-config
./install.sh

What's included

Settings

• settings.json - Global permissions and preferences
• statusline.sh - Custom statusline showing token usage

Skills

Reusable capabilities that Claude can invoke (use /skill-name in Claude):

Skill	Description
agent-browser	Browser automation for web testing and interaction
favicon	Generate favicons from a source image
knip	Find and remove unused files, dependencies, and exports
rams	Run accessibility and visual design review
reclaude	Refactor CLAUDE.md files for progressive disclosure
simplify	Code simplification specialist
deslop	Remove AI-generated code slop

Managing your config

# See what's synced vs local-only
./sync.sh

# Preview what install would do
./install.sh --dry-run

# Add a local skill to the repo
./sync.sh add skill my-skill
./sync.sh push

# Pull changes on another machine
./sync.sh pull

# Remove a skill from repo (keeps local copy)
./sync.sh remove skill my-skill
./sync.sh push

Safe operations with backups

All destructive operations create timestamped backups:

# List available backups
./sync.sh backups

# Restore from last backup
./sync.sh undo

Validate skills

./sync.sh validate

Skills must have a SKILL.md with frontmatter containing name and description.

Testing

Tests use Bats (Bash Automated Testing System).

# Install bats (one-time)
brew install bats-core

# Run all tests
bats tests/

# Run specific test file
bats tests/install.bats
bats tests/sync.bats
bats tests/validation.bats

Tests run in isolated temp directories and don't affect your actual ~/.claude config.

Multi-agent support

Skills can be symlinked to multiple AI agent directories. Edit agents.conf to enable agents:

claude=~/.claude/skills
# codex=~/.codex/skills
# amp=~/.config/agents/skills
# antigravity=~/.gemini/antigravity/global_skills
# droid=~/.factory/skills
# gemini=~/.gemini/skills

Uncomment any agent you use, then run ./install.sh. Skills are symlinked to all enabled agents. Settings, agents, and rules remain Claude-only.

Local-only config

Not everything needs to be synced. The install script only creates symlinks for what's in this repo - it won't delete your local-only skills.

Machine-specific permissions accumulate in ~/.claude/settings.local.json (auto-created by Claude, not synced).

Creating your own

Fork this repo and customize! The structure is simple:

agents-config/
├── settings.json      # claude code settings
├── statusline.sh      # Optional statusline script
├── agents.conf        # Which agents to install skills to
├── lib.sh             # Shared functions for scripts
├── skills/            # Skills (subdirectories with SKILL.md)
├── agents/            # Subagent definitions
├── rules/             # Rule files
└── tests/             # Bats tests

Inspired and adapted from @brianlovin claude code configs