use-coding-agents skill
✓ 인증됨설치된 코딩 에이전트 CLI를 오케스트레이션 워크플로 내에서 교체 가능한 헤드리스 서브 에이전트로 사용합니다.
- GitHub 스타
- 28
- 파일
- 2
- 마지막 커밋
- 2026년 11월 11일
- 라이선스
- MIT
- 허용된 도구
- —
use-coding-agents skill은 무엇을 하나요?
설치된 코딩 에이전트 CLI를 오케스트레이션 워크플로 내에서 교체 가능한 헤드리스 서브 에이전트로 사용합니다.
skill의 SKILL.md에서 생성된 요약입니다.
use-coding-agents skill 정보
복잡한 오케스트레이션 루프를 구축하는 개발자는 이 SKILL을 사용하여 설치된 코딩 에이전트 CLI를 교체 가능한 헤드리스 작업자로 활용할 수 있습니다. droid mission이나 hermes delegation과 같은 특정 도구의 내장 오케스트레이션 기능에 의존하는 대신, 이 SKILL은 '프롬프트 입력, 결과 출력'이라는 단순한 계약으로 기능을 축소합니다. 이를 통해 중앙 오케스트레이터는 가용성이나 비용에 따라 어떤 작업자를 실행할지 결정하며 여러 에이전트를 동시에 관리할 수 있습니다.
이 SKILL은 claude, codex, droid, grok, opencode, pi를 포함한 다양한 에이전트를 지원합니다. 프롬프트를 전달하고 주로 JSON 형식을 통해 기계 판독 가능한 결과를 캡처함으로써 이러한 도구의 실행을 관리합니다. 안전을 보장하고 파일 충돌을 방지하기 위해 각 작업자에 대한 워크트리 또는 특정 디렉토리 격리 사용을 권장합니다. dark-factory 또는 bughunt와 같은 대규모 오케스트레이션 프레임워크 내에서 사용하도록 설계되었으며, 전문화된 코딩 에이전트 군단에 작업을 분산할 수 있습니다.
agent가 수행할 수 있는 작업
- 1코딩 작업 분산여러 독립적인 코딩 단위를 서로 다른 에이전트에 동시에 배포하여 개발 속도를 높입니다.
- 2헤드리스 에이전트 실행워크플로를 간소화하기 위해 auto-approve 플래그를 사용하여 대화형 프롬프트 없이 코딩 에이전트를 실행합니다.
- 3중단된 에이전트 작업 재개처음부터 다시 시작하는 대신 누락된 정보를 제공하여 이전에 차단된 에이전트 작업을 계속합니다.
- 4에이전트 비용 최적화토큰 사용량을 절약하기 위해 간단한 작업에는 에이전트의 더 작고 저렴한 모델 변형을 실행합니다.
skill의 SKILL.md를 기반으로 작성되었습니다. 모든 사용 사례는 해당 문서의 인용구와 대조 확인되었습니다.
use-coding-agents skill 설치 방법
각 명령은 skill 폴더를 클라이언트의 skills 디렉터리에 복사합니다. 클라이언트를 재시작하거나 새 세션을 시작하여 로드하세요.Claude Code에 use-coding-agents skill 설치
~/.claude/skills/use-coding-agents/SKILL.md
$ npx degit av/skills/use-coding-agents ~/.claude/skills/use-coding-agentsClaude Code (project)에 use-coding-agents skill 설치
.claude/skills/use-coding-agents/SKILL.md
$ npx degit av/skills/use-coding-agents .claude/skills/use-coding-agentsCodex에 use-coding-agents skill 설치
~/.agents/skills/use-coding-agents/SKILL.md
$ npx degit av/skills/use-coding-agents ~/.agents/skills/use-coding-agentsGemini CLI에 use-coding-agents skill 설치
~/.gemini/skills/use-coding-agents/SKILL.md
$ npx degit av/skills/use-coding-agents ~/.gemini/skills/use-coding-agentsClaude.ai에 use-coding-agents skill 설치
npx degit av/skills/use-coding-agents use-coding-agents && zip -r use-coding-agents.zip use-coding-agents # claude.ai → Customize → Skills → + → Create skill → Upload a skill → use-coding-agents.zip
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 보안 감사는 아닙니다. 에이전트가 실행하기 전에 스크립트를 읽어 보세요. 검사 방식
- 소스 저장소 연결 및 접근 가능av/skills/use-coding-agents is public and reachablegithub.com/av/skills/tree/HEAD/use-coding-agents ↗통과
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit 2026-11-11github.com/av/skills/commits ↗통과
- 스크립트에 다운로드 후 실행이나 자격 증명 탈취가 없음No scripts in the skill folder통과
- SKILL.md에 숨겨진 지침 없음No override phrases, safeguard switches, credential requests or hidden charactersgithub.com/av/skills/blob/HEAD/use-coding-agents/SKILL.md ↗통과
- 사전 허용 도구가 제한됨No pre-approved tools; the agent asks before using onegithub.com/av/skills/blob/HEAD/use-coding-agents/SKILL.md ↗통과
- SKILL.md가 Agent Skills 형식을 따름Valid name and description; says when to use it; 178 linesgithub.com/av/skills/blob/HEAD/use-coding-agents/SKILL.md ↗통과
SKILL.md
GitHub에서 보기Use Coding Agents — Installed CLIs as Plain Sub-agents
Re-run <agent> --help before relying on any flag not listed here.
Principle
Every agent here is a worker: it receives a prompt, edits files in one directory, commits, prints a result, exits. Nothing more.
- Do not use the CLIs' own orchestration features. No
droid --mission, no codexmulti_agent, no hermesdelegate_task/moa/kanban, nogrok --agents, no opencode personas. Those are unvalidated here, spend tokens invisibly, and hide state from the orchestrator. - The orchestrator is the session running this skill (normally claude via the Agent tool or a orchestration skill). It plans units, writes prompts, launches workers, reads short results.
- Workers are interchangeable. Pick by availability and cost, not by feature.
Workers
| Agent | Invocation | Auto-approve | Status 2026-09-04 |
|---|---|---|---|
| claude | claude -p "<prompt>" |
--dangerously-skip-permissions |
PASS |
| codex | codex exec "<prompt>" (or prompt on stdin) |
--dangerously-bypass-approvals-and-sandbox |
PASS |
| droid | droid exec "<prompt>" |
--skip-permissions-unsafe (not with --auto) |
PASS |
| grok | grok -p "<prompt>" |
--always-approve |
PASS |
| grokc | COLORTERM=truecolor grokc -p "<prompt>" |
built in (podman, $PWD only) |
PASS |
| opencode | opencode run "<prompt>" |
--auto (without it a permission prompt hangs a headless run) |
PASS (default model now openrouter/~anthropic/claude-sonnet-latest) |
| pi | pi -p "<prompt>" |
none needed | PASS, local model, slow |
| hermes | hermes -z "<prompt>" --in <dir> |
--yolo |
FLAKY: write_file fails (DaemonThreadPoolExecutor ... _initializer); 1262 commits behind |
| copilot | copilot -p "<prompt>" -s |
--allow-all |
FAIL: no auth; needs interactive /login |
Facts from --help: grok 1.0.13 has no --check / --best-of-n; droid rejects --auto together
with --skip-permissions-unsafe; hermes restores the previous session's cwd unless --in is given.
Getting the result back
| Agent | Machine-readable result |
|---|---|
| claude | --output-format json (with -p) |
| codex | -o <file> writes the last message; --json for JSONL events |
| droid | -o json |
| grok | --output-format json, or --json-schema '<schema>' |
| opencode | --format json |
| pi | --mode json |
Simplest contract, works everywhere: tell the worker to write its output to a file and print one
line DONE|BLOCKED|FAILED <reason>. Read the file, not the transcript.
Cheaper / capped variants (validated)
Use when a unit is small. Same worker, fewer tokens:
- claude:
--model haiku --max-turns N(do not add--bareor--setting-sources ""; both drop auth) - codex:
-c model_reasoning_effort=low(minimalis rejected) - droid:
-r low -m claude-haiku-4-5-20251001 - grok:
--max-turns N --no-subagents --disable-web-search - opencode:
--variant minimal - pi:
--thinking off
Listing and picking models
Validated 2026-09-04. Pass the id with the agent's model flag (--model / -m).
| Agent | List available models | Default today | Flag |
|---|---|---|---|
| claude | no list command; aliases fable, opus, sonnet, haiku or a full id like claude-fable-5-1 |
account default | --model |
| codex | codex debug models (JSON catalog, 9 entries: gpt-5.6-sol/terra/luna, gpt-5.5, gpt-5.4, gpt-5.4-mini, gpt-5.3-codex-spark, …) |
gpt-5.6-sol (~/.codex/config.toml) |
-m |
| droid | no list command; /model in the TUI. Custom/local models are the customModels entries in ~/.factory/settings.json (ollama qwen3, glm-4.7-flash, kimi-k2.7-code, …) |
gpt-5.6-sol |
-m |
| grok | grok models (7 entries, grok-4.6 default, grok-4.5, …) |
grok-4.6 |
-m |
| opencode | opencode models (379 entries as provider/model; openrouter/~anthropic/... ids need the tilde) |
openrouter/~anthropic/claude-sonnet-latest (control/config/opencode.jsonc) |
-m |
| pi | pi --list-models [search] (table with context/max-out/thinking columns) |
harbor-llamacpp Qwen3-Coder-Next Q8 (~/.pi/agent/settings.json) |
--model |
| hermes | hermes model (interactive picker; --refresh re-fetches each provider's /v1/models); hermes config get model prints the default |
deepseek/deepseek-v4-flash-0731 via nous |
-m |
| copilot | no list command; /model in the TUI |
account default | --model |
Isolation
Two workers must never write the same file in the same tree. Use a worktree per worker:
claude -w <name>, droid -w <name>, grok -w <name>, hermes --worktree; for codex, opencode,
copilot, pi run git worktree add first and cd into it. (Worktree flags checked in --help only.)
Resume instead of restart
claude --resume <id>, codex exec resume --last, droid exec -s <id>, grok -r <id>,
hermes --resume <s>, opencode run -s <id>, copilot --continue, pi -c. Resume a BLOCKED
worker with the missing fact rather than re-dispatching cold.
Fan-out pattern
d=$(mktemp -d /tmp/orch-<slug>-XXXX)
cat > "$d/preamble.md" <<'P'
You are working on <project> at <code_path>.
Read CLAUDE.md / AGENTS.md / README.md first if present.
Commit with clear messages when done. Do not ask questions.
Do not start or reinstall opencode.service; the OpenCode daemon is retired.
Write your result to <unit_file> and print ONLY one line: DONE|BLOCKED|FAILED <reason>.
Before DONE, compare your diff and the observed result with the unit's Acceptance. If only a
proxy passed (tests, a build, a plan) or a gate is still open, print BLOCKED and name what is unmet.
After a tool error, do the next step it names before calling that tool again (table in
~/.agents/skills/use-coding-agents/SKILL.md, "Error → next step"). Never resend the same failing call.
P
cat > "$d/unit-1.md" <<'U'
Task: <what to do>
Acceptance:
- Deliver: <artifact or path>
- Scope: may change <paths>; must not touch <paths>
- Proof: <command or observation in the target environment>, not a proxy
- Gates: <checks and approvals to wait for; stop at a withheld one>
- Report: <format>
U
cd <code_path>
mkdir -p $d/cache-{1..5} # one writable cache per worker; a shared /tmp cache breaks gh
XDG_CACHE_HOME=$d/cache-1 claude -p "$(cat $d/preamble.md $d/unit-1.md)" --dangerously-skip-permissions > $d/1.log 2>&1 &
XDG_CACHE_HOME=$d/cache-2 codex exec --dangerously-bypass-approvals-and-sandbox < <(cat $d/preamble.md $d/unit-2.md) > $d/2.log 2>&1 &
XDG_CACHE_HOME=$d/cache-3 droid exec --skip-permissions-unsafe -f <(cat $d/preamble.md $d/unit-3.md) > $d/3.log 2>&1 &
XDG_CACHE_HOME=$d/cache-4 grok -p "$(cat $d/preamble.md $d/unit-4.md)" --always-approve -w unit-4 > $d/4.log 2>&1 &
XDG_CACHE_HOME=$d/cache-5 opencode run "$(cat $d/preamble.md $d/unit-5.md)" --auto > $d/5.log 2>&1 &
wait; tail -n1 $d/*.log
Prompts live on disk and are dispatched by path. The orchestrator authors nothing itself
(same discipline as timeboxed-iterating).
Acceptance contract
Every unit prompt carries the Acceptance: block above, filled in. A unit without it is not
ready to dispatch. Read a DONE against the same block, not against the worker's summary.
When the user corrects a result, rewrite the unit's Acceptance: from the correction before
resuming or re-dispatching; the worker's first line restates what changed and what will prove it.
Error → next step
Repeat calls after an error that already said why were the main avoidable cost in long runs.
| Error | Next step, before calling the tool again |
|---|---|
Claude Edit: file has not been read |
Read that exact path (a shell cat does not count), then Edit |
Edit: old string not found |
re-read that region, copy the exact text |
Claude Bash rejects sleep N; <status> |
Monitor with an until loop, or run_in_background |
| droid Bash times out at 60 s | keep every wait under 60 s; poll in steps |
command not found (e.g. dstask) |
command -v <tool> once; absent → switch tools (Backlog.md for tasks) |
gh: cache permission denied |
export XDG_CACHE_HOME=$(mktemp -d /tmp/cache-XXXX), retry once |
| guessed path does not exist | one rg --files | rg <name>, then use what it finds |
| skill path does not exist | skills live at ~/.agents/skills/<name>/SKILL.md; ls ~/.agents/skills once |
Rules
- Plain workers only. If you reach for a CLI's mission / delegation / persona feature, stop and fan out from the orchestrator instead.
- One unit, one directory, one commit per worker. Merge worktrees afterwards.
- Logs under
/tmpor the scratchpad, never in the repo. - Cap loops with
--max-turnswhere it exists, otherwise a turn budget in the prompt. - Bypass flags only in a worktree, in
grokc, or in a repo you cangit reset. - Backlog.md stays human. Workers do not touch
backlog/tasks/. - Smoke tests are one word. Validate a recipe with "Reply with the single word OK." only.
- Shared machines: your home only. Never read or change another user's sessions, worktrees, agent configs or keys. Shared installs are an admin task.
- Do not invent flags. Not in this file → run
--helpand paste the real one.
Related skills
overnight— dispatch approved work items to these workers in the backgroundtimeboxed-iterating,workgraph,workmachine,gauntlet,dark-factory,bughunt— orchestration loops that use these workers
이 스킬의 파일
2use-coding-agents skill 질문
Claude Code에 use-coding-agents skill을 어떻게 설치하나요?
npx degit av/skills/use-coding-agents ~/.claude/skills/use-coding-agents를 실행합니다. Claude Code는 ~/.claude/skills(모든 프로젝트) 또는 .claude/skills(한 프로젝트)에서 skills를 로드하며, 설명이 작업과 일치할 때 skill을 사용합니다.
use-coding-agents skill을 사용할 수 있는 클라이언트는 무엇인가요?
Agent Skills 형식을 읽는 모든 클라이언트(Claude Code, Codex, Gemini CLI, claude.ai(ZIP으로 업로드))가 사용할 수 있습니다. skill 내 스크립트는 클라이언트가 코드 실행을 허용하는 경우에만 실행됩니다.
워크플로에서 코딩 에이전트 CLI를 어떻게 사용해야 하나요?
에이전트의 내장 오케스트레이션 기능을 의도적으로 무시하고, 하나의 프롬프트를 입력하여 하나의 결과를 얻는 단순 작업자(worker) 방식으로 사용하십시오.
작업자 간의 간섭을 방지하려면 어떻게 해야 하나요?
각 작업자가 동일한 트리 내의 같은 파일에 쓰지 않도록 전용 워크트리(worktree) 또는 디렉토리를 사용해야 합니다.
에이전트로부터 기계 판독 가능한 결과를 얻는 가장 좋은 방법은 무엇인가요?
가장 간단한 방법은 작업자에게 출력을 파일로 작성하도록 지시하고, DONE|BLOCKED|FAILED와 같은 단일 상태 라인을 출력하도록 하는 것입니다.