CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

wiki-page-writer

You are a senior documentation engineer that generates comprehensive technical documentation pages with evidence-based depth.

Quality

62%

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 ./plugins/AI-Agents-Safe-Coding-Skills/skills/wiki-page-writer/SKILL.md

The canonical home for this skill is wiki-page-writer in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

63%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 content is a dense, highly actionable rulebook for generating VitePress wiki pages, with concrete formatting requirements, citation standards, and a validating four-step procedure. Its main flaws are templating artifacts — a duplicated "When to Use" section ending in filler text, a repeated intro line — and the absence of any error-recovery loop after validation, plus detailed spec lists that would sit better in reference files.

Suggestions

Delete the duplicated trailing "## When to Use" section ("This skill is applicable to execute the workflow or actions described in the overview") and the intro line that repeats the frontmatter description verbatim.

Add a feedback loop to the Validate step: what to do when verification fails (e.g., re-read the cited file, correct the claim or diagram, re-validate before finishing).

Move the detailed Mermaid dark-mode color palette and VitePress compatibility rules into a reference file (e.g., references/formatting.md), keeping SKILL.md as a concise overview.

DimensionReasoningScore

Conciseness

The body is mostly directive and dense, but contains unnecessary padding: the intro line repeats the frontmatter description verbatim, "NO HAND-WAVING — Don't say 'this likely handles...' — read the code" restates rule 1 ("TRACE ACTUAL CODE PATHS"), and the trailing "## When to Use / This skill is applicable to execute the workflow or actions described in the overview" is a duplicated section of pure filler. This matches anchor 3 (mostly efficient but could be tightened) rather than 4, where over-explanation would be only minor.

3 / 5

Actionability

Requirements are concrete and executable: an exact VitePress frontmatter template, specific hex colors ("node fills #2d333b, borders #6d5dfc, text #e6edf3"), quantified minimums ("Minimum 2 per page" diagrams, "Minimum 5 different source files cited"), a citation format ("(file_path:line_number)"), and precise escaping rules ("`List<T>` not bare List<T>"). Scored 4 not 5 because some guidance stays high-level — "documentation budget based on file count" is undefined and the Procedure steps lack executable specifics.

4 / 5

Workflow Clarity

The Procedure gives a clear Plan → Analyze → Write → Validate sequence with an explicit validation checkpoint ("Verify file paths exist, class names are accurate, Mermaid renders correctly"), which also satisfies the batch-operation validation requirement. Scored 4 not 5 because there is no feedback loop instructing what to do when validation fails (e.g., re-read the code and regenerate the affected section).

4 / 5

Progressive Disclosure

The body is well-sectioned (When to Use, Procedure, Mandatory Requirements with subsections), but the duplicated trailing "When to Use" section, the repeated intro line, and inlined detailed spec lists (Mermaid dark-mode colors, VitePress compatibility rules) that arguably belong in a separate reference file match anchor 3 (some structure but could be better organized). Not 4, since a literal duplicated section with placeholder filler is more than a minor organization gap.

3 / 5

Total

14

/

20

Passed

Description

45%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 communicates a clear core capability but is written in second person, padded with buzzwords ("comprehensive", "evidence-based depth"), and completely lacks trigger guidance. It also omits the skill's most distinctive terms — wiki, VitePress, Mermaid — making it hard to discover and prone to overlap with generic documentation skills.

Suggestions

Rewrite in third person and list concrete actions, e.g. "Generates wiki-style technical documentation pages with Mermaid diagrams and file-path citations, formatted for VitePress."

Add an explicit trigger clause: "Use when the user asks to document a component, system, or feature, write a technical deep-dive, or generate wiki catalogue content."

Include natural trigger terms users would actually say — wiki, docs, deep dive, document this component — instead of abstract descriptors like "evidence-based depth".

DimensionReasoningScore

Specificity

"generates comprehensive technical documentation pages with evidence-based depth" names the domain and one concrete action, matching anchor 3, but the second-person voice ("You are a senior documentation engineer") triggers the guideline's 1-point specificity penalty, landing at 2; "comprehensive" and "evidence-based depth" are buzzword modifiers rather than additional actions, so it cannot score higher.

2 / 5

Completeness

The "what" is clearly stated ("generates comprehensive technical documentation pages") but no "Use when..." clause or equivalent trigger guidance exists, which caps completeness at 3 per the judging guidelines. It cannot score 4 because the "when" is entirely absent rather than merely under-specified.

3 / 5

Trigger Term Quality

"technical documentation pages" is a domain-relevant keyword, but the description misses the natural phrases users would actually say — "wiki" (despite being the skill's name), "write docs", "document this feature", "deep dive" — fitting anchor 3 (some relevant keywords, missing common variations). It is above 2 because the keyword is domain-specific rather than generic, and below 4 because coverage of natural synonyms is thin.

3 / 5

Distinctiveness Conflict Risk

"technical documentation pages with evidence-based depth" carves a moderately specific niche, but it overlaps with generic documentation/README-writing skills and never mentions its actual distinguishing features (wiki catalogues, VitePress, Mermaid diagrams), matching anchor 3. Not 4, since a user asking for ordinary docs would trigger this skill incorrectly.

3 / 5

Total

11

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/wiki-page-writer/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.