# json-parser

Скилл json-parser для Claude Code разбирает и проверяет JSON из строительных API, IoT-сенсоров и BIM-экспортов. Преобразует вложенные данные в таблицы.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 115 установок · ★ 434 у репозитория
- Автор: datadrivenconstruction
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction/tree/HEAD/2_DDC_Book/2.1-Data-Types-Classification/json-parser/SKILL.md
- Обновлён: 2026-10-19
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/json-parser

## Что делает

Скилл читает JSON из файла или строки, сообщает об ошибках разбора и считает записи. Вложенные объекты он разворачивает в плоские поля, а данные преобразует в `pandas.DataFrame`. Для путей внутри структуры есть извлечение элементов через точечную запись, например по вложенному ключу.

В составе есть базовый парсер и специализированные классы для BIM и IoT. BIM-парсер ищет элементы в полях `elements`, `objects` или `entities`, разворачивает их и извлекает свойства из `properties`, `params`, `parameters` и `attributes`. IoT-парсер приводит показания к полям сенсора, времени, значения, единицы и расположения.

Для проверки структуры скилл сравнивает развёрнутые поля со списком обязательных и возвращает пропущенные и найденные поля. Для запуска нужен `python3`, а преобразование данных в таблицу использует библиотеку `pandas`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill json-parser -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/json-parser/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/json-parser/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill json-parser -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/json-parser/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill json-parser -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/json-parser/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction 2_DDC_Book/2.1-Data-Types-Classification/json-parser
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/json-parser/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill json-parser -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --path 2_DDC_Book/2.1-Data-Types-Classification/json-parser
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/json-parser/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill json-parser -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction/tree/HEAD/2_DDC_Book/2.1-Data-Types-Classification/json-parser/SKILL.md

## Когда брать
- разобрать JSON-файл или строку
- развернуть вложенные объекты в плоские поля
- преобразовать записи в `pandas.DataFrame`
- извлечь элементы по точечному пути
- проверить обязательные поля схемы

## Примеры запросов агенту
- Используй скилл `json-parser`, чтобы разобрать `bim_export.json` и преобразовать данные в таблицу.
- Проверь JSON из этого ответа по обязательным полям `project.id` и `project.name`.
- Извлеки показания IoT-сенсоров из вложенного массива и подготовь таблицу.

## Похожие
- [Document to JSON – PDF Invoice/Statement/Contract Parser](https://affpapa.org/nevibecode/mcp/document-to-json-pdf-invoicestatementcontract-parser.md) — MCP-сервер · ★ 8 у репозитория
- [json-data-handling](https://affpapa.org/nevibecode/skills/json-data-handling.md) — скилл · 402 установки
- [python-flask-json-guide-cursorrules-prompt-file](https://affpapa.org/nevibecode/rules/python-flask-json-guide-cursorrules-prompt-file.md) — правило · ★ 41178 у репозитория
- [shuffle-json-data](https://affpapa.org/nevibecode/skills/shuffle-json-data.md) — скилл · 8700 установок
- [system-text-json-net11](https://affpapa.org/nevibecode/skills/system-text-json-net11.md) — скилл · 4200 установок
- [unit-test-json-serialization](https://affpapa.org/nevibecode/skills/unit-test-json-serialization.md) — скилл · 4000 установок

Из того же набора: [datadrivenconstruction/ddc_skills_for_ai_agents_in_construction](https://affpapa.org/nevibecode/by/datadrivenconstruction/ddc_skills_for_ai_agents_in_construction.md) — 156 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
