← All skills

MCP Tool Design

87 / 100 · Low risk

Fine to try.

By diegosouzapw/awesome-omni-skill (GitHub) · design · 66 stars · scanned at commit a6b3c30

This skill should be used when the user asks to "define a tool", "create tool schema", "design inputSchema", "add tool annotations", "handle file uploads", "tool descriptions", "tool naming", or needs guidance on designing MCP tools for the OpenAI Apps SDK including schemas, annotations, and best practices.

Works with any agent that supports SKILL.md skills.

What this skill can do

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'mcp-tool-design' ] || [ -L ~/.agents/skills/'mcp-tool-design' ]; then echo 'A skill folder named mcp-tool-design already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/diegosouzapw/awesome-omni-skill' "$d" && git -C "$d" checkout --quiet 'a6b3c3005cedf056a48b084671c6282426d6e9fc' -- 'skills/design/mcp-tool-design' && mkdir -p ~/.agents/skills && cp -R "$d"/'skills/design/mcp-tool-design' ~/.agents/skills/'mcp-tool-design' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'mcp-tool-design' ~/.claude/skills/'mcp-tool-design' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for diegosouzapw/awesome-omni-skill shows the score of its lowest-scoring skill.

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/diegosouzapw/awesome-omni-skill.svg)](https://zalavijaysinh.github.io/skilltrust/repos/diegosouzapw/awesome-omni-skill/)

Score history