mims-harvard/devtu-code-optimization
skills/devtu-code-optimization/SKILL.md
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.
$ install --global
skillsauthnpx skillsauth add mims-harvard/tooluniverse devtu-code-optimizationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jul 22, 2026, 6:26 AM309.2s3 files scanned
SKILL.md
- name:
- devtu-code-optimization
- description:
- >
- Triggers:
- implementing tool fixes, writing new tool classes, reviewing tool code quality,
ToolUniverse Code Optimization
Always run Skill(skill="simplify") after writing or modifying code.
Pre-Commit Checklist
- [ ]
return_schemahasoneOf: [{data+metadata}, {error}] - [ ] Test examples use real IDs (no DUMMY/PLACEHOLDER)
- [ ]
try:hasexcept: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.pyanddefault_config.py - [ ]
ruff check src/tooluniverse/<file>.pypasses - [ ]
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
| Category | Signal | Reference |
|---|---|---|
| Silent param ignored | API accepts but drops filter | code-patterns.md — Client-Side Filter |
| Wrong API field/endpoint | 0 results or 404 | api-fixes.md — Quick Lookup Table |
| Schema invalid | null type, missing oneOf | code-patterns.md — Schema Patterns |
| Undisclosed normalization | Auto-transform hidden from user | code-patterns.md — Normalization Disclosure |
| try/except indent | SyntaxError at runtime | code-patterns.md — try/except section |
| Truncation buried | Data count hidden in notes | code-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 -e | code-patterns.md — R-subprocess Tools |
References
- references/api-fixes.md — Per-API bug fixes (GtoPdb, CIViC, GTEx, ENCODE, CPIC, etc.)
- references/code-patterns.md — Reusable Python patterns (schema, filtering, pagination, normalization)
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
maindirectly - Never have multiple open fix PRs
- Commit messages: "Feature" or "Fix" — never "Bug"
- No AI attribution in commits
- Repo:
mims-harvard/ToolUniverse— verify withgit remote -v
Related Skills
mims-harvard/tooluniverse-self-review
tools
VerifiedTrustedCommunity
Generate the success criteria for a task or question, then review work against them. Given a task, goal, or open-ended question, decompose it into scenarios, evaluation perspectives, and fine-grained weighted YES/NO criteria using the Recursive Expansion Tree (RET) method; if work is supplied, score it criterion-by-criterion and surface what is missing or could be better. Use when asked to self-review or check your own work, judge whether a task is done well or completely, build a definition-of-done or completeness checklist, create an evaluation rubric or grading criteria, score or grade answers to a question, set up an LLM-as-judge rubric, or when the user mentions self-review, completeness check, success criteria, evaluation criteria, scoring rubric, Qworld, or the RET algorithm.
1,583SKILL.mdUpdated Jul 22, 2026
mims-harvard/tooluniverse-peptide-target-deorphanization
tools
VerifiedTrustedCommunity
Find the real protein target(s) of a peptide from its sequence — peptide target deorphanization / off-target identification, for ANY target class (GPCR, ion channel, protease, cytokine/growth-factor receptor, enzyme, integrin), not only GPCRs. Use when a peptide has a phenotype but does not bind its hypothesized target, when a peptide binds a target in one species or assay but not another, or to screen candidate targets for an orphan peptide. A target-class router steers a multi-route keyless pipeline (PROSITE/ELM motif, BLAST homology, HGNC/InterPro/GPCRdb/GtoPdb target-family enumeration, OpenTargets phenotype anchor, EnsemblCompara/Alliance cross-species reconciliation) plus optional NVIDIA-NIM co-folding (Boltz2, AlphaFold2-Multimer, OpenFold3) for structural confirmation.
1,583SKILL.mdUpdated Jul 22, 2026
mims-harvard/tooluniverse-cs-setup
tools
VerifiedTrustedCommunity
Install or update ToolUniverse in Claude Science — create the conda env, install the tooluniverse pip package, and (re)build the tooluniverse-research skill by fetching the current workflow library from GitHub. Use for first-time setup, upgrading the ToolUniverse version, refreshing the bundled workflows after an upstream release, or reinstalling on a new machine.
1,583SKILL.mdUpdated Jul 22, 2026
mims-harvard/tooluniverse-codex-plugin
tools
VerifiedTrustedCommunity
Install, set up, verify, update, pin, uninstall, or troubleshoot the ToolUniverse plugin on OpenAI Codex. ALWAYS consult this skill for any of those — don't answer from memory, because the exact marketplace name (mims-harvard/ToolUniverse), the "codex plugin marketplace add" then "codex plugin add -m tooluniverse" flow, Codex's startup auto-upgrade behavior, the uvx tooluniverse MCP server, and the API-key env vars are easy to get wrong. Use it whenever someone wants to get ToolUniverse (or "the 1000+ scientific tools" / "the harvard tools") working on Codex, says the Codex plugin or its tools/skills won't load, hits a uvx or MCP-server startup error, asks how Codex updates it, wants to pin or remove it, or finds it running an old tool version — even if they never say the word "plugin". Not for the Claude Code plugin (use tooluniverse-claude-code-plugin), for running research with the tools, or for authoring new tools or skills.
1,583SKILL.mdUpdated Jul 22, 2026