devtu-optimize-descriptions
Audits tool descriptions to ensure prerequisites, parameters, and usage are clear.
Install
mkdir -p .claude/skills/devtu-optimize-descriptions && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/6038" && unzip -o skill.zip -d .claude/skills/devtu-optimize-descriptions && rm skill.zipInstalls to .claude/skills/devtu-optimize-descriptions
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Optimize tool descriptions in ToolUniverse JSON configs for clarity and usability. Reviews descriptions for missing prerequisites, unexpanded abbreviations, unclear parameters, and missing usage guidance. Use when reviewing tool descriptions, improving API documentation, or when user asks to check if tools are easy to understand.Key capabilities
- →Review tool descriptions for missing prerequisites
- →Expand abbreviations in tool descriptions
- →Clarify required input requirements for tools
- →Enhance filter parameter descriptions with syntax and examples
- →Improve parameter guidance with trade-offs and recommendations
- →Number mutually exclusive options in tool descriptions
How it works
The skill provides a checklist and specific instructions for improving tool descriptions in JSON configuration files. It details how to clarify inputs, add prerequisites, expand abbreviations, and enhance parameter guidance.
Inputs & outputs
When to use devtu-optimize-descriptions
- →Auditing tool configuration files
- →Improving technical documentation
- →Clarifying API usage in tool definitions
About devtu-optimize-descriptions
Reviews JSON configuration files to identify missing prerequisites, unclear parameters, and vague descriptions. It ensures documentation is consistent and actionable for end users.
Optimize tool descriptions in ToolUniverse JSON configs for clarity and usability. Reviews descriptions for missing prerequisites, unexpanded abbreviations, unclear parameters, and missing usage guidance. Use when reviewing tool descriptions, improving API documentation, or when user asks to check if tools are easy to understand.
How it compares
This skill offers a structured approach with concrete examples for optimizing tool descriptions, providing more specific guidance than a general documentation review.
Compared to similar skills
devtu-optimize-descriptions side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| devtu-optimize-descriptions (this skill) | 1 | 8mo | Review | Beginner |
| docs-write | 22 | 9mo | No flags | Beginner |
| content-research-writer | 15 | 1y | No flags | Beginner |
| doc-coauthoring | 16 | 11mo | No flags | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by mims-harvard
View all by mims-harvard →You might also like
docs-write
metabase
Write documentation following Metabase's conversational, clear, and user-focused style. Use when creating or editing documentation files (markdown, MDX, etc.).
content-research-writer
ComposioHQ
Assists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section. Transforms your writing process from solo effort to collaborative partnership.
doc-coauthoring
anthropics
Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.
research-grants
davila7
Write competitive research proposals for NSF, NIH, DOE, and DARPA. Agency-specific formatting, review criteria, budget preparation, broader impacts, significance statements, innovation narratives, and compliance with submission requirements.
teams-channel-post-writer
daymade
Creates educational Teams channel posts for internal knowledge sharing about Claude Code features, tools, and best practices. Applies when writing posts, announcements, or documentation to teach colleagues effective Claude Code usage, announce new features, share productivity tips, or document lessons learned. Provides templates, writing guidelines, and structured approaches emphasizing concrete examples, underlying principles, and connections to best practices like context engineering. Activates for content involving Teams posts, channel announcements, feature documentation, or tip sharing.
write-docs
tldraw
Writing SDK documentation for tldraw. Use when creating new documentation articles, updating existing docs, or when documentation writing guidance is needed. Applies to docs in apps/docs/content/.