Tool Design 스킬
입력, 출력, 선택 조건과 복구 가능한 오류를 명시한 에이전트 도구 계약을 설계합니다.
커뮤니티 · Muratcan Koylan| 작성자 | Muratcan Koylan |
|---|---|
| 라이선스 | MIT |
| 소스 | muratcankoylan/Agent-Skills-for-Context-Engineering · GitHub의 SKILL.md |
| 작동 환경 | Claude Code · Codex, Gemini CLI, Cursor, Copilot |
| 소스 확인 날짜 |
tool-design 스킬은 에이전트와 호출 가능한 도구 사이의 인터페이스를 개선합니다.
각 도구를 계약으로 다뤄 선택 시점, 입력, 출력과 오류 복구를 정의합니다. 도구 백엔드는 구현하지 않습니다.
스킬의 SKILL.md에서: ## Gotchas
하는 일
- 겹치는 이름과 모호한 설명을 검토합니다.
- 매개변수, 응답 형식과 오류 복구를 정의합니다.
- 의도한 도구를 선택하고 사용하는지 테스트합니다.
얻을 수 있는 결과물
- 도구 계약, 수정된 설명과 검증 계획.
이럴 때 사용하세요
- 잘못된 도구를 선택하거나 유효하지 않은 인수를 반복 제공할 때.
이럴 때는 맞지 않습니다
- 전체 시스템 구조를 결정하거나 관련 없는 작업을 거대한 도구에 합치는 용도.
필요한 것
- 파일 지원 에이전트와 실제 도구 스키마, 동작, 실패 사례가 필요합니다.
- Python 생성기는 템플릿과 휴리스틱 점수를 사용하며 실제 도구 선택 개선을 증명하지 않습니다.
스킬에 들어 있는 파일
| 파일 또는 폴더 | 용도 |
|---|---|
SKILL.md | 도구 계약 지침, 예제와 설계 함정. |
references/best_practices.md | Python 설명 생성기와 설계 및 통합 참고 자료. |
scripts/description_generator.py | Python 설명 생성기와 설계 및 통합 참고 자료. |
2026-11-20 기준 저장소에 있는 라이선스: MIT.
예시 프롬프트
설치한 뒤 아래 중 하나를 입력해 보세요. 스킬 이름을 넣으면 그 스킬이 확실히 사용됩니다.
- 기본값과 복구 가능한 오류를 명시해 이 계약을 다시 써 주세요.
- 통합 제안 전에 겹치는 도구 이름을 검토해 주세요.
- 동일한 검색에 간략 응답과 상세 응답을 설계해 주세요.
tool-design 설치 방법
참고 자료와 예제 보존
전체 폴더를 복사하세요. 플러그인은 모음을 설치하므로 단일 스킬만 원하면 폴더 설치를 사용하세요.
문서와 Python 템플릿은 외부 서비스가 필요 없습니다. 실제 테스트에는 본인의 에이전트와 도구 구현이 필요합니다. 호스팅 업로드와 API 실행은 미검증입니다.
스킬은 SKILL.md 파일이 든 폴더입니다. 한 번만 설치하면, 에이전트가 세션을 시작할 때마다 짧은 설명을 읽고 요청이 맞을 때만 전체 지침을 불러옵니다. 사용하는 곳을 고르세요.
Claude Code: 플러그인 마켓플레이스에서 설치
- 터미널에서
claude로 Claude Code를 시작합니다. - 마켓플레이스를 추가합니다(컴퓨터마다 한 번):
/plugin marketplace add muratcankoylan/Agent-Skills-for-Context-Engineering - 플러그인을 설치합니다. Claude Code가 먼저 세부 정보를 보여 줍니다. 무엇이 추가되는지(스킬, 훅, MCP 서버) 확인한 다음, 나만 쓸지, 이 저장소의 모든 사람이 쓸지, 이 저장소에서 나만 쓸지 고르세요.
/plugin install context-engineering@context-engineering-marketplace - /를 입력해
/context-engineering:tool-design가 있는지 확인하거나, 그냥 작업을 요청하세요.
세션 대신 셸에서 설치하려면:
claude plugin marketplace add muratcankoylan/Agent-Skills-for-Context-Engineering
claude plugin install context-engineering@context-engineering-marketplace플러그인은 통째로 설치되므로 context-fundamentals, context-degradation, context-compression, context-optimization, self-managed-context, multi-agent-patterns, long-horizon-prompting, memory-systems, filesystem-context, hosted-agents, evaluation, advanced-evaluation, harness-engineering, project-development, bdi-mental-states, latent-briefing, self-improvement-loops 등 다른 스킬도 함께 설치됩니다.
Claude Code: 스킬 폴더에 복사
이 컴퓨터의 모든 프로젝트에서 쓰려면 스킬 폴더를 ~/.claude/skills/에 넣고, 저장소에서 함께 작업하는 모든 사람과 공유하려면 저장소 안의 .claude/skills/에 넣으세요(커밋하세요).
git clone --depth 1 https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering.git
mkdir -p ~/.claude/skills
cp -R Agent-Skills-for-Context-Engineering/skills/tool-design ~/.claude/skills/Claude Code는 세션 중에도 이 폴더의 새 스킬이나 변경된 스킬을 알아챕니다. 세션을 시작할 때 skills 폴더가 없었다면 /reload-skills를 한 번 실행하세요. 그런 다음 /tool-design를 입력하거나 작업을 설명하면 됩니다.
Windows에서는 Git Bash나 WSL에서 명령어를 실행하거나, 파일 탐색기로 같은 위치에 폴더를 복사하세요.
Codex, Gemini CLI, Cursor, GitHub Copilot
이 에이전트들은 같은 SKILL.md 폴더를 읽습니다. 네 가지 모두가 프로젝트 안에서 인식하는 폴더는 .agents/skills/이므로, 아래 명령은 스킬을 그곳에 복사합니다.
git clone --depth 1 https://github.com/muratcankoylan/Agent-Skills-for-Context-Engineering.git
mkdir -p .agents/skills
cp -R Agent-Skills-for-Context-Engineering/skills/tool-design .agents/skills/| 에이전트 | 프로젝트 폴더 | 사용자 폴더 | 참고 |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | $를 입력하거나 /skills를 실행해 스킬을 고르세요. 작업이 맞으면 Codex가 스스로 스킬을 고르기도 합니다. |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | 또는 gemini skills install <git URL> --path <folder> --consent로 Git에서 설치하세요. Google은 2026년 6월 18일 무료 등급과 Google One 사용자의 Gemini CLI를 Antigravity CLI로 대체했습니다. Antigravity는 프로젝트에서는 .agents/skills/를, 사용자용으로는 ~/.gemini/config/skills/를 사용합니다. |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | Agent 채팅에서 /를 입력해 스킬을 고르세요. Cursor는 Claude Code의 .claude/skills/ 폴더도 읽습니다. |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | Copilot CLI, 클라우드 에이전트, 그리고 VS Code, Visual Studio, JetBrains의 에이전트 모드에서 작동합니다(IDE 지원은 버전에 따라 다름). 또는 gh skill install OWNER/REPOSITORY SKILL를 실행하세요(공개 프리뷰, GitHub CLI 2.90.0 이상). |
이 단계의 출처
2026-11-14에 각 업체의 문서와 대조해 확인했습니다:
다음 행동을 돕는 계약
이름과 설명은 실제 후보를 구별해야 합니다. 기본값, 입력 제약과 출력 구조를 명시하세요.
작업에 따라 간략 또는 상세 출력을 제공하세요. 오류는 맹목적 재시도보다 수정 행동을 가능하게 해야 합니다.
실제 작업으로 통합 검증
도구 수 감소는 설계 선택이지 성능 보장이 아닙니다. 같은 작업에서 성공, 인수 오류와 복구를 비교하세요.
생성기는 설명 초안을 만들지만 휴리스틱으로 백엔드, 권한이나 에이전트 이해를 검증할 수는 없습니다.
tool-design에 관한 질문
MCP 서버를 만들어 주나요?
아닙니다. 계약을 안내하며 전송, 인증과 백엔드 실행은 별도로 구현해야 합니다.
모든 도구를 통합해야 하나요?
아닙니다. 겹치는 작업만 필요에 따라 합치고 다른 작업은 분리한 뒤 인터페이스를 테스트하세요.
오류 응답에 무엇을 담아야 하나요?
민감한 세부사항을 노출하지 않고 실패 원인과 재시도 전 바꿔야 할 입력이나 상태를 설명합니다.
예제 점수가 에이전트 성능 실측인가요?
아닙니다. 텍스트 패턴과 메타데이터를 검사합니다. 대표 실행으로 선택과 복구를 검증하세요.
더 많은 AI 스킬
관련 스킬
Dev-Browser 스킬
커뮤니티 · Sawyer Hood상태를 유지하는 이름 있는 페이지, Puppeteer 스크립트와 로컬 CLI 서비스로 Chrome을 자동화합니다.Agent Evaluation 스킬
커뮤니티 · Muratcan Koylan결정적 검사, 독립된 품질 차원과 버전 관리 기준선으로 에이전트 회귀 테스트를 계획합니다.Context Degradation 스킬
커뮤니티 · Muratcan Koylan검증된 사실과 작업별 비교를 통해 긴 컨텍스트 오류를 진단하고 복구를 계획합니다.Advanced Evaluation 스킬
커뮤니티 · Muratcan Koylan근거 기반 평가표, 순서를 바꾼 비교와 사람 보정으로 LLM 심사자를 설계합니다.Brainstorming 스킬
커뮤니티 · Jesse Vincent / Prime Radiant구현 전에 초기 아이디어를 합의된 설계로 정리합니다.Writing Plans 스킬
커뮤니티 · Jesse Vincent / Prime Radiant승인 설계를 인터페이스와 검증이 있는 검토 가능한 작업으로 전환합니다.