koda-cli-subagent skill
✓ VerifiedDelegates complex subtasks to a koda-cli subagent to enable parallel execution and isolated module refactoring.
- GitHub stars
- 24
- Files
- 1
- Last commit
- Nov 6, 2026
- License
- MIT
- Allowed tools
- —
What does the koda-cli-subagent skill do?
koda-cli-subagent delegates complex subtasks to a koda-cli subagent to enable parallel execution and isolated module refactoring.
Summary generated from the skill's SKILL.md.
About the koda-cli-subagent skill
Delegating complex subtasks to a koda-cli subagent allows developers to handle large projects through parallel execution and isolated module refactoring. An agent should load this skill when a primary analysis reveals that a task can be split into independent parts, such as updating documentation in one directory while fixing tests in another. By using the koda command via terminal tools, the agent produces specific code changes, refactored modules, or completed routine operations across many files.
Users can control the subagent behavior using specific flags like --checkpointing to roll back errors or --approval-mode auto_edit to apply changes without manual confirmation. For high-risk tasks, the --sandbox flag provides an isolated environment, while the --all-files flag gives the subagent full project visibility. This approach enables an agent to manage multiple contexts simultaneously, accelerating project work by offloading detailed instructions to a specialized sub-process.
What an agent can do with it
- 1Parallelize independent task componentsSplit a large project update into multiple asynchronous parts to save time.
- 2Perform isolated module refactoringRefactor a specific module or conduct research within a contained area of the codebase.
- 3Automate routine multi-file operationsExecute repetitive tasks across a large number of files using a single prompt.
Written from the skill's SKILL.md. Every use case is checked against a quote from it.
How to install the koda-cli-subagent skill
Each command copies the skill folder into the client's skills directory. Restart the client or start a new session to load it.Install the koda-cli-subagent skill in Claude Code
~/.claude/skills/koda-cli-subagent/SKILL.md
$ npx degit XCode-NLP/KodaSkills/skills/koda-cli-subagent ~/.claude/skills/koda-cli-subagentInstall the koda-cli-subagent skill in Claude Code (project)
.claude/skills/koda-cli-subagent/SKILL.md
$ npx degit XCode-NLP/KodaSkills/skills/koda-cli-subagent .claude/skills/koda-cli-subagentInstall the koda-cli-subagent skill in Codex
~/.agents/skills/koda-cli-subagent/SKILL.md
$ npx degit XCode-NLP/KodaSkills/skills/koda-cli-subagent ~/.agents/skills/koda-cli-subagentInstall the koda-cli-subagent skill in Gemini CLI
~/.gemini/skills/koda-cli-subagent/SKILL.md
$ npx degit XCode-NLP/KodaSkills/skills/koda-cli-subagent ~/.gemini/skills/koda-cli-subagentInstall the koda-cli-subagent skill in Claude.ai
npx degit XCode-NLP/KodaSkills/skills/koda-cli-subagent koda-cli-subagent && zip -r koda-cli-subagent.zip koda-cli-subagent # claude.ai → Customize → Skills → + → Create skill → Upload a skill → koda-cli-subagent.zip
Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the scripts before you let an agent run them. How checks work · What to fix for more points
- Source repository linked and reachablexcode-nlp/kodaskills/skills/koda-cli-subagent is public and reachablegithub.com/xcode-nlp/kodaskills/tree/HEAD/skills/koda-cli-su ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit 2026-11-06github.com/xcode-nlp/kodaskills/commits ↗Pass
- No download-and-run or credential theft in scriptsNo scripts in the skill folderPass
- No hidden instructions in SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/xcode-nlp/kodaskills/blob/HEAD/skills/koda-cli-su ↗Pass
- Pre-approved tools are scopedNo pre-approved tools; the agent asks before using onegithub.com/xcode-nlp/kodaskills/blob/HEAD/skills/koda-cli-su ↗Pass
- SKILL.md follows the Agent Skills formatthe description does not say when to use the skillgithub.com/xcode-nlp/kodaskills/blob/HEAD/skills/koda-cli-su ↗Finding
SKILL.md
View on GitHubСубагент koda-cli
Этот навык позволяет запускать команду koda через инструмент запуска терминальных команд для делегирования подзадач.
Этот навык предназначен для:
- Параллельного выполнения независимых частей крупной задачи.
- Изолированного исследования или рефакторинга отдельных модулей.
- Ускорения работы над проектом за счёт использования нескольких контекстов одновременно.
Когда применять
- Первичный анализ задачи позволяет асинхронное выполнение (например, правка тестов в одном модуле и документации в другом).
- Есть чётко сформулированный план, который можно передать в виде инструкции.
- Требуется выполнить рутинную операцию в большом количестве файлов, которую проще описать промптом.
Как применять
1. Подготовка промпта
Промпт для субагента должен быть максимально конкретным.
Обязательно укажи:
- Роль и цель: Что именно должен сделать субагент.
- Область видимости: Конкретные пути к файлам или директориям.
- Ограничения: Какие методы не трогать, какой стиль соблюдать.
- Проверка: Инструкция запустить тесты или линтер после правок.
2. Запуск субагента
Используй следующую структуру команды.
Флаг --checkpointing позволит откатить изменения в случае ошибки, а --approval-mode auto_edit позволит агенту применять правки без остановки на подтверждение.
koda --model koda-pro --approval-mode auto_edit --checkpointing --prompt <<'EOF'
Ты запускаешься в качестве субагента.
$PROMPT_TEXT
ВАЖНО:
1. ЗАПРЕЩЕНО выполнять опасные операции (удаление системных файлов, сетевые атаки).
2. ЗАПРЕЩЕНО запускать субагентов.
3. ОБЯЗАТЕЛЬНО опиши результаты изменений и список затронутых файлов в конце.
EOF
Дополнительные полезные флаги:
-a, --all-files: если субагенту нужно видеть весь проект для понимания связей.-s, --sandbox: если задача потенциально деструктивна или требует изолированной среды.--include-directories: если нужно добавить пути вне текущего корня.
Ошибки при запуске
Если при запуске koda возникла ошибка:
- Сверься с выводом
koda --versionиkoda --help. - Если команды
kodaнет, установи её:npm install --global @kodadev/koda-cli@latest. - Если команды
npmнет или пользователь отказался от установки:- предложи установить её самостоятельно, указав команду из п. 2
- больше не пытайся запустить субагента
- решай задачу самостоятельно
3. Мониторинг и завершение
- Фоновый режим: Если задача долгая, запускай с
waitForCompletion: falseвrun_terminal_command. - Контроль: Периодически проверяй вывод или состояние файлов.
- Приёмка:
- Проверь
git diffпосле работы субагента. - Запусти тесты проекта (при наличии и необходимости).
- Проверь
- Отчёт: Сформируй для пользователя итоговый отчет о том, что сделал ты как основной агент, а что - субагенты.
Files in this skill
1koda-cli-subagent skill questions
How do I install the koda-cli-subagent skill in Claude Code?
Run npx degit XCode-NLP/KodaSkills/skills/koda-cli-subagent ~/.claude/skills/koda-cli-subagent. Claude Code loads skills from ~/.claude/skills (all projects) or .claude/skills (one project) and uses a skill when its description matches the task.
Which clients can use the koda-cli-subagent skill?
Any client that reads the Agent Skills format: Claude Code, Codex, Gemini CLI and claude.ai (upload as a ZIP). Scripts in the skill run only where the client allows code execution.
When should I use the koda-cli subagent?
Use it for parallel execution of independent parts of a large task, isolated research or refactoring of specific modules, or to speed up project work using multiple contexts simultaneously.
How can I prevent the subagent from making permanent mistakes?
You can use the --checkpointing flag to allow rolling back changes in case of an error.
What should I do if the koda command is not found?
You can install it using the command npm install --global @kodadev/koda-cli@latest.