OpenParable
Skip to content
← Back to skills

Devtu Code Optimization

Development
devtu-code-optimization

Devtu Code Optimization is an Agent Skill for development published in the mims-harvard/ToolUniverse repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Code quality patterns and guidelines for ToolUniverse tool development. Apply when writing, fixing, or refactoring tool Python code in the ToolUniverse project. Encodes lessons from 80+ debug rounds. Use alongside devtu-fix-tool and devtu-self-evolve. Triggers: implementing tool fixes, writing new tool classes, reviewing tool code quality, checking schema correctness, looking up API-specific bug fixes.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/mims-harvard/ToolUniverse/blob/HEAD/skills/devtu-code-optimization/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/devtu-code-optimization, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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