mcpField
D
devtu-code-optimization

devtu-code-optimization

github.com/mims-harvardDevelopment1.8k268 installsUpdated 2d ago
Repository

About devtu-code-optimization

A code-optimization skill for ToolUniverse development and maintenance, with a pre-commit checklist, categorized issue patterns, and API and code references.

Key features

  1. 01Pre-commit checklist
  2. 02Common issues grouped by signal
  3. 03API fix references
  4. 04Reusable code patterns
  5. 05Git and PR workflow guidance

Use cases

  1. 01Review ToolUniverse changes before committing
  2. 02Diagnose tool output or schema issues
  3. 03Fix API calls and exception handling

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/mims-harvard/tooluniverse --skill devtu-code-optimization

After installing, type/devtu-code-optimizationin Claude Code to confirm it loaded.

Bundled filesreferences/api-fixes.mdreferences/code-patterns.md

Details

From the project README

ToolUniverse Code Optimization

Always run Skill(skill="simplify") after writing or modifying code.

Pre-Commit Checklist

  • return_schema has oneOf: [{data+metadata}, {error}]
  • Test examples use real IDs (no DUMMY/PLACEHOLDER)
  • try: has except: at exact same indentation level
  • No trailing commas in JSON (python3 -c "import json; json.load(open('f.json'))")
  • New tool class registered in _lazy_registry_static.py and default_config.py
  • ruff check src/tooluniverse/<file>.py passes
  • python -c "from tooluniverse.<module> import <Class>" passes
  • python -m tooluniverse.cli run <Tool> '<real_args_json>' returns expected data
  • Ran Skill(skill="simplify") on all modified files

Key Fix Categories

CategorySignalReference
Silent param ignoredAPI accepts but drops filtercode-patterns.md — Client-Side Filter
Wrong API field/endpoint0 results or 404api-fixes.md — Quick Lookup Table
Schema invalidnull type, missing oneOfcode-patterns.md — Schema Patterns
Undisclosed normalizationAuto-transform hidden from usercode-patterns.md — Normalization Disclosure
try/except indentSyntaxError at runtimecode-patterns.md — try/except section
Truncation buriedData count hidden in notescode-patterns.md — Truncation
Hosted model API (NIM)async 404 on poll, JSON-wrapped output, 200+inner-failure, "not found for account"code-patterns.md — Hosted Model-API Tools
R subprocess tool'\.' unrecognized escape from Rscript -ecode-patterns.md — R-subprocess Tools

References

Git & PR Workflow

git fetch origin && git stash && git rebase origin/main && git stash pop
git push --force-with-lease origin fix/round-XX-bugs
gh pr view <N> --json mergeable  # must be MERGEABLE before done
  • Never push to main directly
  • Never have multiple open fix PRs
  • Commit messages: "Feature" or "Fix" — never "Bug"
  • No AI attribution in commits
  • Repo: mims-harvard/ToolUniverse — verify with git remote -v

Comments

Markdown supported