Skip to main content

​
Overview

The Corelayer CLI ships with a built-in Corelayer skill. Once installed, supported AI agents can automatically use the Corelayer CLI whenever you mention production issues, errors, monitoring, or triage without needing to re-read --help or be told how the CLI works. This is useful for:
  • Developers who use AI coding agents as their daily assistant
  • Background agents that monitor or triage production issues on a schedule
  • Anyone who wants an agent to reach for corelayer commands instead of raw HTTP requests

​
Install the Skill

corelayer install-skill
This installs the skill file for supported agent runtimes.

​
Verify Installation

After installing, start a new agent session. The skill should appear anywhere your agent exposes installed skills or command packs. If your agent supports manual invocation, use that tool’s native mechanism to load the Corelayer skill.

​
What the Skill Teaches the Agent

The skill gives the agent complete knowledge of the Corelayer CLI:
  • All commands and their flags (issues list, issues get, issues close, groups list, etc.)
  • Global flags (--json, --quiet, --api-url, --no-color)
  • Common workflows (checking production health, triaging issues, scripting with JSON output)
  • Background agent best practices (--json for structured output, --quiet to suppress interactive messages, default-group to avoid repeating group IDs)

​
Auto-Trigger

On agents that support automatic skill loading, the skill can activate when you mention:
  • Production issues, errors, or monitoring
  • Incidents or root cause analysis
  • Issue triage
  • “Check prod”, “what’s broken”, “any errors”
  • Corelayer by name
You may not need to invoke the skill manually, depending on how your agent handles installed skills.

​
Background Agent Setup

Background agents benefit the most from the skill because they cannot interactively read --help. To set up a background agent:
  1. Install the CLI and authenticate:
npm install -g @corelayer-ai/cli
corelayer login
  1. Set a default group so the agent does not need to pass --group on every call:
corelayer config set default-group <group-id>
  1. Install the skill:
corelayer install-skill
The agent will now use --json for structured output and know the full command surface without additional prompting.

​
Uninstall the Skill

corelayer uninstall-skill
This removes the installed skill files.

​
How It Works

The skill is a Markdown file (SKILL.md) containing:
  • Frontmatter with trigger keywords that tell the agent when to load the skill
  • Instructions with the full CLI command reference, flags, and workflows
The install-skill command copies this file from the CLI package into the local skill location used by supported agent runtimes. The underlying guidance is agent-agnostic even when a given installer targets a specific runtime’s skill directory.