Install

Install Armadillo

Requirements

Claude Code — that’s it. Works on macOS, Windows, and Linux. No terminal, no scripts, no package manager.

Install

Open Claude Code in your project directory, then tell Claude:

Install armadillo from https://github.com/Armadillo-Nation/armadillo-main-brains

Important: Exit your Claude Code session and start a new one. This loads the hooks and settings that were just installed.

Then in the new session:

/armadillo-sync

Done.

What happens

1. Claude reads the armadillo repo from GitHub
2. Copies core skills, hooks, rules, and agents into your .claude/ directory
3. /armadillo-sync runs project analysis, selects skill packs for your stack, and generates CLAUDE.md

Everything lives in your project’s .claude/ folder. Nothing global, nothing system-wide.

Add skill packs

armadillo-core covers workflow, testing, git, and debugging. Optional skill packs extend it with domain-specific expertise — frontend, database, auth, deploy, and more.

To add or remove skill packs:

/armadillo-sync

See the README for the full list of available skill packs.

Update

Tell Claude:

/armadillo-sync

Checks for new versions, diffs your files, handles conflicts, and offers new skill packs.