Create high-quality ToolUniverse skills following test-driven, implementation-agnostic methodology.

Create ToolUniverse Skill Systematic workflow for creating production ready ToolUniverse skills. Core Principles Build on the 10 pillars from devtu optimize skills : 1. TEST FIRST never document untested tools 2. Verify tool contracts don't trust function names 3. Handle SOAP tools add operation parameter 4. Implementation agnostic docs no Python/MCP code in SKILL.md 5. Foundation first query aggregators before specialized tools 6. Disambiguate carefully resolve IDs properly 7. Implement fallbacks Primary Fallback Default 8. Grade evidence T1 T4 tiers on claims 9. Quantified completeness numeric minimums per section 10. Synthesize models and hypotheses, not just lists See OPTIMIZE INTEGRATION.md for detailed application of each pillar. 7 Phase Workflow Phase Duration Description 1. Domain Analysis 15 min Understand use cases, data types, analysis phases 2. Tool Discovery 30 45 min Search, read configs, test tools (MANDATORY) 3. Tool Creation 0 60 min Create missing tools via devtu create tool 4. Implementation 30 45 min Write python implementation.py with tested tools 5. Documentation 30 45 min Write SKILL.md (agnostic) + QUICK START.md 6. Validation 15 30 min Run test suite, validate checklist, manual verify 7. Packaging 15 min Create summary, update tracking Total : ~1.5 2 hours (without tool creation). Phase 1: Domain Analysis Gather concrete use cases and expected outputs Identify inputs, outputs, and intermediate data types Break workflow into logical phases Review existing skills in skills/ for patterns Phase 2: Tool Discovery and Testing Search tools in /src/tooluniverse/data/ .json (186 tool files). For each tool, read its config to understand parameters and return schema. See PARAMETER VERIFICATION.md for common pitfalls. Create and run a test script using test tools template.py . For each tool: call with known good params, verify response format, document corrections. See TESTING GUIDE.md for the full test suite template and procedures. Phase 3: Tool Creation (If Needed) Invoke devtu create tool when required functionality is missing and analysis is blocked. Use devtu fix tool if new tools fail tests. Phase 4: Implementation Create skills/tooluniverse [domain]/ with: python implementation.py use only tested tools, try/except per phase, progressive report writing test skill.py test each input type, combined inputs, error handling Use templates from CODE TEMPLATES.md . Phase 5: Documentation Write implementation agnostic SKILL.md using SKILL TEMPLATE.md . Write multi implementation QUICK START.md using QUICKSTART TEMPLATE.md . Key rules: zero Python/MCP code in SKILL.md, equal treatment of both interfaces in QUICK START. See IMPLEMENTATION AGNOSTIC.md for format guidelines with examples. Phase 6: Validation Run the comprehensive test suite (see TESTING GUIDE.md ). Validate against VALIDATION CHECKLIST.md . Perform manual verification: load ToolUniverse fresh, copy paste QUICK START example, verify output works. Phase 7: Packaging Create summary document using PACKAGING TEMPLATE.md . Update session tracking if creating multiple skills. Skill Integration Skill When to Use devtu create tool Critical functionality missing devtu fix tool Tool returns errors or unexpected format devtu optimize skills Evidence grading, report optimization Quality Indicators High quality : 100% test coverage before docs, agnostic SKILL.md, multi implementation QUICK START, fallback strategies, parameter corrections table, response format docs. Red flags : Docs before testing, Python in SKILL.md, assumed parameters, no fallbacks, SOAP tools missing operation , no test script. Reference Files File Content SKILL TEMPLATE.md Template for writing SKILL.md QUICKSTART TEMPLATE.md Template for writing QUICK START.md TESTING GUIDE.md Test suite template and procedures VALIDATION CHECKLIST.md Pre release quality checklist PACKAGING TEMPLATE.md Summary document template PARAMETER VERIFICATION.md Tool parameter verification guide OPTIMIZE INTEGRATION.md devtu optimize skills 10 pillar integration IMPLEMENTATION AGNOSTIC.md Implementation agnostic format guide with examples CODE TEMPLATES.md Python implementation and test templates test tools template.py Tool testing script template

create-tooluniverse-skill