CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

devtu-docs-quality

TOP PRIORITY skill — find and immediately fix or remove every piece of wrong, outdated, or redundant information in ToolUniverse docs. Wrong code, broken links, incorrect counts, and overlapping instructions must be fixed or removed — never left in place. Runs five phases: (D) static method scan, (C) static tool-call check, (A) automated validation, (B) ToolUniverse audit, (E) less-is-more simplification. Core philosophy: each concept appears exactly once; remove don't add; no emojis; single setup entry point. Use when reviewing docs, before releases, after API changes, or when asked to audit, fix, or simplify documentation.

68

Quality

85%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

A highly actionable, well-sequenced audit skill with excellent validation checkpoints and copy-paste-ready tooling, undermined by self-inconsistency with its own 'less is more' philosophy: repeated rules across sections, ~130 lines of inline scanner code, and a Reference Files section whose targets are missing from the bundle.

Suggestions

Move the Phase D and Phase E inline Python scanners into scripts/ files (e.g., scripts/phase_d_method_scan.py, scripts/phase_e_simplification_scan.py) and invoke each with a one-line command — this removes ~130 lines from SKILL.md while keeping the phases fully executable.

Deduplicate the repeated rules: 'no emojis' and the fix-or-remove guidance each currently appear in the 'Less Is More', 'Apple-Style Simplification Rules', and Validation Checklist sections — state each rule once and cross-link, per the skill's own 'each concept appears exactly once' principle.

Resolve the broken bundle references: either ship API_REFERENCE.md, DOCS_STRUCTURE.md, and scripts/check_skill_tool_calls.py alongside SKILL.md, or remove the 'Reference Files' section — as delivered, all three links point to nonexistent files.

DimensionReasoningScore

Conciseness

Mostly efficient — no explanations of concepts Claude already knows — but visibly self-redundant: the "no emojis" rule appears in the "Less Is More" section, again in "Apple-Style Simplification Rules", and again in the checklist; "Two Equal Priorities" and the philosophy section overlap; and the Phase D wrong→correct table duplicates what API_REFERENCE.md is described as containing. More than the 'minor instances' of the score-4 anchor, but far from the padded verbosity of score 2.

3 / 5

Actionability

Fully executable throughout: two complete, self-contained copy-paste-ready Python scanners (Phase D and Phase E), exact commands for Phases C and A (`python scripts/check_skill_tool_calls.py`, `python scripts/validate_documentation.py`), a wrong→correct method-mapping table, and a common-failures table with fixes — matching the score-5 anchor's 'copy-paste ready code or commands; specific examples cover the common cases'.

5 / 5

Workflow Clarity

Clear sequence with explicit validation and feedback loops: "Run phases in order — D first (instant), then E (simplification scan), then C/A/B", a phase table with time estimates, a two-part validation checklist ("All items must pass before the audit is done. A partial pass is not acceptable"), and recovery guidance ("If any item is failing: stop, fix it, re-run the relevant phase, confirm it passes") — an exact match for the score-5 anchor including error-recovery loops.

5 / 5

Progressive Disclosure

Section structure is clear and the "Reference Files" section is prominently signaled, but ~130 lines of scanner code are inlined in the body where they belong in separate scripts/ files, and every reference in that section (API_REFERENCE.md, DOCS_STRUCTURE.md, scripts/check_skill_tool_calls.py) points to a file that does not exist in the skill bundle — the bundle contains only SKILL.md. Matches the score-3 anchor (content that should be separate is inline, organization imperfect) rather than score 2, since the structure itself is strong and navigation is well signaled.

3 / 5

Total

16

/

20

Passed

Description

88%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 strong description: concrete actions, a complete five-phase capability inventory, and an explicit 'Use when' clause with varied natural triggers. Its only weaknesses are a few missing trigger synonyms and trigger phrasing generic enough to mildly overlap a general docs-cleanup skill.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions — "find and immediately fix or remove every piece of wrong, outdated, or redundant information in ToolUniverse docs", "Wrong code, broken links, incorrect counts, and overlapping instructions" — plus five named phases (D/C/A/B/E), giving comprehensive coverage within its domain. The score-4 anchor ("minor gaps in coverage") fits worse since no capability area is left uncovered.

5 / 5

Completeness

Clearly answers both questions: what ("find and immediately fix or remove every piece of wrong, outdated, or redundant information in ToolUniverse docs" plus the five-phase run model) and when ("Use when reviewing docs, before releases, after API changes, or when asked to audit, fix, or simplify documentation") with concrete trigger phrases — an exact match for the score-5 anchor.

5 / 5

Trigger Term Quality

Natural trigger phrases are present: "Use when reviewing docs, before releases, after API changes, or when asked to audit, fix, or simplify documentation." Coverage is good but a few natural phrasings users would say are missing (e.g., "cleanup", "outdated/stale docs", "docs quality"), so it does not reach the comprehensive synonym coverage of the score-5 anchor.

4 / 5

Distinctiveness Conflict Risk

The explicit scoping to "ToolUniverse docs" establishes a clear niche, but trigger phrasings like "simplify documentation" and "reviewing docs" are generic enough to overlap with a general documentation-cleanup skill — minor overlap risk, matching the score-4 anchor rather than the minimal-conflict score-5 anchor.

4 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 2 missing

Warning

referenced_paths_exist

Referenced path issues: 5 missing

Warning

Total

14

/

16

Passed

Repository

mims-harvard/ToolUniverse

Path

skills/devtu-docs-quality/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.