# Agents Inc. CLI

the CLI for working with Agents Inc. skills. it's the entry point for everything: installing skills, creating stacks, and creating custom skills and subagents

```bash
npx @agents-inc/cli init
```

## what this does

Claude Code is okay out of the box, but it doesn't know your stack. the skills repository has 80+ in-depth modules covering react, hono, drizzle, posthog, and a lot more. each skill is atomic, comprehensive, and composable into agents and stacks

the CLI is how you work with all of it:

- **install skills** as plugins or locally into your project
- **create stacks** by bundling skills with a modular agent approach
- **scaffold new skills** when you need something custom
- **set up your own marketplace** if you're building for a team or org

## getting started

```bash
# run the wizard - picks skills, sets up agents
npx @agents-inc/cli init

# or install globally
npm install -g @agents-inc/cli
```

requires node 18+ and [Claude Code](https://docs.anthropic.com/en/docs/claude-code).

## commands

| command             | what it does                                                  |
| ------------------- | ------------------------------------------------------------- |
| `init`              | interactive setup - pick skills, configure agents             |
| `edit`              | modify your skill selection                                   |
| `compile`           | recompile agents after changes                                |
| `update`            | update local skills from source                               |
| `list`              | show what's installed                                         |
| `doctor`            | diagnose setup issues                                         |
| `search`            | search skills (interactive multi-source or static query)      |
| `info <skill>`      | show skill details                                            |
| `diff`              | show skill differences vs source                              |
| `outdated`          | check for outdated skills                                     |
| `validate`          | check your setup is correct                                   |
| `new skill`         | create a custom skill                                         |
| `new agent`         | create a custom agent                                         |
| `import skill`      | import a skill from an external GitHub repository             |
| `eject`             | eject skills/agent partials for customization                 |
| `uninstall`         | remove Agents Inc. from project                               |
| `config`            | manage settings (show, get, set-project, unset-project, path) |
| `version`           | show/manage plugin versions (show, set, bump)                 |
| `build marketplace` | generate marketplace.json                                     |
| `build plugins`     | build individual skill plugins                                |
| `build stack`       | build a stack plugin                                          |

every command supports `--dry-run` and `--source` flags. run `npx @agents-inc/cli <command> --help` for full options.

## how skills work

a skill is focused knowledge for one technology. not surface-level docs but actual patterns, edge cases, the things you'd normally have to explain repeatedly

skills live in the [agents-inc/skills](https://github.com/agents-inc/skills) repository, organized by category:

| category | what's there                                                                                                                                                                                                                                                                          |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| web      | react, vue, angular, solidjs, next.js, remix, nuxt, scss-modules, cva, zustand, pinia, ngrx-signalstore, jotai, react-query, swr, trpc, graphql, react-hook-form, zod, shadcn-ui, radix-ui, tanstack-table, vitest, playwright, cypress, msw, framer-motion, storybook, accessibility |
| api      | hono, express, fastify, drizzle, prisma, better-auth, posthog, resend, axiom+pino+sentry, github-actions                                                                                                                                                                              |
| mobile   | react-native, expo                                                                                                                                                                                                                                                                    |
| cli      | commander, oclif+ink                                                                                                                                                                                                                                                                  |
| infra    | turborepo, tooling, env config                                                                                                                                                                                                                                                        |
| meta     | code reviewing, research methodology, investigation requirements, anti-over-engineering, context management                                                                                                                                                                           |

## stacks

stacks bundle skills together with pre-configured agents. instead of picking 20 skills individually, grab a stack that matches your setup:

- **nextjs-fullstack** - next.js + react + hono + drizzle + posthog + zustand + react-query
- **angular-stack** - angular 19 + signals + ngrx signalstore + hono + drizzle
- **vue-stack** - vue 3 composition API + pinia + hono + drizzle
- **nuxt-stack** - nuxt + vue 3 full-stack + pinia + hono + drizzle
- **remix-stack** - remix + react + hono + drizzle
- **solidjs-stack** - solidjs + hono + drizzle
- **react-native-stack** - react native + expo + zustand + react-query
- **meta-stack** - agents for creating agents, skills, docs, and extracting patterns

each stack includes agents like `web-developer`, `api-developer`, `web-reviewer`, `web-tester`, `web-researcher`, `pattern-scout`, `documentor` - roles that use the right skills for the job.

## installation modes

the wizard starts by asking how you want to set up:

**use a stack** (default):

```bash
npx @agents-inc/cli init
# select "Use a stack" → pick a pre-built stack (e.g. nextjs-fullstack)
# installs as a native Claude Code plugin to ./.claude/plugins/agents-inc/
# you can customize skills after selecting a stack
```

**start from scratch** (pick individual skills):

```bash
npx @agents-inc/cli init
# select "Start from scratch" → browse domains and pick skills one by one
# installs locally to ./.claude/skills/ in your repo
```

both modes compile agents and generate a config at `.claude-src/config.yaml`. use `agentsinc edit` to change skills after initial setup.

## multi-source setup

you can install skills from multiple sources. the wizard supports adding extra marketplaces alongside the default source:

- press `G` in the wizard to open source settings
- add marketplace URLs (e.g. `github:your-org/custom-marketplace`)
- skills from all sources appear in the selection grid, tagged by origin

you can also manage sources after setup with `agentsinc edit` (same `G` hotkey).

to search across all configured sources:

```bash
# interactive search across all sources
agentsinc search

# static search with a query
agentsinc search react
```

## importing third-party skills

import skills from any GitHub repository into your local setup:

```bash
# list available skills from a repository
agentsinc import skill github:vercel-labs/agent-skills --list

# import a specific skill
agentsinc import skill github:vercel-labs/agent-skills --skill react-best-practices

# import all skills from a repository
agentsinc import skill github:vercel-labs/agent-skills --all
```

imported skills are copied to `.claude/skills/` and tracked with metadata for future updates.

## creating custom skills

if the existing skills don't cover what you need:

```bash
npx @agents-inc/cli new skill my-custom-skill
```

this scaffolds the structure. a skill is just markdown with examples - no special tooling required.

## architecture

built with TypeScript (strict mode), oclif for commands, Ink (React) for terminal UI, Zod for runtime validation, and Zustand for wizard state. the core pipeline:

```
source resolution → skill loading → matrix merging → wizard selection → config generation → agent compilation → installation
```

the codebase is organized into domain-driven library modules (`agents/`, `configuration/`, `loading/`, `matrix/`, `plugins/`, `skills/`, `stacks/`, `installation/`) with barrel exports. agents are compiled from YAML definitions + markdown partials through Liquid templates.

see [docs/reference/architecture.md](./docs/reference/architecture.md) for the full reference.

## links

- [skills repository](https://github.com/agents-inc/skills) - all the skills and stacks
- [Claude Code docs](https://docs.anthropic.com/en/docs/claude-code) - the tool this extends

## license

MIT
