AXI — скилл
Десять принципов для CLI, которым пользуются агенты, и скилл, по которому агент строит и проверяет такие утилиты
- 2 244 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Скилл состоит из текстовых инструкций и сам ничего не запускает и не ходит в сеть
- Референсные gh-axi и chrome-devtools-axi ставятся отдельно и дают агенту доступ к GitHub и к управляемому браузеру
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/axiОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Скилл состоит из текстовых инструкций и сам ничего не запускает и не ходит в сеть
- Референсные gh-axi и chrome-devtools-axi ставятся отдельно и дают агенту доступ к GitHub и к управляемому браузеру
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
AXI (Agent eXperience Interface) описывает, как сделать консольную утилиту удобной для агента, а не для человека за терминалом. Исходная посылка простая: каждое поле в выводе стоит токенов, а каждый лишний вызов стоит еще больше. Поэтому принципы требуют компактный вывод в формате TOON, минимальные поля в списках, обрезку длинных текстов с подсказкой про флаг --full, готовые подсчеты вместо повторных запросов и однозначное «0 результатов» вместо пустого ответа. Скилл axi кладет эти правила с примерами в контекст агента, когда тот пишет, меняет или проверяет CLI. В репозитории также лежит каталог готовых утилит в этом стиле, среди них gh-axi для GitHub и chrome-devtools-axi для браузера, и два бенчмарка с опубликованными прогонами.
Для кого. Для разработчиков, которые пишут консольные утилиты и обертки над API для Claude Code, Codex и других агентов и хотят уложиться в бюджет токенов.
Подходит, если
- Вы пишете CLI-обертку над внутренним сервисом, и агент должен работать с ней без чтения длинной справки
- Вывод вашей утилиты раздувает контекст: списки на десять полей, тела тикетов целиком, пустые ответы без пояснений
- Нужно проверить существующий CLI на соответствие принципам: интерактивные запросы, неясные коды выхода, молчаливый игнор неизвестных флагов
- Вы выбираете между MCP-сервером и консольной утилитой для агента и хотите увидеть опубликованные замеры по стоимости и числу ходов
- Нужно подключить к проекту готовые gh-axi или chrome-devtools-axi из каталога репозитория
Не подходит, если
- Нужна готовая утилита для конкретной задачи: сам скилл ничего не выполняет и только описывает правила, утилиты ставятся отдельно из каталога
- Ваш инструмент рассчитан на человека и не будет вызываться агентами: принципы про токены и отказ от интерактива там не нужны
- Вы строите MCP-сервер: принципы описывают CLI, которые агент запускает через оболочку
- Нужен единый формат вывода для людей и машин: TOON сокращает токены, но читается хуже привычного JSON для обычных скриптов
Пример запроса к агенту
Прочитай скилл axi и проверь наш CLI tasks по десяти принципам: покажи, какие поля списка лишние и где вывод стоит обрезатьОграничения
Скилл содержит рекомендации и примеры, а проверку соответствия AXI он не автоматизирует. Опубликованные бенчмарки сняты на Claude Sonnet 4.6 по двум областям, GitHub и управление браузером, и автор прямо отмечает, что на других моделях результаты могут отличаться. Формат TOON новый, поэтому перед тем как строить на нем вывод, прочитайте его спецификацию: скилл сам просит об этом в первом разделе. Принципы рассчитаны на утилиты, которые агент запускает через оболочку, поэтому требования вроде отказа от интерактивных запросов нельзя перенести на обычные программы для человека без доработки.
Как отключить. Удалите папку axi из каталога скиллов проекта (например, .claude/skills/axi) или из глобального каталога, если ставили с флагом -g. Установленные отдельно gh-axi и chrome-devtools-axi снимаются командой npm uninstall -g.
Частые вопросы
Что такое AXI и зачем он нужен агенту?
AXI — набор из десяти принципов для консольных утилит, которые запускает агент. Цель — тратить меньше токенов и ходов: компактный вывод, пояснения о следующем шаге и структурированные ошибки без интерактивных запросов.
Как поставить скилл AXI в Claude Code?
Выполните npx skills add kunchenguid/axi. По умолчанию скилл попадает в каталог скиллов текущего проекта, например .claude/skills. Чтобы поставить его глобально, добавьте флаг -g.
Что такое TOON и почему AXI требует его для вывода?
TOON (Token-Oriented Object Notation) — формат вывода, который по оценке скилла дает примерно на 40 процентов меньше токенов, чем эквивалентный JSON, и остается читаемым для агента. Внутри утилиты логику разрешено держать на JSON, а в TOON вывод переводится на выходе.
Чем AXI отличается от MCP?
MCP — протокол, по которому агент вызывает инструменты через сервер. AXI — набор правил для обычных CLI, которые агент запускает в оболочке. В бенчмарке из репозитория gh-axi закрыл 17 задач GitHub со 100 процентами успеха, а GitHub MCP набрал 87 процентов при стоимости в среднем почти втрое выше.
Какие готовые утилиты в стиле AXI уже есть?
Официальные в каталоге репозитория: gh-axi для GitHub, chrome-devtools-axi для браузера, lavish-axi для ревью HTML-артефактов и quota-axi. Сообщество добавило, например, npm-axi для реестра npm, homebrew-axi для Homebrew, playwright-axi и bun-axi.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыCLI-установщик и менеджер скиллов для кодовых агентов: одна команда ставит скиллы в разные среды и помогает собирать свои
Axe на Go: однозадачные ИИ-агенты описываются в TOML и запускаются из терминала, по каналу оболочки, из cron и хуков git, с памятью и подагентами
CLI на Go, который настраивает уже установленные у вас ИИ-агенты: дает им общую память, рабочий процесс и детерминированные шаги, не подменяя сами агенты
Agents Best Practices
agents-best-practices
Скилл проектирования агентных систем без привязки к вендору: архитектура цикла, инструменты, права, память и наблюдаемость
CLI, который держит в одном месте общий контекст кодовых агентов: инструкции, скиллы, MCP, субагентов и долгую память по проектам и машинам
Многоагентная обвязка с проверкой результата по артефактам: стоп-хуки, независимый судья и журнал событий для Claude Code, Codex, Cursor и других
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| AXI (эта запись) | нет | 2 244 | ||
| Context Mode | нет | не нужна | 31 987 | сжимает вывод инструментов уже во время сессии, а AXI описывает, как построить сам CLI экономным |
| Chrome DevTools MCP | да | не нужна | 54 043 | MCP-сервер для управления браузером, у AXI на ту же задачу есть обертка chrome-devtools-axi |
Коротко о README
Репозиторий начинается с двух бенчмарков на Claude Sonnet 4.6: 14 браузерных задач и 17 задач на GitHub, по пять повторов каждая, с таблицей успеха, стоимости, времени и числа ходов. Дальше идет быстрый старт с установкой gh-axi и chrome-devtools-axi и строка для CLAUDE.md или AGENTS.md. Затем перечислены десять принципов и каталог утилит, официальных и от сообщества, с доменом и кратким описанием. Раздел «Build Your Own AXI» отправляет к скиллу и советует как основной путь интеграции выпустить явную команду установки хуков сессии, а скилл дать второй, более легкой дорожкой. В конце лежат команды запуска обоих бенчмарков.
Бейдж для README
Исходный SKILL.md
---
name: axi
description: >
Agent eXperience Interface (AXI) — ergonomic standards for building CLI tools that agents
use via shell execution. Use when building, modifying, or reviewing any agent-facing CLI.
---
# Agent eXperience Interface (AXI)
AXI defines ergonomic standards for building CLI tools that autonomous agents interact with through shell execution.
## Before you start
Read the [TOON specification](https://toonformat.dev/reference/spec.html) before building any AXI output.
## 1. Token-efficient output
Use [TOON](https://toonformat.dev/) (Token-Oriented Object Notation) as the output format on stdout.
TOON provides ~40% token savings over equivalent JSON while remaining readable by agents.
Convert to TOON at the output boundary — keep internal logic on JSON.
```
tasks[2]{id,title,status,assignee}:
"1",Fix auth bug,open,alice
"2",Add pagination,closed,bob
```
## 2. Minimal default schemas
Every field in stdout costs tokens — multiplied by row count in collections.
Default to the smallest schema that lets the agent decide what to do next: typically an identifier, a title, and a status.
- Default list schemas: 3-4 fields, not 10
- Default limits: high enough to cover common cases in one call (if most repos have <100 labels, default to 100, not 30)
- Long-form content (bodies, descriptions) belongs in detail views, not lists
- Offer a `--fields` flag to let agents request additional fields explicitly
## 3. Content truncation
Detail views often contain large text fields. Omitting them forces agents to hunt; including them wastes tokens.
Truncate by default and tell the agent how to get the full version.
```
task:
number: 42
title: Fix auth bug
state: open
body: First 500 chars of the issue body...
... (truncated, 8432 chars total)
help[1]: Run `tasks view 42 --full` to see complete body