@ixc/agent-installer

CLI that installs AI agent definitions, skills, and generates CLAUDE.md files across a multi-project workspace. No AI required at install time — it places static markdown files and injects project names into templates.

Install

# Local (development / before publishing to npm)
npm link

# Global (after publishing)
npm install -g @ixc/agent-installer

Commands

ai-portal init       # Scan workspace and show detected projects
ai-portal install    # Install agents, skills, and generate CLAUDE.md files
ai-portal update     # Update installed files to latest registry versions
ai-portal add        # Add a single agent or skill

ai-portal init

Scans the current directory and detects projects by folder prefix. Does not write any files.

cd my-workspace/
ai-portal init

ai-portal install

Installs shared agents and skills to .claude/, generates a CLAUDE.md for each project and the workspace root.

Skips files that already exist. To overwrite:

ai-portal install --force

After install, fill in [COMPLETE] placeholders in each project's CLAUDE.md.

ai-portal update

Compares installed file versions against the registry. Updates only what changed.

ai-portal update

ai-portal add

Adds a single agent or skill to the workspace, or to a specific project.

ai-portal add agent frontend-agent
ai-portal add skill zustand-state-management
ai-portal add agent frontend-agent --project mf-campaign   # project-level override

Project Types

Projects are detected by folder prefix:

| Prefix | Type | Description | |--------|------|-------------| | mf- | Micro Frontend | React presentation layer | | ms- | Microservice | Independent backend service | | bff | Backend for Frontend | API orchestrator | | ca- | Container App | Batch processing / Excel exports | | acl- | ACL Transformer | Data contract transformation | | adapter- | Adapter | External system connector |

What Gets Installed

my-workspace/
├── CLAUDE.md                        ← workspace instructions
├── .claude/
│   ├── agents/                      ← shared agents (flat — all projects)
│   │   ├── frontend-agent.md
│   │   └── ...
│   └── skills/                      ← shared skills (flat — all projects)
│       ├── vercel-react-best-practices/
│       └── ...
├── mf-campaign/
│   └── CLAUDE.md                    ← generated from mf template
└── ms-campaign/
    └── CLAUDE.md                    ← generated from ms template

Adding Agents and Skills

See CONTRIBUTING.md for the 2-step process.

Publishing

See docs/publishing.md.

Rules

• Never run npm run build automatically — prohibited in all agents and templates
• Lint is available as a Claude hook only, not an agent step
• All content (templates, CLI output, CLAUDE.md, agents) must be in English