minimum-viable — скилл для Claude Code: проверка перед кодом
Заставляет агента обосновать выбор инструмента и сложность до того, как он напишет первую строку. Простой вариант побеждает, если нет конкретной причины его не брать.
npx skills add ferrumclaudepilgrim/claude-code-android --skill minimum-viable -a claude-codeЧто делает minimum-viable
Скилл прогоняет агента через шесть вопросов перед началом работы. Что именно строится — одним предложением. Какая реализация самая простая: скрипт, один файл, несколько команд в конвейере, запись в cron, git-хук. Почему простого не хватит — нужна конкретная причина, а не «не будет масштабироваться». Если причина не формулируется, агент останавливается на простом варианте.
Дальше идут язык, фреймворк и каждая зависимость с обоснованием, проверка что они установлены и работают на текущей ОС и архитектуре, и оценка стоимости поддержки. Правило решения простое: на третий вопрос нет ответа — строим простую версию и на этом всё. Есть ответ — идём тяжёлым путём, но причину записывают в комментарий или README, чтобы следующий человек понял, откуда взялась сложность. Если зависимость не проверена, её ставят до начала работы или меняют подход.
Скилл вызывается вручную и читает файлы, глоб-шаблоны, grep и команды оболочки — править код он не станет. Аргумент — то, что вы собираетесь построить. Полезен на проектах, где агент любит разворачивать фреймворк ради задачи на двадцать строк: здесь это придётся защищать словами.
Какие задачи решает
- Остановить агента, который тянет фреймворк ради задачи на пару десятков строк
- Проверить, что зависимость вообще работает на вашей ОС и архитектуре, до старта
- Записать причину, по которой в проекте появилась сложная конструкция
- Свести задачу к одному файлу или git-хуку вместо отдельного сервиса
- Оценить, кто будет чинить сборку после обновления зависимости
Примеры запросов агенту
- Проверь по minimum-viable, что я собираюсь строить: парсер логов с уведомлениями в Telegram
- Прогони минимум-проверку для вебхука, который принимает заявки с формы
- Прежде чем писать код, обоснуй выбор инструмента для этой задачи
Как установить minimum-viable
1Через Skills CLI (Vercel)
npx skills add ferrumclaudepilgrim/claude-code-android --skill minimum-viable -a claude-code2Вручную: положить файлы
~/.claude/skills/minimum-viable/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/minimum-viable/
1Через Skills CLI (Vercel)
npx skills add ferrumclaudepilgrim/claude-code-android --skill minimum-viable -a codex2Вручную: положить файлы
.agents/skills/minimum-viable/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ferrumclaudepilgrim/claude-code-android --skill minimum-viable -a cursor2Вручную: положить файлы
.cursor/skills/minimum-viable/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ferrumclaudepilgrim/claude-code-android minimum-viable2Вручную: положить файлы
.github/skills/minimum-viable/SKILL.md1Через Skills CLI (Vercel)
npx skills add ferrumclaudepilgrim/claude-code-android --skill minimum-viable -a gemini-cli2Командой платформы
gemini skills install https://github.com/ferrumclaudepilgrim/claude-code-android --path .claude/skills/minimum-viableВручную: положить файлы
.devin/skills/minimum-viable/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ferrumclaudepilgrim/claude-code-android --skill minimum-viable -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о minimum-viable
Как установить minimum-viable в Claude Code?
Выполните npx skills add ferrumclaudepilgrim/claude-code-android --skill minimum-viable -a claude-code. Файл скилла окажется по пути ~/.claude/skills/minimum-viable/SKILL.md.
Что делает скилл minimum-viable?
Задаёт шесть вопросов о задаче, самой простой реализации, причине её не брать, зависимостях и стоимости поддержки. Пока нет конкретного ответа на третий вопрос, агент строит простой вариант.
Чем он отличается от обычного планирования?
Планирование описывает, как сделать. Здесь сначала нужно доказать, что тяжёлый путь вообще нужен, и записать причину в комментарий или README.
Исходный текст
SKILL.md · MIT
--- name: minimum-viable description: Before building anything, justify the tool choice and complexity level. Could a shell script do this? Does it need Node.js? A full application? Prevents over-engineering by requiring explicit justification before choosing a heavier approach. user-invocable: true disable-model-invocation: false argument-hint: "<what you're about to build>" allowed-tools: Read, Bash, Glob, Grep --- # Minimum Viable Implementation Check Answer every question before writing any code. If the simple version is sufficient, build that. Document why only if you choose a heavier approach. ## Required Questions **1. What are you building?** One sentence. If you cannot describe it in one sentence, the scope is not defined yet. **2. What is the simplest possible implementation?** Usually: a shell script, a single file, a few commands piped together, a cron entry, a git hook. Describe it. Estimate the line count. **3. Why is the simple version insufficient?** State a concrete reason. Not "it won't scale" but "it cannot handle binary data" or "it requires a persistent HTTP connection." If you cannot state a concrete reason, build the simple version. **4. What is the proposed implementation?** If you are not building the simple version: name the language, framework, and every dependency. Justify each one. **5. Are dependencies available and working on this platform?** For each dependency: is it installed? Does it work on the current OS and architecture? Have you verified this, or are you assuming? Check before committing to an approach. **6. What is the maintenance cost?** Will this break when a dependency updates? Who fixes it? If the answer is "whoever is here then," that is a cost. Weight it against the benefit of the heavier approach. ## Decision Rule - If question 3 has no answer: build the simple version, stop here. - If question 3 has an answer: proceed with the proposed implementation, but document the reason in a comment or README so the next person knows why the complexity exists. - If question 5 reveals a missing dependency: verify availability before starting, or redesign to avoid it.
© ferrumclaudepilgrim · MIT · ferrumclaudepilgrim/claude-code-android