armadillo

import { Card, CardGrid } from ‘@astrojs/starlight/components’;

What is armadillo?

armadillo is a modular skill system for Claude Code. It gives your AI assistant structured workflows, domain expertise, and quality gates — so it writes better code with less supervision.

29 core skills handle workflows like TDD, debugging, planning, and code review. 30 optional packs add domain expertise — frontend, backend, database, ads, SEO, and more. 140 skills total.

Brainstorming, planning, TDD, debugging, verification — structured processes that prevent sloppy work. Install only what you need. Frontend, backend, database, auth, deploy, ads, SEO, CRO, AI — 30 packs available. The shepherd skill classifies every request and routes to the right skill automatically. No manual invocation needed. Hooks enforce TDD, block direct commits to main, and verify work before completion. Code review built in.

Quick Start

# Clone into your project
git clone https://github.com/Armadillo-Nation/armadillo-main-brains.git /tmp/armadillo-src

# Run the installer
node /tmp/armadillo-src/scripts/install.js

# Restart Claude Code to pick up the new skills

After install, Claude Code automatically uses armadillo skills — no manual invocation required.

How It Works

armadillo installs into your project’s .claude/ directory:

Component	Location	Purpose
Skills	.claude/skills/	Workflow instructions Claude follows
Rules	.claude/rules/	Always-on constraints (security, testing, git)
Agents	.claude/agents/	Specialized subagents (code reviewer, brand strategist)
Hooks	.claude/hooks/	Shell scripts that enforce quality gates
Packs	packs/	Optional domain expertise modules

Skills are markdown files with frontmatter metadata. Claude reads them and follows the instructions. No runtime dependencies, no build step, no configuration.

Stats

	Count
Core skills	29
Skill packs	30
Pack skills	111
Total skills	140
Rules	12
Agents	23
Hooks	14