CtrlK
BlogDocsLog inGet started
Tessl Logo

devtu-code-optimization

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.

66

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Critical

Do not install without reviewing

Fix and improve this skill with Tessl

tessl review fix ./skills/devtu-code-optimization/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

90%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.

An exemplary lean skill body: every token is project-specific, all commands are copy-paste executable, and detailed material is properly split into two well-organized reference files. The only gaps are the implicit top-level workflow ordering, a missing fix-and-retry loop for failed checklist items, and inconsistent reference link paths.

DimensionReasoningScore

Conciseness

The body is a lean checklist, a signal-to-reference table, a two-entry reference list, and a terse git block — no explanations of concepts Claude already knows, no padding. Every line carries project-specific information (e.g. "New tool class registered in `_lazy_registry_static.py` and `default_config.py`").

5 / 5

Actionability

Guidance is fully executable throughout: a copy-paste JSON validation one-liner, `ruff check src/tooluniverse/<file>.py`, an import smoke test, a real CLI run command, and concrete git commands with `--force-with-lease`. The fix-category table maps each failure signal to a specific reference section. Not below 5 because the common cases (pre-commit verification, rebase/push, PR mergeability) are all covered with specific commands.

5 / 5

Workflow Clarity

The pre-commit checklist provides strong validation checkpoints (schema shape, real-ID tests, lint, import, end-to-end CLI run) and the git workflow includes an explicit gate ("must be MERGEABLE before done"). Not 5 because the overall write→checklist→PR sequence is implicit rather than explicitly ordered, and there is no fix-and-retry feedback loop (e.g. what to do when a checklist item fails).

4 / 5

Progressive Disclosure

The body is a clean overview with two real, one-level-deep references (references/api-fixes.md and references/code-patterns.md), each well-signaled with a scope description, and the table's section anchors (Quick Lookup Table, Schema Patterns, Client-Side Filter, etc.) all resolve in the actual files. Not 5 because the table links use bare paths (`[code-patterns.md](code-patterns.md)`) that don't resolve from SKILL.md's location, inconsistently with the correct `references/`-prefixed links in the References section.

4 / 5

Total

18

/

20

Passed

Description

70%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.

A solid description with an explicit Apply-when clause and a dedicated trigger list that use natural language. Its main weakness is an abstract "what" — it announces itself as "patterns and guidelines" without naming the concrete capabilities (schema patterns, client-side filtering, API bug lookup) it actually provides.

Suggestions

Replace the abstract 'Code quality patterns and guidelines' opening with 2-3 concrete capabilities, e.g. 'Provides reusable Python patterns for return schemas, client-side filtering/pagination, and normalization disclosure, plus per-API bug-fix lookups for ToolUniverse tools.'

Add failure-signal synonyms users naturally say to the Triggers line, e.g. 'tool returns 0 results', 'schema validation fails', 'silent parameter ignored', to improve trigger term coverage.

DimensionReasoningScore

Specificity

"Code quality patterns and guidelines for ToolUniverse tool development" names the domain clearly, and the trigger list adds semi-concrete actions ("checking schema correctness, looking up API-specific bug fixes"), but the core action verbs ("writing, fixing, or refactoring") are generic. It sits between anchor 2 (generic actions) and anchor 4 (several specific actions) — closer to 3 because the actions are named but not concretely elaborated.

3 / 5

Completeness

Both are present: the "what" ("Code quality patterns and guidelines for ToolUniverse tool development") and an explicit "when" ("Apply when writing, fixing, or refactoring tool Python code" plus a dedicated Triggers list). Not 5 because the "what" is abstract — it describes being a pattern/guideline resource rather than stating concrete capabilities.

4 / 5

Trigger Term Quality

"implementing tool fixes, writing new tool classes, reviewing tool code quality, checking schema correctness, looking up API-specific bug fixes" are natural phrases a user would say, giving good keyword coverage. Not 5 because it misses common synonyms and variations (e.g. "debugging", "lint", "API returns nothing/0 results", "schema validation error").

4 / 5

Distinctiveness Conflict Risk

"ToolUniverse tool development" carves a clear niche and the description even coordinates with sibling skills ("Use alongside devtu-fix-tool and devtu-self-evolve"), keeping conflict risk low. Not 5 because "implementing tool fixes" overlaps with devtu-fix-tool's territory, leaving minor overlap with a closely related skill.

4 / 5

Total

15

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 8 missing

Warning

Total

15

/

16

Passed

Repository
mims-harvard/ToolUniverse
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.