AI Core CLI

The CLI for the open agent ecosystem. Install and manage agents and skills for your favorite AI tools using npx aicore, npx agents, 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 aicores agents add wizeline/agent-skills

# Install skills separately
npx aicores skills add wizeline/agent-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, agents, or skills directly:

aicore wizeline/my-aicore
agents add wizeline/agent-skills
skills add wizeline/agent-skills

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

npx aicore — Install Agents & Skills Together

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

npx aicore 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 aicore <source>, the CLI:

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

Source Formats

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

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

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

# Local path
npx aicore ./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 aicore wizeline/my-aicore --list

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

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

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

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

Scaffold a New AICore Package

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

# Create in the current directory
npx aicore 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 agents / npx skills — Install Separately

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

npx agents add wizeline/agent-skills
npx skills add wizeline/agent-skills

Supported Source Formats

# GitHub shorthand (owner/repo)
npx agents add wizeline/agent-skills

# Full GitHub URL
npx agents add https://github.com/wizeline/agent-skills

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

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

# Any git URL
npx agents add [email protected]:wizeline/agent-skills.git

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

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 agents add wizeline/agent-skills --list

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

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

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

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

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

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

# Install specific items to all agents
npx agents add wizeline/agent-skills --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 (aicore, agents, 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.

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.)

Discover more at skills.sh

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