AIWorkers

Central npm package for Claude Code configurations. Instead of each project writing its own CLAUDE.md from scratch, AIWorkers centralizes everything that is reusable — commit standards, slash commands, agent personas, and rules. Install once per machine and all your projects get it automatically.

---

Installation

Install globally once per machine:

npm install -g @salve-software/aiworkers

Then run setup once per machine:

aiworkers setup

Or without installing globally:

npx @salve-software/aiworkers setup

The setup command links commands, skills, agents, and rules into your global ~/.claude/ folder, making them available across all your projects automatically.

---

CLI

  Usage:  aiworkers <command>

  Commands:

    setup      Install AIWorkers into the global ~/.claude/ folder
    update     Upgrade AIWorkers to the latest version on npm and re-sync
    unsetup    Remove AIWorkers content from ~/.claude/ (keeps npm package)
    --version  Print the installed version
    --help     Show this help message

---

What it sets up

Inside your global ~/.claude/:

~/.claude/
├── commands/aiworkers/     # User-invokable slash commands
├── skills/aiworkers/       # Context-triggered skills (auto-invoked by Claude)
├── agents/aiworkers/       # Agent personas loaded on demand by skills
├── rules/aiworkers/        # Composable rules imported into CLAUDE.md
└── CLAUDE.md               # Auto-updated with @rules/aiworkers/* imports

All entries are symlinks pointing back to the installed npm package — running update re-syncs them automatically.

---

What lives here vs in the project

	AIWorkers	Project
Commit standards	✅
Reusable slash commands	✅
Agent personas	✅
Domain context		✅
Specific stack		✅
Business rules		✅
Project-specific commands		✅

---

Available commands

Command	Description
/feature	PDCA multi-agent workflow to plan, implement, review, and ship a feature
/aiworkers:land	Create branch + commit + PR in one step
/rn-component	Scaffold a React Native component using the Layered Hook Architecture

Skills (auto-triggered by Claude based on context):

Skill	Trigger
branch	When Claude needs to create a git branch
commit	When the user wants to commit changes
pr	When the user wants to open a pull request

---

Requirements

• Node.js 18+
• Claude Code with an active Pro or Team plan
• gh CLI installed and authenticated (required for /pr and /feature)

---

Structure

AIWorkers/
├── src/
│   ├── commands/          # User-invokable slash commands
│   ├── skills/            # Context-triggered skills
│   ├── agents/            # Agent personas
│   └── rules/             # Composable rules
├── bin/
│   └── aiworkers.js       # CLI entry point
├── scripts/
│   └── setup.sh           # Legacy bash setup (Unix only)
├── docs/                  # Decisions, patterns, and reference docs
├── CLAUDE.md
└── package.json

---

Inspiration ❤️

The skills and commands format used in AIWorkers was inspired by Matt Pocock's skills — the concept of structured, file-based Claude Code skills that can be shared and reused across projects. Thanks Matt!