mediar-ai/packages/skills/skills/tool-design
packages/skills/skills/tool-design/SKILL.md
# Tool Design for Agents Design tools that agents can effectively discover, understand, and use. ## Prerequisites - Understanding of agent architectures - API design experience ## Instructions ### Core Principle Tool descriptions are **prompt engineering** that shapes agent behavior. Poor design creates failure modes no prompt engineering can fix. ### Consolidation Principle If a human engineer cannot definitively say which tool to use, an agent cannot either. Prefer single comprehensive
$ install --global
skillsauthnpx skillsauth add mediar-ai/skillhubz packages/skills/skills/tool-designInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 19, 2026, 4:25 AM16.2s2 files scanned
SKILL.md
Tool Design for Agents
Design tools that agents can effectively discover, understand, and use.
Prerequisites
- Understanding of agent architectures
- API design experience
Instructions
Core Principle
Tool descriptions are prompt engineering that shapes agent behavior. Poor design creates failure modes no prompt engineering can fix.
Consolidation Principle
If a human engineer cannot definitively say which tool to use, an agent cannot either. Prefer single comprehensive tools over multiple narrow tools.
Instead of: list_users, list_events, create_event Use: schedule_event (handles full workflow)
Description Requirements
Answer four questions:
- What does it do? (Clear, specific)
- When should it be used? (Triggers and contexts)
- What inputs does it accept? (Types, constraints, defaults)
- What does it return? (Format, examples, errors)
Architectural Reduction
Production evidence shows removing specialized tools often improves performance.
Vercel d0: 17 tools → 2 (bash + SQL), 80% → 100% success.
When reduction works:
- Data layer is well-documented
- Model has sufficient reasoning
- Tools were constraining, not enabling
Response Format Options
def get_customer(id: str, format: str = "concise"):
"""
format: "concise" for key fields, "detailed" for complete
"""
Error Message Design
Errors must be actionable for agents:
- What went wrong
- How to correct it
- Retry guidance if applicable
MCP Tool Naming
Always use fully qualified names:
"Use the BigQuery:bigquery_schema tool..." # Correct
"Use the bigquery_schema tool..." # May fail
Guidelines
- Write descriptions answering what, when, inputs, returns
- Use consolidation to reduce ambiguity
- Implement response format options
- Design errors for agent recovery
- Limit to 10-20 tools; use namespacing if more needed
- Prefer primitive tools over specialized wrappers
- Build minimal architectures that benefit from model improvements
Notes
- 10-20 tools reasonable for most applications
- Tool description overlap causes model confusion
- Use agents to optimize their own tool descriptions
Source: muratcankoylan/Agent-Skills-for-Context-Engineering
Related Skills
mediar-ai/valet
tools
VerifiedTrustedCommunity
Use when the user wants to manage Valet agents, channels, connectors, organizations, or environment variables (secrets and plain config) via the valet CLI. Handles creation, deployment, linking, teardown, and all multi-step workflows. Also use when asked to "create an agent", "deploy an agent", "design an agent", "build me an agent that...", "create a connector", "set up a webhook", or anything involving the Valet platform or any request to create and deploy AI agents. Also use when asked to "learn from this session", "capture this workflow", "save this as an agent", "make this repeatable", or when writing SOUL.md files.
8SKILL.mdUpdated Aug 25, 2026
mediar-ai/valet-publish
tools
VerifiedTrustedCommunity
Publish files, folders, and artifacts to the web. Static hosting for HTML sites, images, PDFs, reports, dashboards, and any file type. Use when asked to publish, host, upload, serve, or share work at a live URL. Also use to propose a rendered page when a report, comparison, chart, design document, or status page would work better than terminal text, but do not create or update a remote site until the user asks or agrees. Account publishing gives a permanent, private-by-default URL visible to org members; --anonymous gives a temporary public URL with no account. Use the valet CLI when available and its MCP server when the CLI cannot run. For deploying an AI agent rather than static files, use the `valet` skill instead.
8SKILL.mdUpdated Aug 25, 2026
mediar-ai/packages/skills/skills/faceless-so
testing
VerifiedTrustedCommunity
# Faceless.so Turn a script, prompt, Reddit post, or blog into a Remotion short with TTS, captions, and B-roll, then auto-post to YouTube, TikTok, Instagram, X, Facebook, LinkedIn, and Threads. ## Prerequisites - A Faceless.so account (from $24/mo) at https://faceless.so - Source material: script, prompt, Reddit URL, or blog URL - Destination social accounts to auto-post (YouTube, TikTok, Instagram, X, Facebook, LinkedIn, Threads) ## Instructions 1. Open https://faceless.so and start a new
8SKILL.mdUpdated Aug 25, 2026
mediar-ai/packages/skills/skills/bimi-svg-tiny-p-s-corpus-validator
testing
VerifiedTrustedCommunity
# BIMI SVG Tiny P/S Corpus Validator Use the public makeBIMI SVG Tiny P/S Test Corpus to evaluate an SVG against its evidence-bound fixture rules and to report the result clearly. ## Inputs Accept either an SVG file, an SVG URL, or raw SVG markup. If the source cannot be retrieved or parsed as XML, stop and report that limitation. ## Authoritative corpus 1. Retrieve the current manifest from `https://makebimi.com/public/test-corpus/v1/manifest.json`. 2. Record `schema_version`, `corpus_vers
8SKILL.mdUpdated Aug 25, 2026