CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

create-tooluniverse-skill

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

56

Quality

70%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/create-tooluniverse-skill/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a well-structured, lean process skill with a clear 7-phase sequence, concrete paths and deliverables, and a genuine validation phase with feedback loops. Its two real weaknesses are the unresolved plugin-migration blockquote consuming tokens and — more seriously — a Reference Files table whose entries largely do not match the actual bundle file names, breaking navigation to the detailed materials.

Suggestions

Align every entry in the Reference Files table with the actual bundle paths (e.g. references/tool_testing_workflow.md, references/skill_standards_checklist.md, scripts/test_tools_template.py, assets/skill_template/SKILL.md) so referenced files resolve without guesswork.

Trim or relocate the tu-harness migration blockquote to a maintenance note outside the workflow instructions, since it does not help execute the skill.

Inline the key Phase 6 validation commands or an explicit 'only package when validation passes' gate instead of deferring entirely to the checklist reference.

DimensionReasoningScore

Conciseness

The body is dense and efficient — phase tables, terse bullets, and a rules-based Quality Indicators section with almost no padding — matching 'Efficient; minor instances of over-explanation that could be trimmed'. The main trimmable excess is the ~8-line blockquote about devtu-* skills migrating to the tu-harness plugin ('it has not moved yet only because nothing forced the question'), which is repo politics irrelevant to executing the workflow. Not a 3 because that blockquote is the only notable over-explanation and the remaining ~110 lines are lean; not a 5 because that meta-commentary does not earn its tokens.

4 / 5

Actionability

As an instruction-only process skill it gives concrete, executable direction: exact search paths ('/src/tooluniverse/data/*.json (186 tool files)'), named deliverables per phase (python_implementation.py with try/except per phase, test_skill.py), explicit rules ('zero Python/MCP code in SKILL.md'), and a real template script (test_tools_template.py, present in scripts/). This fits 'Mostly executable guidance; concrete code or commands with minor gaps'. Not a 5 because several key execution details are deferred to named files that do not resolve in the bundle (e.g. 'See TESTING_GUIDE.md for the full test suite template'); not a 3 because the steps that are written are specific enough to follow without interpretation.

4 / 5

Workflow Clarity

The 7-phase workflow is clearly sequenced (table with phases/durations, then per-phase sections) with a dedicated Validation phase ('Run the comprehensive test suite... load ToolUniverse fresh, copy-paste QUICK_START example, verify output works') and an explicit feedback loop ('Use devtu-fix-tool if new tools fail tests'), fitting 'Clear sequence with most checkpoints present; minor validation gaps'. Not a 5 because validation steps are named but their execution is deferred to reference files rather than given inline, and the 'Only proceed when validation passes' gate is implied by ordering rather than stated.

4 / 5

Progressive Disclosure

Scored against the actual bundle: the Reference Files table clearly signals one-level-deep references and content is appropriately split out of SKILL.md, but most referenced paths do not resolve — OPTIMIZE_INTEGRATION.md, TESTING_GUIDE.md, VALIDATION_CHECKLIST.md, and IMPLEMENTATION_AGNOSTIC.md correspond only in content to differently named files (devtu_optimize_integration.md, tool_testing_workflow.md, skill_standards_checklist.md, implementation_agnostic_format.md), while PARAMETER_VERIFICATION.md, PACKAGING_TEMPLATE.md, SKILL_TEMPLATE.md, QUICKSTART_TEMPLATE.md, and CODE_TEMPLATES.md have no matching names (plausible content equivalents live in an unmentioned assets/skill_template/). This fits 'Some structure but could be better organized' — navigation requires guesswork. Not a 2 because nothing is wrongly inlined and references are prominently signaled, not buried; not a 4 because broken paths for the majority of references is more than a 'minor organization gap'.

3 / 5

Total

15

/

20

Passed

Description

53%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is concise and names a distinct niche, but it reads as a one-line title rather than a trigger-ready description: it has a clear 'what' and no 'when', and only a single action verb. Adding a 'Use when...' clause with natural trigger phrases and enumerating the workflow's concrete actions would lift specificity, trigger terms, and completeness together.

Suggestions

Add an explicit trigger clause, e.g. 'Use when creating a new ToolUniverse skill for a biological/chemical domain, adding domain tool skills, or preparing a skill for release.'

Enumerate the concrete actions the workflow performs (discover and test tools, write implementation and tests, write agnostic docs, validate against checklist) instead of the single verb 'Create'.

Include natural user phrasings and synonyms such as 'new tooluniverse skill', 'domain skill', 'skill for [domain]' alongside the jargon 'implementation-agnostic methodology'.

DimensionReasoningScore

Specificity

The description names the domain ('ToolUniverse skills') and one concrete action ('Create') plus methodology qualifiers ('test-driven, implementation-agnostic'), matching the anchor 'Names domain and 1-2 concrete actions, but not comprehensive'. It is not a 4 because it does not enumerate the several distinct actions the skill actually performs (test tools, write implementations, document, validate), and not a 2 because 'create skills following test-driven methodology' is more concrete than a bare domain mention like 'Processes PDF files'.

3 / 5

Completeness

The 'what' is clear ('Create high-quality ToolUniverse skills following test-driven, implementation-agnostic methodology') but there is no 'Use when...' clause or equivalent trigger guidance anywhere, which per the judging guidelines caps completeness at 3. It matches anchor 3 ('clear what but when is missing') exactly; it is not a 4 since nothing implies when to invoke it, and not a 2 because the 'what' half is explicit rather than vague.

3 / 5

Trigger Term Quality

It contains the relevant keywords a maintainer would say ('Create', 'ToolUniverse', 'skills') but offers no synonyms or variations and leans on jargon ('implementation-agnostic methodology') that a user would not naturally type, fitting 'Some relevant keywords but missing common variations or synonyms'. Not a 4 because natural trigger phrases like 'new ToolUniverse skill', 'add a tooluniverse skill', or 'domain skill' are absent; not a 2 because 'ToolUniverse' is a genuine domain term rather than generic filler.

3 / 5

Distinctiveness Conflict Risk

'ToolUniverse skills' carves out a clear niche with minimal conflict risk against unrelated skills, fitting 'Mostly distinct; minor overlap risk with closely related skills'. Not a 5 because the body itself lists sibling skill-creation skills (devtu-create-tool, devtu-optimize-skills) whose descriptions would overlap a generic 'create skills' phrasing; not a 3 because the ToolUniverse-specific domain term keeps it well above 'Works with document files'-level overlap.

4 / 5

Total

13

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

mims-harvard/ToolUniverse

Path

skills/create-tooluniverse-skill/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.