К основному содержанию
скилл CX Codex

json-schema-lookup — скилл для Claude Code

Скилл json-schema-lookup учит агента искать схемы конфигов популярных проектов в каталоге SchemaStore и проверять по ним структуру файлов.

Apache-2.0 ★ 173 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add sammcj/agentic-coding --skill json-schema-lookup -a claude-code
Открыть на GitHub

Что делает json-schema-lookup

Скилл описывает порядок запросов к SchemaStore. Сначала агент забирает каталог с https://www.schemastore.org/api/json/catalog.json, выбирает запись по имени или маске fileMatch, а потом качает схему по её url. По схеме видно, какие поля допустимы, какие значения разрешены и что обязательно.

Внутри — готовые однострочники под curl и jq: ключи верхнего уровня, отдельное поле с типом и enum, список required, общие definitions, на которые ведут $ref. Работа идёт в шелле, WebFetch остаётся запасным путём.

Схемы бывают большими, и выгружать их целиком не стоит: скилл советует спрашивать отдельные пути, а каталог кэшировать, если за сессию запросов несколько. Часть схем собирает свойства через allOf и anyOf — без обхода этих массивов список полей окажется неполным.

Какие задачи решает

  • проверить, какие поля принимает tsconfig.json
  • найти схему конфига по маске имени файла
  • выяснить список значений enum для параметра
  • посмотреть обязательные поля до правки конфига
  • разобрать большой конфиг по частям, не выгружая схему целиком

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

  • Найди в SchemaStore схему для package.json и покажи, какие поля обязательны.
  • Проверь по схеме, допустимо ли esnext в поле target из tsconfig.json.
  • Достань из каталога запись для .eslintrc и перечисли свойства верхнего уровня.

Как установить json-schema-lookup

1Через Skills CLI (Vercel)

npx skills add sammcj/agentic-coding --skill json-schema-lookup -a claude-code

2Вручную: положить файлы

~/.claude/skills/json-schema-lookup/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/json-schema-lookup/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о json-schema-lookup

Как установить json-schema-lookup в Claude Code?

Выполните npx skills add sammcj/agentic-coding --skill json-schema-lookup -a claude-code. Файл скилла появится в ~/.claude/skills/json-schema-lookup/SKILL.md.

Что делает json-schema-lookup?

Даёт агенту процедуру поиска схем конфигов в SchemaStore и чтения их через curl и jq: свойства, типы, enum, обязательные поля.

Что нужно, чтобы скилл сработал?

Сетевой доступ для curl или WebFetch и jq для разбора JSON. В allowed-tools также перечислены yq, grep, head и less.

Исходный текст

SKILL.md · Apache-2.0
---
name: json-schema-lookup
description: >-
  Guidelines for querying schemastore.org. Use when you need to validate or discover
  options for config files relating to popular open source projects.
allowed-tools: WebFetch Bash(curl *) Bash(jq *) Bash(yq *) Bash(grep *) Bash(head *) Bash(less *)
---

# JSON Schema Lookup via SchemaStore

Query schemastore.org's catalog of public configuration file schemas to validate structure, discover options, and check allowed values.

## API

- **Catalog**: `https://www.schemastore.org/api/json/catalog.json`
  - Structure: `{ "schemas": [{ "name", "description", "fileMatch", "url", "versions"? }] }`
- **Individual schemas**: Fetch the `url` from the matching catalog entry

## Workflow

### 1. Find the schema

Search the catalog by name or filename pattern:

```bash
# Search by name (case-insensitive)
curl -s https://www.schemastore.org/api/json/catalog.json | jq '.schemas[] | select(.name | test("tsconfig"; "i")) | {name, url, fileMatch}'

# Search by filename match
curl -s https://www.schemastore.org/api/json/catalog.json | jq '.schemas[] | select(.fileMatch[]? | test("package\\.json")) | {name, url}'
```

Alternatively, use WebFetch on the catalog URL and ask for the relevant entry.

### 2. Fetch and inspect the schema

```bash
# List top-level properties
curl -s SCHEMA_URL | jq '.properties | keys'

# Inspect a specific field (type, enum values, description)
curl -s SCHEMA_URL | jq '.properties.FIELD_NAME'

# Check definitions/shared types (schemas use $ref to these)
curl -s SCHEMA_URL | jq '.definitions.DEF_NAME.properties'

# Get the full schema (warning - might be large!)
curl -s SCHEMA_URL | jq .
```

### 3. Common queries

```bash
# Find enum values for a field
curl -s SCHEMA_URL | jq '.properties.FIELD.enum'

# List nested properties (e.g. compilerOptions in tsconfig)
curl -s SCHEMA_URL | jq '.definitions.compilerOptionsDefinition.properties.compilerOptions.properties | keys'

# Find all required fields
curl -s SCHEMA_URL | jq '.required'
```

## Tips

- Some schemas use `allOf`/`anyOf` composition -- check those arrays for the full property set
- The `versions` field on catalog entries provides version-specific schema URLs when available
- Schema URLs vary: some point to `json.schemastore.org`, others to `raw.githubusercontent.com`
- For large schemas, query specific paths rather than dumping the entire document
- Cache the catalog response locally if making multiple lookups in one session

© sammcj · Apache-2.0 · sammcj/agentic-coding

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
jq-json-processing laurigates Скилл jq-json-processing для парсинга, фильтрации и трансформации JSON через jq. Извлекает поля, фильтрует массивы, перестраивает объекты и валидирует синтаксис. CX Codex +1 245установок crm-lookup HubSpot Скилл crm-lookup ищет контакты, компании и сделки в HubSpot CRM через официальный CLI по почте, домену или ID и подтягивает связанные записи. CX Codex +1 2 000установок tool-function-schema-designer patricio0312rev Скилл tool-function-schema-designer помогает описать инструменты для LLM так, чтобы модель вызывала их с валидными аргументами: JSON-схема, типы, проверка через zod и примеры вызовов. CX Codex +1 258установок implementing-api-schema-validation-security mahipal Скилл implementing-api-schema-validation-security настраивает проверку контрактов API через OpenAPI и JSON Schema на шлюзе и в коде. Защищает от инъекций, массового присвоения и утечек данных. CX Codex +1 280установок nx-workspace nrwl Скилл nx-workspace для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который даёт агенту команды для навигации по Nx-монорепозиторию. CX Codex +1 100 600установок ce-setup EveryInc Скилл ce-setup для Claude Code проверяет инструменты и конфигурацию Compound Engineering в репозитории, создаёт пакеты и обновляет документацию по коду. Запускается при настройке окружения или в CI. CX Codex +1 3 600установок

Из того же набора73

Весь набор →
github Задаёт правила работы с GitHub через gh: от чтения комментариев к PR до проверки GitHub Actions. Разбирает issues и ревью. CX Codex +1 ★ 173звёзд репо compact-prep Команда compact-prep просит агента обновить состояние работы перед сжатием контекста, а затем выдаёт промпты для сжатия диалога и продолжения в новой сессии. CX Codex +1 ★ 173звёзд репо subagent-delegation Скилл subagent-delegation учит Claude Code делить работу между субагентами, распределять файлы между ними и выбирать между отдельным агентом и форком. CX Codex +1 ★ 173звёзд репо openspeccer Скилл openspeccer открывает локальный дашборд OpenSpec и показывает активные изменения, их артефакты и задачи. Подходит для просмотра статуса проекта. CX Codex +1 ★ 173звёзд репо deferred-task-execution Скилл deferred-task-execution для Claude Code откладывает запуск команд на заданный интервал или точное время. Запускает тесты или деплой позже. CX Codex +1 ★ 173звёзд репо compression-editor Субагент compression-editor для Claude Code сжимает прозу, инструкции, скиллы и документацию без потери смысла. Исходный код он не обрабатывает и не делает саммари. CX Codex ★ 173звёзд репо explain Скилл explain объясняет архитектуру, работу систем и код через ASCII-схемы в терминале или интерактивные HTML-страницы с анимацией шагов. CX Codex +1 ★ 173звёзд репо openspec-bootstrap Скилл openspec-bootstrap настраивает OpenSpec в репозитории: создаёт схему, конфигурацию и проверяет их. Нужен при первом запуске или изменении openspec/config.yaml. CX Codex +1 ★ 173звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой