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.).