My Skill
Brief description of the skill's purpose, capabilities, and intended audience.
Authentication
Describe how credentials are obtained and configured.
export MY_API_KEY="your-key-here"
Quick Start
Script-backed execution
Place executable scripts in scripts/. The tool name maps to the script:
underscores in the tool name become hyphens in the filename.
Example: tool my_search → scripts/my-search.sh
./scripts/my-search.sh '{"query": "hello"}'
Binary-backed execution
If the skill delegates to a compiled binary instead, delete the scripts/
directory entirely and document the binary in requires.bins above.
Tool: my_tool
Short description of what this tool does.
Input:
| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | yes | The search query |
| max_results | integer | no | Maximum results (1-20). Default: 5 |
Output: JSON object with results array of {title, url, content, score}.
Response Format
{
"results": [
{
"title": "Example",
"url": "https://example.com",
"content": "Relevant snippet...",
"score": 0.95
}
]
}
Tips
- Tip 1 for effective usage
- Tip 2 for edge cases
Safety Constraints
Document any safety rules this skill enforces (read-only, no secrets, etc.).