My Skill

Brief description of the skill's purpose, capabilities, and intended audience.

Authentication

Describe how credentials are obtained and configured.

bash
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

bash
./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

json
{
  "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.).