This is a systematic debugger for ToolUniverse framework tools that fail tests or throw errors. It walks through verification, diagnosis, and fixes for common patterns like JSON parsing errors on binary responses, schema mismatches when the data wrapper is missing, and nullable field validation failures. The approach is opinionated about root cause fixes over workarounds, like validating parameters upfront instead of adding helpful error messages after the fact. It includes a lookup table showing exactly which files to edit for each issue type and emphasizes verifying bugs via CLI before fixing them, since many agent reported bugs are false positives from MCP interface confusion. Useful when dealing with schema validation hell or flaky API integrations in the ToolUniverse ecosystem.

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

Install

$ npx -y skills add mims-harvard/tooluniverse --skill devtu-fix-tool --agent claude-code

Installs into .claude/skills of the current project.

Files

This is a systematic debugger for ToolUniverse framework tools that fail tests or throw errors. It walks through verification, diagnosis, and fixes for common patterns like JSON parsing errors on binary responses, schema mismatches when the data wrapper is missing, and nullable field validation failures. The approach is opinionated about root cause fixes over workarounds, like validating parameters upfront instead of adding helpful error messages after the fact. It includes a lookup table showing exactly which files to edit for each issue type and emphasizes verifying bugs via CLI before fixing them, since many agent reported bugs are false positives from MCP interface confusion. Useful when dealing with schema validation hell or flaky API integrations in the ToolUniverse ecosystem.

Browse the repository on GitHub

Sponsors

Details

Repository
github.com/mims-harvard/tooluniverse
Categories
Testing & QA, Debugging
First seen
Jun 3, 2026

More from mims-harvard/tooluniverse

All 68
1pproenca avatarrails-hotwirepproenca/dot-skillsRuby on Rails Hotwire best practices for building interactive applications with Turbo Drive, Turbo Frames, Turbo Streams, Turbo 8 morphing, and Stimulus control380skills.sh installs
2galaxy-dawn avatardoc-coauthoringgalaxy-dawn/claude-scholarThis skill should be used when the user asks to co-author documentation, draft a proposal, write a technical spec, create a decision doc or RFC, or structure a 377skills.sh installs
3pmprompt avataropportunity-solution-treespmprompt/claude-plugin-product-managementUse when asked to "opportunity solution tree", "OST", "Teresa Torres", "map customer opportunities to outcomes", "structure discovery around opportunities", or 376skills.sh installs
4levnikolaevich avatarln-780-bootstrap-verifierlevnikolaevich/claude-code-skillsVerifies bootstrapped projects via build, test, and container health checks. Use when validating project setup completeness.375skills.sh installs
5kernel avatarkernel-python-sdkkernel/skillsBuild and debug Python browser automation with the Kernel SDK, including browser lifecycle, server-side Playwright, CDP, profiles, proxies, and reliable cleanup373skills.sh installs
6levnikolaevich avatarln-740-quality-setuplevnikolaevich/claude-code-skillsSets up linters, pre-commit hooks, and test infrastructure. Use when adding code quality tooling to a project.372skills.sh installs