LAP — компактные спецификации API для агентов

LAP (Lean API Platform)

CLI lapsh сжимает спецификации OpenAPI и GraphQL в короткий формат для агента и ставит навык в Claude Code, Cursor и Codex

345 ★ репозитория
Последний коммит 30 июл. 2026
Apache-2.0

CLI

lap-platform/lapАвтор:Lap-Platform

Установка

Работает в: Claude Code
Cursor
Codex

В терминале, через SkillFoxx CLI

npx skillfoxx add cli/lap-lean-api-platform

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

CLI и навык ходят в публичный реестр, скачивают сторонние спецификации и ставят навыки в папки агента
Команда publish отправляет вашу спецификацию в реестр после входа, поэтому закрытые API так публиковать нельзя

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

LAP переводит описание API в компактный формат .lap, который агенту проще читать, чем исходный YAML. На вход подходят OpenAPI, GraphQL, AsyncAPI, Protobuf, Postman и Smithy. CLI убирает служебные обертки, записывает типы коротко (например, тип uuid вместо двух строк) и выносит общие поля в одно место. Обратно в OpenAPI формат переводит команда lapsh convert. Команда lapsh init ставит в агент навык lap: для Claude Code, а с ключом --target cursor и --target codex для Cursor и Codex. Дальше агент сам ищет в реестре спецификацию нужного сервиса, скачивает ее командой lapsh get или компилирует локальный файл командой lapsh compile. Для конкретных сервисов можно поставить готовый навык, например lapsh skill-install stripe. В реестре на lap.sh больше полутора тысяч готовых спецификаций, а издатель после входа публикует свои командой lapsh publish. Навык можно собрать и из своей спецификации командой lapsh skill, с ключом --ai к сборке подключается локальный Claude CLI.

Для кого. Для разработчиков, которые подключают агента в Claude Code, Cursor или Codex к чужим API и хотят дать ему точную спецификацию в компактном виде.

Подходит, если

Агент должен интегрироваться с Stripe или другим API, и нужна его проверенная спецификация вместо догадок
Огромный файл OpenAPI не помещается в контекст, и его требуется ужать, сохранив эндпоинты и типы
Своя спецификация должна стать навыком, который ставится командой в агенты команды
Нужно поискать в реестре API по теме, например платежи, и отсортировать результаты по популярности
Спецификации в GraphQL, AsyncAPI или Protobuf нужно привести к одному виду для агента

Не подходит, если

API небольшое и его документация умещается в запрос: компиляция добавит лишний шаг
Нужна полная человекочитаемая документация с описаниями полей: режим lean их отбрасывает
В среде нет Node.js или Python: CLI ставится через npm или pip

Пример запроса к агенту

Найди в реестре LAP спецификацию Stripe, поставь навык и покажи, какие эндпоинты нужны для создания платежа.

Ограничения

Для работы нужен Node.js или Python: CLI ставится через npm или pip либо запускается через npx. Публикация в реестр требует учетной записи и входа командой lapsh login.

По замерам автора на 500 слепых запусках по 50 API точность агента без документации составила 0,399, а с готовой спецификацией LAP 0,860. Сжатый вариант lean показал 0,851 против 0,825 у исходной спецификации и обошелся на 35 процентов дешевле. Медианное сжатие OpenAPI равно 5,2 раза. Это результаты самого проекта, независимой проверки нет.

В Codex агенты обращаются к реестру через curl, так быстрее в песочнице, а автообновление хуками пока зависит от экспериментального флага codex_hooks. Спецификации в реестр выкладывают сторонние авторы, поэтому критичные детали сверяйте с документацией сервиса.

Как отключить. Удалите установленные навыки из ~/.claude/skills/lap (для Cursor и Codex из их папок навыков) и снимите пакет командой npm uninstall -g @lap-platform/lapsh.

Частые вопросы

Как поставить LAP в Claude Code?

Выполните npx @lap-platform/lapsh init. Команда ставит навык lap, и агент сам вызывает поиск, скачивание и компиляцию, когда видит задачу с API. Вручную навык вызывается как /lap.

Какие форматы спецификаций понимает LAP?

OpenAPI в YAML и JSON, GraphQL, AsyncAPI, Protobuf, Postman и Smithy. Формат CLI определяет сам.

Чем режим lean отличается от обычного сжатия?

Lean дополнительно отбрасывает описания полей и оставляет имена, типы и ограничения. Размер падает еще примерно на 15 процентов, а точность агента в замерах автора сохраняется.

Как поставить готовый навык для конкретного API?

Найдите сервис командой lapsh search и выполните lapsh skill-install с его именем, например stripe. Навык ложится в ~/.claude/skills для Claude Code.

Как сделать навык из своей спецификации?

Команда lapsh skill spec.yaml -o skills/ --no-ai собирает базовый навык механически, а ключ --ai добавляет доработку через Claude CLI.

Обсуждение

Вопросов и отзывов пока нет.

CLI-инструменты

Agent Harness

Скиллы команды Codely ведут работу агента по фазам: план в файле или GitHub Issues, ревью после каждой фазы и аккуратный коммит

ПлагинРасширенный доступ296

Agent Scripts

Личный набор автора: общие правила для агентов и десятки скиллов для GitHub, браузера, macOS, сообщений и релизов, плюс скрипт синхронизации

СкиллШирокий доступ7,4 тыс.

Caliber

CLI, который создает и поддерживает файлы контекста для кодовых агентов: CLAUDE.md, правила Cursor, AGENTS.md и инструкции Copilot, и держит их в актуальном вид

CLIРасширенный доступ1,3 тыс.

Softaworks Agent Toolkit

Softaworks Agent Skills

Маркетплейс скиллов, субагентов и команд для кодовых агентов: разработка, документация, планирование и рабочая коммуникация

ПлагинРасширенный доступ2,6 тыс.

Claude Command Suite

Набор slash-команд, скиллов и субагентов для Claude Code: ревью, тесты, безопасность, релизы, документация и синхронизация GitHub с Linear

ПлагинШирокий доступ1,3 тыс.

Klaat Code

Официальный

Терминальный кодовый агент, который сам выбирает модель под каждый запрос и показывает расход в реальном времени

CLIШирокий доступ353

Коротко о README

Документация показывает пять стадий сжатия с долей экономии на каждой, сводки замеров на 1500 спецификациях и таблицу форматов. Отдельный блок собирает значки навыков для Claude Code, OpenClaw, Cursor и Codex.

Бейдж для README

Исходный SKILL.md

---
name: lap
description: "LAP CLI -- compile, search, and manage API specs for AI agents. Use when working with API specifications (OpenAPI, GraphQL, AsyncAPI, Protobuf, Postman), compiling specs to LAP format, searching the LAP registry, generating skills from API specs, or publishing APIs. Commands: init, compile, search, get, skill, skill-install, skill-batch, publish, login, logout, whoami."
user-invocable: true
version: 1.0.0
metadata:
  openclaw:
    emoji: "\u26A1"
    requires:
      anyBins: ["npx", "lapsh"]
    install:
      - id: node
        kind: node
        package: "@lap-platform/lapsh"
        bins: ["lapsh"]
        label: "Install LAP CLI (npm)"
---

# LAP CLI

Compile, search, and manage API specs for AI agents.

## Command Resolution

Detect the available CLI binary once per session:

```bash
# Prefer global install, fall back to npx
if command -v lapsh &>/dev/null; then
  LAP_CMD="lapsh"
else
  LAP_CMD="npx @lap-platform/lapsh"
fi
```

Use `$LAP_CMD` (or the resolved form) for all commands below.

---

## Agent Flow -- Consuming APIs

Use this flow when a user needs to find, download, or work with an API.

### 1. Discover

```bash
lapsh search <query> [--tag <tag>] [--sort relevance|popularity|date] [--limit <n>]
```

Search the LAP registry. Results show name, endpoint count, compression ratio, and a `[skill]` marker for installable skills.

```bash
# Find payment APIs sorted by popularity
lapsh search payment --sort popularity

# JSON output for scripting
lapsh search payment --json | jq '.results[] | select(.has_skill) | .name'
```

### 2. Acquire

Сообщить о проблеме