CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

spec-loop-setup-doc-rendering

Help set up and troubleshoot rendering for task files and glossary files. Use when the user asks about PlantUML, AsciiDoc, VS Code, Cursor, other VS Code-based IDEs, JetBrains, preview rendering, Java, or Graphviz needed to review rendered task or glossary files.

Quality

73%

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/spec-loop-setup-doc-rendering/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

60%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 disciplined, well-scoped agent policy with concrete verification commands and a sensible evidence-first workflow, and it avoids verbosity. Its real defects are structural: the two referenced setup documents are missing from the bundle and the one existing helper script is never named, leaving the preferred check path unexecutable as written.

Suggestions

Ship vscode-setup.md and jetbrains-setup.md in the skill bundle (or remove the dead links), so the per-IDE setup paths the body points to actually exist.

Reference the helper script explicitly by path (scripts/setup-vscode-server-based.sh with its --check/--apply modes) wherever the 'helper-script check path' is preferred, so the guidance is directly executable.

Make the workflow sequence explicit with a short numbered list (verify environment → run helper checks → create probe files covering class/sequence/component/Mermaid diagrams → report results) and add a post-install verification step on the JetBrains path.

DimensionReasoningScore

Conciseness

The body is agent-policy instruction with no concept explanations Claude already knows, and it does not restate the setup references ("Do not just restate the setup references"). Minor trimming is possible: the opening line duplicates the description, and "For VS Code, Cursor, and other VS Code-based IDEs" appears three times, so it sits at 'efficient; minor instances that could be trimmed' rather than fully lean.

4 / 5

Actionability

There is concrete guidance — `command -v dot`, `dot -V`, `command -v java`, `java -version`, `test -f` for plantuml.jar, and project-local evidence sources (`.idea/`, `.vscode/`, `glossary.adoc`) — but key details are missing: the helper-script check path is preferred yet the actual script (`scripts/setup-vscode-server-based.sh`) is never named, and both linked setup documents do not exist in the bundle. That matches 'some concrete guidance but incomplete; missing key details' rather than level 4's 'minor gaps'.

3 / 5

Workflow Clarity

The sequence is present and ordered: gather evidence yourself → report what works/what is broken/what cannot be verified → create probe files (including a required class diagram) to verify rendering end to end, with per-IDE command checklists and confirmation gates before changing plugins or settings. It is not level 5 because the ordering is prose-implicit rather than explicitly numbered with checkpoints, and the JetBrains path lacks a stated verification step after Graphviz checks.

4 / 5

Progressive Disclosure

The body links to [vscode-setup.md](vscode-setup.md) and [jetbrains-setup.md](jetbrains-setup.md) as its one-level-deep references, but neither file exists in the bundle — the only bundle file is scripts/setup-vscode-server-based.sh, which the body never references by path. Scored against the actual bundle structure, the navigation is broken at the first level (mitigated only by "Use only the setup documents that actually exist here"), which fits 'minimal structure... references are buried/non-functional' more than level 3's 'references present but not clearly signaled'.

2 / 5

Total

13

/

20

Passed

Description

75%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 cleanly answers both 'what' and 'when' with an explicit trigger clause rich in natural tool names. Its weaknesses are a thin action list and broad individual triggers (Java, VS Code, JetBrains) that create some overlap risk.

DimensionReasoningScore

Specificity

"Help set up and troubleshoot rendering" names the domain (rendering of task and glossary files) and exactly two actions — set up and troubleshoot — which matches the anchor for 'domain and 1-2 concrete actions, but not comprehensive'. It is not level 4 because no additional specific actions (install extensions, verify Java/Graphviz, run probes) are listed, and not level 2 because the domain and actions are concrete, not generic.

3 / 5

Completeness

The description explicitly answers both: what — "Help set up and troubleshoot rendering for task files and glossary files"; when — an explicit "Use when the user asks about..." clause with concrete trigger phrases. It is not level 4 because the 'when' clause is already explicit and specific with a list of concrete triggers, matching the top anchor's structure of a clear what plus a concrete when.

5 / 5

Trigger Term Quality

"PlantUML, AsciiDoc, VS Code, Cursor, other VS Code-based IDEs, JetBrains, preview rendering, Java, or Graphviz" gives good coverage of natural tool names users would actually say. It is not level 5 because common variations like "diagram", "render", "preview", or file extensions (.adoc, .puml) are missing; it is above level 3 because the list includes multiple natural terms and synonyms (two IDEs plus the VS Code-based family).

4 / 5

Distinctiveness Conflict Risk

"task files and glossary files" and the rendering focus carve a niche, but triggers like "Java", "VS Code", and "JetBrains" are broad enough to fire on general Java programming or unrelated IDE questions — "somewhat specific but could still overlap with similar skills". It is not level 2 because the domain qualifiers (rendering, task/glossary files) prevent overlap with virtually any skill, and not level 4 because the unqualified "Java" and IDE-name triggers carry real overlap risk.

3 / 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: 4 missing

Warning

Total

15

/

16

Passed

Repository

dpolivaev/spec-loop

Path

skills/spec-loop-setup-doc-rendering/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.