AI Core CLI

The CLI for the open agent ecosystem. Install and manage agents and skills for your favorite AI tools using npx aicores, npx subagents, or npx skills.

Supports OpenCode, Claude Code, Codex, Cursor, and 37 more.

Installation

No installation required — use directly with npx:

# Install agents + skills from a GitHub repo
npx aicores wizeline/my-aicore

# Install from a full GitHub URL
npx aicores https://github.com/wizeline/my-aicore

# List available agents and skills without installing
npx aicores wizeline/my-aicore --list

# Install everything globally, skip all prompts
npx aicores wizeline/my-aicore -g -y

# Install only to Claude Code
npx aicores wizeline/my-aicore -a claude-code

# Install specific skills only
npx aicores wizeline/my-aicore --skill frontend-design

# Install agents separately
npx subagents add wizeline/subagents

# Install skills separately
npx skills add wizeline/skills

Or install globally to use without npx:

# npm
npm install -g aicores

# pnpm
pnpm add -g aicores

# yarn
yarn global add aicores

Once installed globally, use aicore, subagents, or skills directly:

aicores wizeline/my-aicore
subagents add wizeline/agents
skills add wizeline/skills

Tip

Three interchangeable commands: aicores, subagents, and skills all work the same way. Use npx aicores to install a bundled package of agents + skills at once, or use npx subagents / npx skills to install them separately.

`npx aicores` — Install Agents & Skills Together

aicores is the unified command for installing a package that contains both agents (subagents) and skills in one shot.

npx aicores wizeline/my-aicore

An aicore package follows this directory structure:

my-aicore/
├── agents/
│   └── agent-name.md        ← Required: YAML frontmatter + instructions
└── skills/
    └── skill-name/
        ├── SKILL.md          ← Required: YAML frontmatter + instructions
        ├── references/
        │   └── reference.md  ← Optional: reference documents
        ├── assets/
        │   └── template.md   ← Optional: template files
        └── scripts/
            └── helper.py     ← Optional: helper scripts

When you run npx aicores <source>, the CLI:

Clones (or reads) the source
Discovers all agent .md files in the agents/ subfolder → installs them to .agents/agents/
Discovers all skill directories in the skills/ subfolder → installs them to .agents/skills/
Creates symlinks for each installed AI assistant (e.g. .claude/agents/, .claude/skills/)

Source Formats

# GitHub shorthand (owner/repo)
npx aicores wizeline/my-aicore

# Full GitHub URL
npx aicores https://github.com/wizeline/my-aicore

# Direct path to a specific subfolder
npx aicores https://github.com/wizeline/my-aicore/tree/main/packages/backend

# Local path
npx aicores ./my-local-aicore

Options

Option	Description
`-g, --global`	Install to user directory instead of project
`-a, --agent <agents...>`	Target specific AI assistants (e.g., `claude-code`)
`-s, --skill <skills...>`	Install specific skills by name (use `'*'` for all)
`-l, --list`	List available agents and skills without installing
`--copy`	Copy files instead of symlinking
`-y, --yes`	Skip all confirmation prompts
`--all`	Install all items to all AI assistants without prompts

Examples

# List aicores from a folder or URL without installing
npx aicores wizeline/my-aicore --list

# Install everything globally and skip all prompts
npx aicores wizeline/my-aicore -g -y

# Install to specific AI assistants only
npx aicores wizeline/my-aicore -a claude-code -a opencode

# Install only specific skills (agents are always fully installed)
npx aicores wizeline/my-aicore --skill frontend-design

# Non-interactive CI/CD install
npx aicores wizeline/my-aicore -g -y --all

Scaffold a New AICore Package

# Create an aicore structure in a new subdirectory
npx aicores init my-aicore

# Create in the current directory
npx aicores init

This generates:

my-aicore/
├── agents/
│   └── my-agent.md
└── skills/
    └── my-skill/
        └── SKILL.md

Installation Layout

Content	Canonical Path	Agent-Specific Symlink
Agents	`.agents/agents/<name>`	`.claude/agents/<name>.md`
Skills	`.agents/skills/<name>`	`.claude/skills/<name>/`

`npx subagents` / `npx skills` — Install Separately

Use these commands to install agents or skills independently from any repository (not required to follow the aicore structure).

npx subagents add wizeline/agents
npx skills add wizeline/skills

Supported Source Formats

# GitHub shorthand (owner/repo)
npx subagents add wizeline/agents

# Full GitHub URL
npx subagents add https://github.com/wizeline/agents

# Direct path to a skill or agent in a repo
npx subagents add https://github.com/wizeline/agents/tree/main/web-design-guidelines

# GitLab URL
npx subagents add https://gitlab.com/org/agents

# Any git URL
npx subagents add [email protected]:wizeline/agents.git

# Local path
npx subagents add ./my-local-agents

Add Options

Option	Description
`-g, --global`	Install to user directory instead of project
`-a, --agent <agents...>`	Target specific agents (e.g., `claude-code`, `codex`). See Available Agents
`-s, --skill <skills...>`	Install specific items by name (use `'*'` for all)
`-l, --list`	List available items without installing
`--copy`	Copy files instead of symlinking to agent directories
`-y, --yes`	Skip all confirmation prompts
`--all`	Install all items to all agents without prompts

Add Examples

# List items in a repository
npx subagents add wizeline/agents --list

# Install specific items
npx subagents add wizeline/agents --skill frontend-design --skill skill-creator

# Install with spaces in the name (must be quoted)
npx subagents add owner/repo --skill "Convex Best Practices"

# Install to specific agents
npx subagents add wizeline/agents -a claude-code -a opencode

# Non-interactive installation (CI/CD friendly)
npx subagents add wizeline/agents --skill frontend-design -g -a claude-code -y

# Install all items from a repo to all agents
npx subagents add wizeline/agents --all

# Install all items to specific agents
npx subagents add wizeline/agents --skill '*' -a claude-code

# Install specific items to all agents
npx subagents add wizeline/agents --agent '*' --skill frontend-design

Installation Scope

Scope	Flag	Location	Use Case
Project	(default)	`./<agent>/skills/`	Committed with your project, shared with team
Global	`-g`	`~/<agent>/skills/`	Available across all projects

Installation Methods

When installing interactively, you can choose:

Method	Description
Symlink (Recommended)	Creates symlinks from each agent to a canonical copy. Single source of truth, easy updates.
Copy	Creates independent copies for each agent. Use when symlinks aren't supported.

Other Commands

These commands work with all three CLIs (aicores, subagents, skills):

Command	Description
`npx aicore list`	List installed items (alias: `ls`)
`npx aicore find [query]`	Search for items interactively or by keyword
`npx aicore remove [items]`	Remove installed items from agents
`npx aicore check`	Check for available updates
`npx aicore update`	Update all installed items to latest versions
`npx aicore init [name]`	Scaffold a new aicore package structure

`list`

List all installed items. Similar to npm ls.

# List all installed items (project and global)
npx aicore list

# List only global items
npx aicore ls -g

# Filter by specific agents
npx aicore ls -a claude-code -a cursor

`find`

Search for items interactively or by keyword.

# Interactive search (fzf-style)
npx aicore find

# Search by keyword
npx aicore find typescript

`check` / `update`

# Check if any installed items have updates
npx aicore check

# Update all items to latest versions
npx aicore update

`init`

# Scaffold an aicore package in the current directory
npx aicore init

# Scaffold an aicore package in a new subdirectory
npx aicore init my-aicore

# Create a single SKILL.md (using the skills command)
npx skills init my-skill

`remove`

Remove installed items from agents.

# Remove interactively (select from installed items)
npx aicore remove

# Remove specific items by name
npx aicore remove web-design-guidelines

# Remove multiple items
npx aicore remove frontend-design web-design-guidelines

# Remove from global scope
npx aicore remove --global web-design-guidelines

# Remove from specific agents only
npx aicore remove --agent claude-code cursor my-agent

# Remove all installed items without confirmation
npx aicore remove --all

# Remove all items from a specific agent
npx aicore remove --skill '*' -a cursor

# Remove a specific item from all agents
npx aicore remove my-item --agent '*'

# Use 'rm' alias
npx aicore rm my-item

Option	Description
`-g, --global`	Remove from global scope (~/) instead of project
`-a, --agent`	Remove from specific agents (use `'*'` for all)
`-s, --skill`	Specify skills to remove (use `'*'` for all)
`-y, --yes`	Skip confirmation prompts
`--all`	Shorthand for `--skill '' --agent '' -y`

What are Agents & Skills?

Skills are reusable instruction sets that extend your coding agent's capabilities. They're defined in SKILL.md files with YAML frontmatter containing a name and description.

Discover more Skills at skills.sh

Agents (subagents) are specialized personas or automated workflows that can be "hired" to perform tasks.

AICores are bundled packages that combine agents and skills in a standard directory layout, installable with a single npx aicore command.

They let agents perform specialized tasks like:

Generating release notes from git history
Creating PRs following your team's conventions
Integrating with external tools (Linear, Notion, etc.)

Supported Agents

Items can be installed to any of these agents:

Agent	`--agent`	Project Path	Global Path
Amp, Kimi Code CLI, Replit, Universal	`amp`, `kimi-cli`, `replit`, `universal`	`.agents/skills/`	`~\.config\agents\skills/`
Antigravity	`antigravity`	`.agent/skills/`	`~\.gemini\antigravity\skills/`
Augment	`augment`	`.augment/skills/`	`~\.augment\skills/`
Claude Code	`claude-code`	`.claude/skills/`	`~\.claude\skills/`
OpenClaw	`openclaw`	`skills/`	`~\.openclaw\skills/`
Cline	`cline`	`.agents/skills/`	`~\.agents\skills/`
CodeBuddy	`codebuddy`	`.codebuddy/skills/`	`~\.codebuddy\skills/`
Codex	`codex`	`.agents/skills/`	`~\.codex\skills/`
Command Code	`command-code`	`.commandcode/skills/`	`~\.commandcode\skills/`
Continue	`continue`	`.continue/skills/`	`~\.continue\skills/`
Cortex Code	`cortex`	`.cortex/skills/`	`~\.snowflake\cortex\skills/`
Crush	`crush`	`.crush/skills/`	`~\.config\crush\skills/`
Cursor	`cursor`	`.agents/skills/`	`~\.cursor\skills/`
Droid	`droid`	`.factory/skills/`	`~\.factory\skills/`
Gemini CLI	`gemini-cli`	`.agents/skills/`	`~\.gemini\skills/`
GitHub Copilot	`github-copilot`	`.agents/skills/`	`~\.copilot\skills/`
Goose	`goose`	`.goose/skills/`	`~\.config\goose\skills/`
Junie	`junie`	`.junie/skills/`	`~\.junie\skills/`
iFlow CLI	`iflow-cli`	`.iflow/skills/`	`~\.iflow\skills/`
Kilo Code	`kilo`	`.kilocode/skills/`	`~\.kilocode\skills/`
Kiro CLI	`kiro-cli`	`.kiro/skills/`	`~\.kiro\skills/`
Kode	`kode`	`.kode/skills/`	`~\.kode\skills/`
MCPJam	`mcpjam`	`.mcpjam/skills/`	`~\.mcpjam\skills/`
Mistral Vibe	`mistral-vibe`	`.vibe/skills/`	`~\.vibe\skills/`
Mux	`mux`	`.mux/skills/`	`~\.mux\skills/`
OpenCode	`opencode`	`.agents/skills/`	`~\.config\opencode\skills/`
OpenHands	`openhands`	`.openhands/skills/`	`~\.openhands\skills/`
Pi	`pi`	`.pi/skills/`	`~\.pi\agent\skills/`
Qoder	`qoder`	`.qoder/skills/`	`~\.qoder\skills/`
Qwen Code	`qwen-code`	`.qwen/skills/`	`~\.qwen\skills/`
Roo Code	`roo`	`.roo/skills/`	`~\.roo\skills/`
Trae	`trae`	`.trae/skills/`	`~\.trae\skills/`
Trae CN	`trae-cn`	`.trae/skills/`	`~\.trae-cn\skills/`
Windsurf	`windsurf`	`.windsurf/skills/`	`~\.codeium\windsurf\skills/`
Zencoder	`zencoder`	`.zencoder/skills/`	`~\.zencoder\skills/`
Neovate	`neovate`	`.neovate/skills/`	`~\.neovate\skills/`
Pochi	`pochi`	`.pochi/skills/`	`~\.pochi\skills/`
AdaL	`adal`	`.adal/skills/`	`~\.adal\skills/`

Note

Kiro CLI users: After installing skills, manually add them to your custom agent's resources in .kiro/agents/<agent>.json:

{
  "resources": ["skill://.kiro/skills/**/SKILL.md"]
}

The CLI automatically detects which coding agents you have installed. If none are detected, you'll be prompted to select which agents to install to.

Creating an AICore Package

An aicore package bundles agents and skills together. Use npx aicore init to scaffold the structure, then fill in your content.

Agent Files (`agents/*.md`)

Agent files define a specialized AI persona or subagent. They are plain .md files with YAML frontmatter:

---
name: my-agent
description: A specialized agent for code review
---

# My Agent

Instructions for the AI agent. Define the persona, goals, and behavior here.

## Role

You are a senior code reviewer focused on security and maintainability.

## Instructions

1. Review all changes for security vulnerabilities
2. Check for code duplication and suggest refactors
3. Verify test coverage for new code

Skill Files (`skills/<name>/SKILL.md`)

Skills are reusable instruction sets. Each skill lives in its own subdirectory with a SKILL.md file:

---
name: my-skill
description: What this skill does and when to use it
---

# My Skill

Instructions for the agent to follow when this skill is activated.

## When to Use

Describe the scenarios where this skill should be used.

## Steps

1. First, do this
2. Then, do that

Required Fields (both agents and skills)

name: Unique identifier (lowercase, hyphens allowed)
description: Brief explanation of what the agent/skill does

Optional Skill Fields

metadata.internal: Set to true to hide the skill from normal discovery. Internal skills are only visible and installable when INSTALL_INTERNAL_SKILLS=1 is set.

---
name: my-internal-skill
description: An internal skill not shown by default
metadata:
  internal: true
---

Skill Directory Structure

Each skill folder can optionally include:

skills/my-skill/
├── SKILL.md          ← Required
├── references/       ← Optional: reference documents the skill can cite
├── assets/           ← Optional: templates and other static assets
└── scripts/          ← Optional: helper scripts the skill can invoke

Skill Discovery

The CLI searches for skills in these locations within a repository:

Root directory (looks for SKILL.md)
skills/ subdirectory and sub-folders (like .curated/, .experimental/)
Agent-specific directories (e.g., .agents/skills/, .claude/skills/, etc.)
Plugin manifest files (marketplace.json, plugin.json)

Plugin Manifest Discovery

If .claude-plugin/marketplace.json or .claude-plugin/plugin.json exists, skills declared in those files are also discovered:

// .claude-plugin/marketplace.json
{
  "metadata": { "pluginRoot": "./plugins" },
  "plugins": [
    {
      "name": "my-plugin",
      "source": "my-plugin",
      "skills": ["./skills/review", "./skills/test"]
    }
  ]
}

This enables compatibility with the Claude Code plugin marketplace ecosystem.

If no skills are found in standard locations, a recursive search is performed.

Compatibility

Skills are generally compatible across agents since they follow a shared Agent Skills specification. However, some features may be agent-specific:

Feature	OpenCode	OpenHands	Claude Code	Cline	CodeBuddy	Codex	Command Code	Kiro CLI	Cursor	Antigravity	Roo Code	Github Copilot	Amp	OpenClaw	Neovate	Pi	Qoder	Zencoder
Basic skills	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes
`allowed-tools`	Yes	Yes	Yes	Yes	Yes	Yes	Yes	No	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Yes	No
`context: fork`	No	No	Yes	No	No	No	No	No	No	No	No	No	No	No	No	No	No	No
Hooks	No	No	Yes	Yes	No	No	No	No	No	No	No	No	No	No	No	No	No	No

Troubleshooting

"No agents or skills found"

Ensure the repository follows the aicore structure with an agents/ and/or skills/ subfolder, or contains valid SKILL.md files with both name and description in the frontmatter.

Skill not loading in agent

Verify the skill was installed to the correct path
Check the agent's documentation for skill loading requirements
Ensure the SKILL.md frontmatter is valid YAML

Permission errors

Ensure you have write access to the target directory.

Environment Variables

Variable	Description
`INSTALL_INTERNAL_SKILLS`	Set to `1` or `true` to show and install skills marked as `internal: true`
`DISABLE_TELEMETRY`	Set to disable anonymous usage telemetry
`DO_NOT_TRACK`	Alternative way to disable telemetry

# Install internal items
INSTALL_INTERNAL_SKILLS=1 npx aicore wizeline/my-aicore --list

Telemetry

This CLI collects anonymous usage data to help improve the tool. No personal information is collected.

Telemetry is automatically disabled in CI environments.

License

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 254 Commits
.github		.github
.husky		.husky
bin		bin
repro-repo/agents		repro-repo/agents
scripts		scripts
sdlc-test		sdlc-test
skills/find-skills		skills/find-skills
src		src
test-repro		test-repro
tests		tests
.gitignore		.gitignore
.prettierrc		.prettierrc
AGENTS.md		AGENTS.md
README.md		README.md
ThirdPartyNoticeText.txt		ThirdPartyNoticeText.txt
build.config.mjs		build.config.mjs
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
skills-lock.json		skills-lock.json
tsconfig.json		tsconfig.json

Folders and files

Latest commit

History

Repository files navigation

AI Core CLI

Installation

npx aicores — Install Agents & Skills Together

Source Formats

Options

Examples

Scaffold a New AICore Package

Installation Layout

npx subagents / npx skills — Install Separately

Supported Source Formats

Add Options

Add Examples

Installation Scope

Installation Methods

Other Commands

list

find

check / update

init

remove

What are Agents & Skills?

Supported Agents

Creating an AICore Package

Agent Files (agents/*.md)

Skill Files (skills/<name>/SKILL.md)

Required Fields (both agents and skills)

Optional Skill Fields

Skill Directory Structure

Skill Discovery

Plugin Manifest Discovery

Compatibility

Troubleshooting

"No agents or skills found"

Skill not loading in agent

Permission errors

Environment Variables

Telemetry

License

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Uh oh!

Contributors 0

Languages

`npx aicores` — Install Agents & Skills Together

`npx subagents` / `npx skills` — Install Separately

`list`

`find`

`check` / `update`

`init`

`remove`

Agent Files (`agents/*.md`)

Skill Files (`skills/<name>/SKILL.md`)

Packages

Contributors