# agents-config

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

## Quick start

```bash
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

```bash
# 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:

```bash
# List available backups
./sync.sh backups

# Restore from last backup
./sync.sh undo
```

### Validate skills

```bash
./sync.sh validate
```

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

## Testing

Tests use [Bats](https://github.com/bats-core/bats-core) (Bash Automated Testing System).

```bash
# 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](https://github.com/brianlovin/claude-config) claude code configs