agent-tool-builder
신뢰할 수 있는 에이전트 툴 스키마 구축
잘못 설계된 툴 스키마는 에이전트의 환각(hallucination), 조용�� 실패, 토큰 낭비를 일으킵니다. 이 스킬은 명확하고 모호하지 않�� 함수 호출 인터페이스를 위한 검증된 패턴을 가르쳐 안정적으로 작동하게 만듭니다.
스킬 ZIP 다운로드
Claude에서 업로드
설정 → 기능 → 스킬 → 스킬 업로드로 이동
토글을 켜고 사용 시작
테스트해 보기
"agent-tool-builder" 사용 중입니다. A tool that searches a database with vague description: 'Searches for things'
예상 결과:
Improved: 'Searches the products database by category, price range, or keyword. Returns matching product records with id, name, price, and availability. Use when users ask about specific products or browse categories.'
"agent-tool-builder" 사용 중입니다. Tool that fails silently on invalid input
예상 결과:
Enhanced error handling: Returns structured error with 'error_type': 'invalid_parameter', 'field': 'price_max', 'message': 'Value must be positive number', 'suggestion': 'Check user input and retry with valid price'
보안 감사
안전This skill is purely documentation providing guidance on agent tool design. Static analyzer flagged false positives: line 54 contains skill names (not shell commands), and cryptographic warnings matched keywords in prose (no actual code present). No executable code exists in this markdown file - it is instructional content only.
품질 점수
만들 수 있는 것
사용자 정의 에이전트 툴 구축
데이터베이스 쿼리, API 통합, 파일 연산 등 에이전트가 수행해야 하는 도메인별 작업을 위한 툴 스키마를 설계하세요.
기존 함수 호출 개선
명확한 스키마 설계 원칙을 적용하여 환현이나 일관성 없는 동작을 일으키는 성능이 낮은 툴을 개선하세요.
MCP 툴 통합 구현
에이전트가 외부 시스템과 안전하고 예측 가능하게 상호작용할 수 있도록 Model Context Protocol 준수 툴을 만드세요.
이 프롬프트를 사용해 보세요
Review this tool schema and identify ambiguous descriptions or parameters that could cause inconsistent LLM behavior: [paste your schema]
Design error response formats for a [tool name] that help the LLM understand what went wrong and how to recover or retry with corrected parameters.
Rewrite this tool description to be more specific about what the tool does, when to use it, and what outputs to expect: [paste current description]
I need an agent to [describe goal]. Design a minimal set of 3-5 tools with clear schemas, descriptions, and example inputs that accomplish this without overlap or ambiguity.
모범 사례
- Write descriptions that specify exactly when to use the tool and what it returns
- Include concrete input examples showing typical parameter values
- Design error responses that help the LLM understand and recover from failures
- Limit tool sets to the minimum needed - too many options cause confusion
- Use specific parameter names and types that match the domain vocabulary
피하기
- Vague descriptions like 'processes data' or 'handles requests' without specifics
- Silent failures that return empty results instead of explicit error messages
- Providing 20+ tools when 5-7 focused tools would be more effective
- Schemas that accept any value without validation constraints
- Descriptions that explain implementation instead of purpose and behavior