Skip to content
cccskills
FreePublished on GitHub

create-tooluniverse-skill

Create high-quality ToolUniverse skills following test-driven, implementation-agnostic methodology.

The English summary is being prepared. Showing the original description.

See how to install

Files included (19)

  • SKILL.md4.7 KB
  • assets/skill_template/python_implementation.py5.5 KB
  • assets/skill_template/QUICK_START.md7.5 KB
  • assets/skill_template/SKILL.md6.2 KB
  • assets/skill_template/test_skill.py6.6 KB
  • CODE_TEMPLATES.md4.5 KB
  • OPTIMIZE_INTEGRATION.md3.3 KB
  • PACKAGING_TEMPLATE.md1.1 KB
  • PARAMETER_VERIFICATION.md1.1 KB
  • QUICKSTART_TEMPLATE.md1.6 KB
  • references/devtu_optimize_integration.md8.5 KB
  • references/implementation_agnostic_format.md6.3 KB
  • references/skill_standards_checklist.md7.1 KB
  • references/tool_testing_workflow.md5.2 KB
  • scripts/test_tools_template.py5.7 KB
  • SKILL_TEMPLATE.md2.3 KB
  • test_tools_template.py5.7 KB
  • TESTING_GUIDE.md6.3 KB
  • VALIDATION_CHECKLIST.md1.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Create ToolUniverse Skill

Systematic workflow for creating production-ready ToolUniverse skills.

Core Principles

Build on the 10 pillars from devtu-optimize-skills:

  1. TEST FIRST - never document untested tools
  2. Verify tool contracts - don't trust function names
  3. Handle SOAP tools - add operation parameter
  4. Implementation-agnostic docs - no Python/MCP code in SKILL.md
  5. Foundation first - query aggregators before specialized tools
  6. Disambiguate carefully - resolve IDs properly
  7. Implement fallbacks - Primary -> Fallback -> Default
  8. Grade evidence - T1-T4 tiers on claims
  9. Quantified completeness - numeric minimums per section
  10. Synthesize - models and hypotheses, not just lists

See OPTIMIZE_INTEGRATION.md for detailed application of each pillar.

7-Phase Workflow

PhaseDurationDescription
1. Domain Analysis15 minUnderstand use cases, data types, analysis phases
2. Tool Discovery30-45 minSearch, read configs, test tools (MANDATORY)
3. Tool Creation0-60 minCreate missing tools via devtu-create-tool
4. Implementation30-45 minWrite python_implementation.py with tested tools
5. Documentation30-45 minWrite SKILL.md (agnostic) + QUICK_START.md
6. Validation15-30 minRun test suite, validate checklist, manual verify
7. Packaging15 minCreate summary, update tracking

Total: ~1.5-2 hours (without tool creation).

Phase 1: Domain Analysis

  • Gather concrete use cases and expected outputs
  • Identify inputs, outputs, and intermediate data types
  • Break workflow into logical phases
  • Review existing skills in skills/ for patterns

Phase 2: Tool Discovery and Testing

Search tools in /src/tooluniverse/data/*.json (186 tool files). For each tool, read its config to understand parameters and return schema. See PARAMETER_VERIFICATION.md for common pitfalls.

Create and run a test script using test_tools_template.py. For each tool: call with known-good params, verify response format, document corrections. See TESTING_GUIDE.md for the full test suite template and procedures.

Phase 3: Tool Creation (If Needed)

Invoke devtu-create-tool when required functionality is missing and analysis is blocked. Use devtu-fix-tool if new tools fail tests.

Phase 4: Implementation

Create skills/tooluniverse-[domain]/ with:

  • python_implementation.py - use only tested tools, try/except per phase, progressive report writing
  • test_skill.py - test each input type, combined inputs, error handling

Use templates from CODE_TEMPLATES.md.

Phase 5: Documentation

Write implementation-agnostic SKILL.md using SKILL_TEMPLATE.md. Write multi-implementation QUICK_START.md using QUICKSTART_TEMPLATE.md. Key rules: zero Python/MCP code in SKILL.md, equal treatment of both interfaces in QUICK_START.

See IMPLEMENTATION_AGNOSTIC.md for format guidelines with examples.

Phase 6: Validation

Run the comprehensive test suite (see TESTING_GUIDE.md). Validate against VALIDATION_CHECKLIST.md. Perform manual verification: load ToolUniverse fresh, copy-paste QUICK_START example, verify output works.

Phase 7: Packaging

Create summary document using PACKAGING_TEMPLATE.md. Update session tracking if creating multiple skills.

Skill Integration

SkillWhen to Use
devtu-create-toolCritical functionality missing
devtu-fix-toolTool returns errors or unexpected format
devtu-optimize-skillsEvidence grading, report optimization

Quality Indicators

High quality: 100% test coverage before docs, agnostic SKILL.md, multi-implementation QUICK_START, fallback strategies, parameter corrections table, response format docs.

Red flags: Docs before testing, Python in SKILL.md, assumed parameters, no fallbacks, SOAP tools missing operation, no test script.

Reference Files

FileContent
SKILL_TEMPLATE.mdTemplate for writing SKILL.md
QUICKSTART_TEMPLATE.mdTemplate for writing QUICK_START.md
TESTING_GUIDE.mdTest suite template and procedures
VALIDATION_CHECKLIST.mdPre-release quality checklist
PACKAGING_TEMPLATE.mdSummary document template
PARAMETER_VERIFICATION.mdTool parameter verification guide
OPTIMIZE_INTEGRATION.mddevtu-optimize-skills 10-pillar integration
IMPLEMENTATION_AGNOSTIC.mdImplementation-agnostic format guide with examples
CODE_TEMPLATES.mdPython implementation and test templates
test_tools_template.pyTool testing script template

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Simplest distributed training API. 4 lines to add distributed support to any PyTorch script. Unified API for DeepSpeed/FSDP/Megatron/DDP. Automatic device placement, mixed precision (FP16/BF16/FP8). Interactive config, single launch command. HuggingFace ecosystem standard.

The English summary is being prepared. Showing the original description.

huang-sh/DeepScience4Updated Jul 15, 2026

ADMET property prediction for drug candidates. Full pharmacokinetic panel (Caco-2, PPB, clearance, CYP), toxicity (hERG, AMES, DILI), drug-likeness (Lipinski, QED), using RDKit descriptors and TDC models.

The English summary is being prepared. Showing the original description.

huang-sh/DeepScience4Updated Jul 15, 2026

Interpretable ADMET analysis with mechanistic reasoning. Maps liabilities to structural causes and biological pathways. Based on CoTox (Park 2025) and DrugR (Liu 2026).

The English summary is being prepared. Showing the original description.

huang-sh/DeepScience4Updated Jul 15, 2026

aeon

Free

This skill should be used for time series machine learning tasks including classification, regression, clustering, forecasting, anomaly detection, segmentation, and similarity search. Use when working with temporal data, sequential patterns, or time-indexed observations requiring specialized algorithms beyond standard ML approaches. Particularly suited for univariate and multivariate time series analysis with scikit-learn compatible APIs.

The English summary is being prepared. Showing the original description.

huang-sh/DeepScience4Updated Jul 15, 2026

Infer gene regulatory networks (GRNs) from gene expression data using scalable algorithms (GRNBoost2, GENIE3). Use when analyzing transcriptomics data (bulk RNA-seq, single-cell RNA-seq) to identify transcription factor-target gene relationships and regulatory interactions. Supports distributed computation for large-scale datasets.

The English summary is being prepared. Showing the original description.

huang-sh/DeepScience4Updated Jul 15, 2026

Comprehensive Python library for astronomy and astrophysics. This skill should be used when working with astronomical data including celestial coordinates, physical units, FITS files, cosmological calculations, time systems, tables, world coordinate systems (WCS), and astronomical data analysis. Use when tasks involve coordinate transformations, unit conversions, FITS file manipulation, cosmological distance calculations, time scale conversions, or astronomical data processing.

The English summary is being prepared. Showing the original description.

huang-sh/DeepScience4Updated Jul 15, 2026

See all skills by huang-sh

Report a problem with this skill