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!