project-min-evaluation — скилл для Claude Code: проверки перед
Заставляет агента прогнать линтер, типы и тесты проекта, прежде чем объявить работу готовой. Полезен, когда не хочется ловить поломки после коммита.
npx skills add C3SC0-V4113/Scaffold --skill project-min-evaluation -a claude-codeЧто делает project-min-evaluation
Скилл включается на словах «готово», «завершил», «перед коммитом», «проверь качество». Агент читает package.json и локфайлы, определяет менеджер пакетов и запускает только те скрипты, которые реально объявлены в scripts. Порядок жёсткий: lint, typecheck, format:check, test, doctor, check. Скрипт test:e2e трогает лишь тогда, когда менялось поведение сквозных сценариев.
Менеджер не зашит в скилл. Есть поле packageManager — берётся названный там; иначе смотрят на pnpm-lock.yaml, bun.lock или bun.lockb, а при package-lock.json и полном отсутствии сигналов остаётся npm. На первом падении выполнение останавливается: сначала починка, потом повтор с упавшего шага. Пропустить красную проверку, чтобы дойти до следующей, нельзя.
В отчёте каждый скрипт помечается как пройденный, упавший или не определённый. Для сбоя приводятся точная команда, текст ошибки и та часть, что осталась непроверенной. Если в проекте нет, скажем, typecheck, скилл сообщит об отсутствии ожидаемого скрипта и не станет придумывать команду. Это и есть главный смысл: молчание агента о непройденной проверке — повод переспросить.
Какие задачи решает
- прогнать линтер и типы перед коммитом
- остановиться на первой упавшей проверке и не идти дальше
- определить менеджер пакетов по локфайлам проекта
- отчитаться, какие скрипты не объявлены в
package.json - не объявлять задачу готовой при красных тестах
Примеры запросов агенту
- прогони минимальные проверки проекта перед коммитом
- готово, проверь качество по скриптам из package.json
- запусти lint, typecheck и test, начни с упавшего
Как установить project-min-evaluation
1Через Skills CLI (Vercel)
npx skills add C3SC0-V4113/Scaffold --skill project-min-evaluation -a claude-code2Вручную: положить файлы
~/.claude/skills/project-min-evaluation/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/project-min-evaluation/
1Через Skills CLI (Vercel)
npx skills add C3SC0-V4113/Scaffold --skill project-min-evaluation -a codex2Вручную: положить файлы
.agents/skills/project-min-evaluation/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add C3SC0-V4113/Scaffold --skill project-min-evaluation -a cursor2Вручную: положить файлы
.cursor/skills/project-min-evaluation/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install C3SC0-V4113/Scaffold project-min-evaluation2Вручную: положить файлы
.github/skills/project-min-evaluation/SKILL.md1Через Skills CLI (Vercel)
npx skills add C3SC0-V4113/Scaffold --skill project-min-evaluation -a gemini-cli2Командой платформы
gemini skills install https://github.com/C3SC0-V4113/Scaffold --path skills/project-min-evaluationВручную: положить файлы
.devin/skills/project-min-evaluation/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add C3SC0-V4113/Scaffold --skill project-min-evaluation -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Из того же набора2
Похожие
Рядом в теме «Настройка агента: память, контекст, субагенты»
Все скиллы по теме «Настройка агента: память, контекст, субагенты» →Вопросы о project-min-evaluation
Как установить project-min-evaluation в Claude?
Выполните npx skills add C3SC0-V4113/Scaffold --skill project-min-evaluation -a claude-code. Файл скилла окажется в ~/.claude/skills/project-min-evaluation/SKILL.md.
Что делает project-min-evaluation?
Перед отчётом о завершённой работе запускает скрипты качества из package.json в заданном порядке и останавливается на первой ошибке.
Какие скрипты он запускает?
lint, typecheck, format:check, test, doctor и check — если они объявлены. test:e2e только при изменениях в сквозных сценариях.
Исходный текст
SKILL.md · Apache-2.0
--- name: project-min-evaluation description: "Trigger: done, complete, finish, before commit, quality check, verify. Run the project's own minimum quality scripts before claiming work is complete." license: Apache-2.0 metadata: author: purrfold version: "1.0" --- # Project Minimum Evaluation ## Activation Contract Load this skill before reporting implementation work as complete, before committing, or when asked to verify quality. ## Hard Rules 1. Detect the package manager from the project; never hardcode a runner. 2. Run only scripts defined in `package.json` `scripts`; report expected scripts that are missing instead of inventing commands. 3. Run from the repository root, in the order below, and do not skip a failing step to reach a later one. 4. Never claim completion while a check fails or was not run. ## Decision Gates | Project signal | Runner | | --- | --- | | `packageManager` field in `package.json` | use the manager it names | | `pnpm-lock.yaml` | `pnpm run <script>` | | `bun.lock` or `bun.lockb` | `bun run <script>` | | `package-lock.json`, or no other signal | `npm run <script>` | | Script | Run when | | --- | --- | | `lint` | always, if defined | | `typecheck` | always, if defined | | `format:check` | always, if defined | | `test` | always, if defined | | `doctor` | always, if defined | | `check` | always, if defined (aggregate gate) | | `test:e2e` | only when end-to-end behavior changed | ## Execution Steps 1. Read `package.json` and the lockfiles to choose the runner. 2. Collect the scripts from the table that exist in `scripts`. 3. Run each existing script in table order with the chosen runner. 4. Stop at the first failure, fix it, and rerun from that script. ## Output Contract Report each script as passed, failed, or not defined. For a failure or a check that cannot run, give the exact command, the exact error, and the unverified scope. ## References - [references/script-discovery.md](references/script-discovery.md) — detection edge cases.
© purrfold · Apache-2.0 · C3SC0-V4113/Scaffold