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
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
npx @agents-inc/cli init
npm install -g @agents-inc/cli
requires node 18+ and Claude Code.
commands
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 repository, organized by category:
| 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):
npx @agents-inc/cli init
start from scratch (pick individual skills):
npx @agents-inc/cli init
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:
agentsinc search
agentsinc search react
importing third-party skills
import skills from any GitHub repository into your local setup:
agentsinc import skill github:vercel-labs/agent-skills --list
agentsinc import skill github:vercel-labs/agent-skills --skill react-best-practices
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:
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 for the full reference.
links
license
MIT