mims-harvard avatar

Devtu Optimize Descriptions

This walks through ToolUniverse JSON configs and flags descriptions that will confuse users. It checks for missing prerequisites, unexpanded abbreviations like H5AD or TSS, unclear required versus optional parameters, and mutually exclusive options that need numbering. The checklist is thorough, maybe overly so, but it catches real problems like filter parameters that don't explain available fields or parameters that don't explain trade-offs. Run this when you're adding new tools or when someone asks if their API documentation makes sense. The examples are bioinformatics-heavy, which shows where this came from, but the patterns apply to any tool configuration that needs to be self-explanatory.

skills.sh installs
385
GitHub stars
1.8K
last updated
Aug 21, 2026

Install

$ npx -y skills add mims-harvard/tooluniverse --skill devtu-optimize-descriptions --agent claude-code

Installs into .claude/skills of the current project.

Files

This walks through ToolUniverse JSON configs and flags descriptions that will confuse users. It checks for missing prerequisites, unexpanded abbreviations like H5AD or TSS, unclear required versus optional parameters, and mutually exclusive options that need numbering. The checklist is thorough, maybe overly so, but it catches real problems like filter parameters that don't explain available fields or parameters that don't explain trade-offs. Run this when you're adding new tools or when someone asks if their API documentation makes sense. The examples are bioinformatics-heavy, which shows where this came from, but the patterns apply to any tool configuration that needs to be self-explanatory.

Browse the repository on GitHub

Sponsors

Details

Repository
github.com/mims-harvard/tooluniverse
Categories
Backend & APIs, Documentation
First seen
Jun 3, 2026

More from mims-harvard/tooluniverse

All 68
1openclaudia avatargoogle-reviewsopenclaudia/openclaudia-skillsFetch Google review ratings and review counts for businesses via DataForSEO API. Use when the user asks to check Google reviews, get review counts, compare busi384skills.sh installs
2sanjay3290 avatarnotebooklmsanjay3290/ai-skillsQuery and manage Google NotebookLM notebooks with persistent profile auth, source sync, batch/multi queries, and structured exports. Use when user asks to query384skills.sh installs
3mims-harvard avatardevtu-auto-discover-apismims-harvard/tooluniverseAutomatically discover life science APIs online, create ToolUniverse tools, validate them, and prepare integration PRs. Performs gap analysis to identify missin383skills.sh installs
4syncfusion avatarsyncfusion-blazor-securitysyncfusion/blazor-ui-components-skillsConfigure Content Security Policy (CSP) for Syncfusion Blazor components across Blazor Server, WebAssembly, and Auto render modes � self-hosted and CDN scenario382skills.sh installs
5alirezarezvani avatarcaio-reviewalirezarezvani/claude-skills/cs:caio-review <plan> — Eval-demanding Chief AI Officer interrogation of any plan that involves AI: model selection, risk classification, cost economics, or AI378skills.sh installs
6mrgoonie avatarweb-frameworksmrgoonie/claudekit-skillsBuild modern full-stack web applications with Next.js (App Router, Server Components, RSC, PPR, SSR, SSG, ISR), Turborepo (monorepo management, task pipelines, 377skills.sh installs