flora131 avatar

Tool Design

This is prompt engineering for tool APIs, treating descriptions as direct inputs to agent reasoning rather than documentation for humans. The core insight is solid: if you can't definitively say which tool an agent should pick in a situation, the agent won't either. It pushes you to consolidate overlapping tools and write descriptions that answer what, when, and what returns, since those are exactly the questions agents evaluate during selection. The consolidation principle alone will save you from a lot of confusing multi-tool scenarios. Worth reading if you're debugging why agents keep picking the wrong tools or if you're designing APIs that LLMs will call directly.

skills.sh installs
164
GitHub stars
234
last updated
Jun 3, 2026

Install

$ npx -y skills add flora131/atomic --skill tool-design --agent claude-code

Installs into .claude/skills of the current project.

Files

This is prompt engineering for tool APIs, treating descriptions as direct inputs to agent reasoning rather than documentation for humans. The core insight is solid: if you can't definitively say which tool an agent should pick in a situation, the agent won't either. It pushes you to consolidate overlapping tools and write descriptions that answer what, when, and what returns, since those are exactly the questions agents evaluate during selection. The consolidation principle alone will save you from a lot of confusing multi-tool scenarios. Worth reading if you're debugging why agents keep picking the wrong tools or if you're designing APIs that LLMs will call directly.

Browse the repository on GitHub

Sponsors

Details

Repository
github.com/flora131/atomic
Category
Design & UI/UX
First seen
Jun 3, 2026

More from flora131/atomic

All 39
1borghei avatarapi-design-reviewerborghei/claude-skillsReview REST API designs for quality, consistency, and breaking changes. Lints OpenAPI specs, generates scorecards, and detects breaking changes between versions163skills.sh installs
2sickn33 avatarddd-strategic-designsickn33/antigravity-awesome-skillsddd strategic design163skills.sh installs
3absolutelyskilled avatarapi-designabsolutelyskilled/absolutelyskilledapi design162skills.sh installs
4absolutelyskilled avatarsystem-designabsolutelyskilled/absolutelyskilledsystem design155skills.sh installs
5jabrena avatar121-java-object-oriented-designjabrena/cursor-rules-java121 java object oriented design153skills.sh installs
6sickn33 avatardomain-driven-designsickn33/antigravity-awesome-skillsdomain driven design153skills.sh installs