project-builder — скилл для Claude Code: проекты от плана до отладки
Ведёт проект по фазам: разбор запроса, выбор архитектуры, инкрементальная сборка, проверка и систематическая отладка. Полезен, когда просят собрать дашборд, веб-приложение или задачу по расписанию.
npx skills add Starchild-ai-agent/official-skills --skill project-builder -a claude-codeЧто делает project-builder
Скилл превращает расплывчатое «сделай мне сервис» в спецификацию. На первом шаге он выбирает архитектуру по дереву решений: периодические отчёты уходят в задачу по расписанию, живой интерфейс — в preview-сервер, разовый анализ выполняется инлайн, а переиспользуемый инструмент становится скриптом. Для средних и крупных проектов результат показывается до написания кода: поток данных, выбор архитектуры, оценка стоимости запусков и известные ограничения.
Дальше идёт каркас output/projects/{slug}/ с project.yaml, PROJECT.md, .env.example и папкой src/. Тип проекта задаёт точку входа: src/run.py для задачи, src/server.py для сервиса, src/main.py для скрипта, src/index.html или src/app.py для превью. Каждый новый считываемый кодом параметр обязан сразу попасть в .env.example.
Перед сборкой скилл требует прочитать справочники платформы: config/context/references/sc-proxy.md для внешних API, preview-guide.md для превью, scheduled-tasks-guide.md для задач по расписанию. Все внешние вызовы идут через sc-proxy с оплатой за запрос и лимитами — без этого файла проект упрётся в 401. Визуальные страницы дополнительно проходят через скилл ui-design: без него HTML получится шаблонным.
Какие задачи решает
- разбить размытую задачу на этапы и зафиксировать архитектуру до кода
- развернуть каркас проекта с конфигом, документацией и примером переменных окружения
- поднять дашборд в preview-сервере и проверить его
- запланировать регулярную задачу и следить за её логами
- найти причину поломки после того, как всё работало локально
Примеры запросов агенту
- Собери дашборд по продажам из API, сначала покажи план и оценку стоимости запусков
- Сделай скрипт, который каждый день собирает сводку и присылает отчёт
- Проект сломался в превью — разберись системно, а не наугад
Как установить project-builder
1Через Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill project-builder -a claude-code2Вручную: положить файлы
~/.claude/skills/project-builder/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/project-builder/
1Через Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill project-builder -a codex2Вручную: положить файлы
.agents/skills/project-builder/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill project-builder -a cursor2Вручную: положить файлы
.cursor/skills/project-builder/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Starchild-ai-agent/official-skills project-builder2Вручную: положить файлы
.github/skills/project-builder/SKILL.md1Через Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill project-builder -a gemini-cli2Командой платформы
gemini skills install https://github.com/Starchild-ai-agent/official-skills --path project-builderВручную: положить файлы
.devin/skills/project-builder/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill project-builder -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о project-builder
Как установить project-builder в Claude Code?
Выполните npx skills add Starchild-ai-agent/official-skills --skill project-builder -a claude-code. Скилл появится по пути ~/.claude/skills/project-builder/SKILL.md.
Что делает project-builder?
Проводит проект через фазы дизайна, каркаса, инкрементальной сборки, проверки в превью и отладки. Отдельно следит, чтобы структура папок позволяла потом опубликовать проект.
Почему проект падает с ошибкой 401 при обращении к API?
Внешние вызовы идут через sc-proxy, и скилл требует заранее прочитать config/context/references/sc-proxy.md. Пропуск этого шага — частая причина ошибок авторизации, сломанных путей и сбоев в превью.
