Asi — AI skill for Claude Code

asi

`asi` is a cross-tool packaging system for AI agent and skill catalogs. You maintain one canonical catalog of agents and skills, and `asi` renders it into the tool-specific formats each AI coding assistant expects:

• Claude Code — .claude/agents/*.md, .claude/skills/*/SKILL.md
• GitHub Copilot — .github/agents/*.agent.md, .github/skills/
• OpenAI Codex / modern OpenAI agents — .codex/agents/*.toml
• Gemini CLI — .gemini/agents/*.md, .gemini/skills/

Write an agent or skill body once, describe it once in the catalog registry, and `asi` handles the per-tool frontmatter, file naming, and directory layout differences for you.

It also does a second, related job: `asi gateway` points those same tools at a local LLM gateway, so the tool that reads your catalog and the endpoint it talks to are configured from one place. See [Gateway wiring](#gateway-wiring).

Why

Every AI coding tool has invented its own format for "here's a reusable agent persona" and "here's a reusable skill/playbook" — different frontmatter fields, different file extensions, different directory conventions. If you use more than one tool (or want to keep your team's agents/skills portable across tools), you end up hand-maintaining near-duplicate copies. `asi` keeps one source of truth and generates the rest.

Install

There isn't a one-line installer yet — build from source:

git clone https://github.com/corypolicht/asi.git
cd asi
go build ./cmd/asi
./asi --version

Requires Go 1.25+. Prebuilt release binaries for Linux/Windows will be published on this repo's Releases page in a future update — CI and release automation are still being wired up for the public mirror, so for now, building from source is the supported path.

Quick Start

Every `asi` command needs to find a `catalog/` directory — either bundled next to the binary, or discovered by walking up from your current directory (handy in this repo's own dev loop), or pointed at explicitly: