json-schema-lookup — скилл для Claude Code
Скилл json-schema-lookup учит агента искать схемы конфигов популярных проектов в каталоге SchemaStore и проверять по ним структуру файлов.
Apache-2.0 ★ 173 обновлён 2026-10-24
npx skills add sammcj/agentic-coding --skill json-schema-lookup -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/json-schema-lookup/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/json-schema-lookup/
1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill json-schema-lookup -a codex2Вручную: положить файлы
.agents/skills/json-schema-lookup/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill json-schema-lookup -a cursor2Вручную: положить файлы
.cursor/skills/json-schema-lookup/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install sammcj/agentic-coding Skills/json-schema-lookup/SKILL.md2Вручную: положить файлы
.github/skills/json-schema-lookup/SKILL.md1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill json-schema-lookup -a gemini-cli2Командой платформы
gemini skills install https://github.com/sammcj/agentic-coding --path Skills/json-schema-lookupВручную: положить файлы
.devin/skills/json-schema-lookup/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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