first-commit — скилл для Claude Code: создание проектов
Скилл first-commit для Claude Code создаёт проекты из готовых наборов и помогает обновлять их. Запускается при создании приложения, добавлении библиотеки или работе с проектом, где есть kits.lock.
MIT 1 100 установок ★ 2 обновлён 2026-11-15
npx skills add Marlon-Chaviano/first-commit --skill first-commit -a claude-codeЧто делает first-commit
first-commit создаёт проект из набора: шаблона, зависимостей, скиллов агента, MCP-серверов и правил AGENTS.md. Для выбора набора можно вызвать MCP-инструменты recommend_kit и get_kit; без MCP доступны команды npx create-first-commit list и npx create-first-commit info <kit>.
Перед запуском создания скилл показывает план через --dry-run и запрашивает подтверждение: реальная установка запускает команды и скачивает пакеты. Для проекта с kits.lock команды update и add обновляют набор или добавляют библиотеку, а doctor проверяет правила проекта. Изменённые пользователем файлы update не перезаписывает.
После создания скилл читает AGENTS.md и выполняет доступные первые шаги; для остальных могут понадобиться API-ключи или аккаунты. Наборы сообщества требуют подтверждения, а с --yes также флага --allow-commands, если пользователь явно им доверяет.
Какие задачи решает
- создать приложение из шаблона с зависимостями и правилами
- добавить библиотеку вроде Sentry или Stripe в существующий проект
- обновить набор проекта, не перезаписывая изменённые файлы
- проверить, соблюдает ли проект правила набора
Примеры запросов агенту
- Создай приложение с Expo из подходящего набора и сначала покажи план.
- Добавь Stripe в этот проект.
- Обнови проект с
kits.lockи проверь его правила.
Как установить first-commit
1Через Skills CLI (Vercel)
npx skills add Marlon-Chaviano/first-commit --skill first-commit -a claude-code2Вручную: положить файлы
~/.claude/skills/first-commit/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/first-commit/
1Через Skills CLI (Vercel)
npx skills add Marlon-Chaviano/first-commit --skill first-commit -a codex2Вручную: положить файлы
.agents/skills/first-commit/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Marlon-Chaviano/first-commit --skill first-commit -a cursor2Вручную: положить файлы
.cursor/skills/first-commit/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Marlon-Chaviano/first-commit skills/first-commit2Вручную: положить файлы
.github/skills/first-commit/SKILL.md1Через Skills CLI (Vercel)
npx skills add Marlon-Chaviano/first-commit --skill first-commit -a gemini-cli2Командой платформы
gemini skills install https://github.com/Marlon-Chaviano/first-commit --path skills/first-commitВручную: положить файлы
.devin/skills/first-commit/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add Marlon-Chaviano/first-commit --skill first-commit -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о first-commit
Как установить first-commit в Claude Code?
Выполни npx skills add Marlon-Chaviano/first-commit --skill first-commit -a claude-code. Файл скилла появится по пути ~/.claude/skills/first-commit/SKILL.md.
Что делает first-commit?
Создаёт проекты из наборов с шаблоном, зависимостями и правилами AGENTS.md, а также добавляет библиотеки и обновляет существующие проекты с kits.lock.
Что нужно для работы first-commit?
Для создания и обслуживания проекта используются команды npx create-first-commit; если доступен MCP-сервер first-commit, скилл может запросить через него набор. Для отдельных первых шагов проекта могут понадобиться API-ключи или аккаунты.
Исходный текст
SKILL.md · MIT
---
name: first-commit
description: Start new projects and keep them up to date with first-commit workspace kits (project template + dependencies + agent skills + MCP servers + AGENTS.md rules, installed by `npx create-first-commit`). Use when the user wants to create a new app, landing, SaaS, API, mobile app or browser extension, or to add a library such as Sentry, PostHog, Stripe or Better Auth to an existing project, or when the project has a kits.lock file.
license: MIT
---
# first-commit
`create-first-commit` creates a project from a *kit*: a base project plus the dependencies, agent skills, MCP servers and `AGENTS.md` rules for the stack the user picks. Catalog and configurator: https://first-commit.dev.
## When to use it
- **New project** in an empty folder ("make me a recipes app with Expo", "a landing with animations"): use a kit instead of scaffolding by hand.
- **Existing project with `kits.lock`**: it came from a kit. Use `update` to get the kit's improvements and `add` to add libraries, so the rules in `AGENTS.md` stay in sync.
- **Adding a catalog library** (Sentry, PostHog, Stripe, Resend, Better Auth, Kokonut UI, Motion…) to any project: `add` writes its config and its rule in `AGENTS.md`.
## Create a project
1. Pick the kit. If the first-commit MCP server is available, call `recommend_kit` with the user's description, then `get_kit` for the options. Otherwise:
- `npx create-first-commit list` — official kits.
- `npx create-first-commit info <kit>` — options and their values.
2. Choose only the options the user asked for; keep the defaults for everything else. Options are flags: `--<option> <value>` (comma-separated for multi options).
3. **Show the plan and ask before running anything**: `npx create-first-commit <kit> <folder> [options] --dry-run` (or the `plan_init` tool). Installing runs commands and downloads packages.
4. After the user agrees: the same command without `--dry-run` and with `--yes` (or `init_kit` with `approved: true`). It takes a few minutes.
5. Read the new project's `AGENTS.md` and follow its "first steps": do the setup tasks you can, and tell the user which ones need them (API keys, accounts). Copy `.env.example` to `.env` but never invent secret values.
Community kits (`user/kit`) that aren't verified ask for confirmation; with `--yes` they also need `--allow-commands`. Only add it if the user explicitly trusts that kit.
## Maintain a project
- `npx create-first-commit update --dry-run`, then `npx create-first-commit update --yes`: new dependencies, skills, MCP servers and rules from the kit's latest version. Files the user changed are never overwritten; it lists them.
- `npx create-first-commit add <library|owner/repo@skill> --yes`: adds a catalog library with the right variant for the framework (Sentry for Next.js, Expo or Node).
- `npx create-first-commit doctor`: checks that the project still follows its rules (one component library, env vars, skills installed). Exit code 1 means errors; fix them or tell the user.
## Rules
- The rules in `AGENTS.md` between `<!-- kits:start -->` and `<!-- kits:end -->` come from the kit: follow them (for example, "only use the chosen component library"). Don't edit that block by hand; `update` rewrites it.
- Don't install a second library for something the kit already chose (another component system, another auth). Use `add --force` only if the user explicitly wants to switch.
## Composable monorepos
Use the `monorepo` kit to choose web, API, documentation and mobile separately.
`--web nextjs --api django --docs starlight` selects frameworks; library flags
include their service and framework, for example `--web.nextjs.components mantine`
and `--api.fastapi.database sqlmodel`. Use `info monorepo` to inspect exact choices.
Choose `--orchestrator simple|turbo|nx` and `--deployment independent|compose|none`.
A service destination is scoped too: `--web.nextjs.deploy vercel`.
Run `node scripts/workspace.mjs dev|build|verify [service]` from the generated root.
After starting web and API, `node scripts/check-connection.mjs` checks API health and
CORS. Production URLs and secrets belong in the hosting provider, not in the kit.
`kits.lock` v2 records each service separately. Use `add <library> --service web`
to target a service; `update` preserves the topology and updates existing services.
Old v1 projects are not automatically restructured into workspaces.
© Marlon-Chaviano · MIT · Marlon-Chaviano/first-commit