devtu-auto-discover-apis
Automatically discover life science APIs online, create ToolUniverse tools, validate them, and prepare integration PRs. Performs gap analysis to identify missing tool categories, web searches for APIs, automated tool creation using devtu-create-tool patterns, validation with devtu-fix-tool, and git
By mims-harvard · 375 installs
npx skills add mims-harvard/tooluniverse --skill devtu-auto-discover-apis
Source repository · Upstream listing
Automated Life Science API Discovery & Tool Creation
Discover, create, validate, and integrate life science APIs into ToolUniverse.
Four Phase Workflow
Human approval gates after: discovery, creation, validation, and before PR.
Phase 1: Discovery & Gap Analysis
1.1 Analyze Current Coverage
Load ToolUniverse, categorize tools by domain (genomics, proteomics, drug discovery, clinical, omics, imaging, literature, pathways, systems biology). Count per category.
1.2 Identify Gap Domains
Critical Gap : <5 tools in category
Moderate Gap : 5 15 tools, missing key subcategories
Emerging Gap : New technologies not represented
Common gaps: single cell genomics, metabolomics, patient registries, microbial genomics, multi omics integration, synthetic biology, toxicology.
1.3 Web Search for APIs
For each gap domain, run multiple queries:
1. "[domain] API REST JSON" — direct API search
2. "[domain] public database" — database discovery
3. "[domain] API 2025 OR 2026" — recent releases
4. "[domain] database" site:nar.oxfordjournals.org — NAR Database Issue
Extract: base URL, endpoints, auth method, parameter schemas, rate limits.
1.4 Score and Prioritize
Criterion Max Points
Documentation Quality 20
API Stability 15
Authentication Simplicity 15
Coverage 15
Maintenance 10
Community 10
License 10
Rate Limits 5
High priority ( =70), Medium (50 69), Low (<50).
1.5 Generate Discovery Report
Coverage analysis, prioritized candidates with scores, implementation roadmap.
Phase 2: Tool Creation
For each API, use Skill(skill="devtu create tool") or follow these patterns.
Architecture Decision
Multiple endpoints → multi operation tool (single class, multiple JSON wrappers)
Single endpoint → single operation acceptable
Key Steps
1. Design tool class following template — see [references/tool templates.md](references/tool templates.md)
2. Create JSON config with oneOf return schema
3. Find real test examples (use List endpoint → extract IDs → verify)
4. Register in default config.py
Critical Requirements
return schema MUST have oneOf (success + error schemas)
test examples MUST use real IDs (NO placeholders)
Tool name <= 55 characters
NEVER raise exceptions in run() — return error dict
Set timeout on all HTTP requests (30s)
Phase 3: Validation
Full guide: [references/validation guide.md](references/validation guide.md)
Quick Validation Checklist
1. Schema : oneOf structure, data wrapper, error field
2. Placeholders : No TEST/DUMMY/PLACEHOLDER in test examples
3. Loading : 3 step check (class registered, config registered, wrappers generated)
4. Integration tests : python scripts/test new tools.py [api name] v → 100% pass
Fix failures with Skill(skill="devtu fix tool") .
Phase 4: Integration
Use Skill(skill="devtu github") or:
1. Create branch: feature/add [api name] tools
2. Stage tool files + default config.py
3. Commit with descriptive message
4. Push and create PR with validation results
Processing Patterns
Pattern When to Use
Batch (multiple APIs → single PR) Same domain, similar structure
Iterative (one API at a time) Complex auth, novel patterns
Discovery only (report, no tools) Planning roadmap
Validation only (audit existing) PR review, quality check
References
Tool templates (Python class + JSON config): [references/tool templates.md](references/tool templates.md)
Validation & integration guide : [references/validation guide.md](references/validation guide.md)