CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

write-wiki

Use before creating, editing or restructuring any page under wiki/ — the Obsidian vault for the whole monorepo. Covers where edits must be made, the syntax skill to load, what renders on GitHub as well as in Obsidian, required frontmatter, linking a new page into the map, and how to write a measured number.

70

Quality

88%

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

86%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 lean, highly actionable rulebook: every section gives concrete commands, exact file paths, or copy-paste templates, and nothing pads token budget. The sequence is checklist-framed with a real validate-and-fix loop for page moves; only the absence of a general verification step for ordinary edits and the slightly long incident list in §7 keep it from full marks.

DimensionReasoningScore

Conciseness

The body is dense, project-specific, and assumes Claude's competence — no generic explanations of Obsidian or markdown. The one spot that could be trimmed is §7's four-bullet catalogue of past misses ('shared/production-deploy.md §3.4 named three builds...', plus three more), which illustrates a rule at noticeably more length than the rule itself needs. Not 3 because everything else is lean and earns its tokens.

4 / 5

Actionability

Fully concrete, executable guidance throughout: exact commands ('bun scripts/check-wikilinks.ts', 'grep -rn "wiki/<old-folder>/<name>" .'), a named skill to invoke ('obsidian:obsidian-markdown'), a folder-to-content mapping table, required frontmatter fields, and a copy-paste-ready measured-figure template with a real command and date format. Not 4 because there are no pseudocode placeholders or missing key details.

5 / 5

Workflow Clarity

Eight numbered sections framed as a checklist ('Follow each step before you finish the edit'), with an explicit validate-and-fix loop for the risky move operation ('bun scripts/check-wikilinks.ts finds the broken wikilinks... Fix both in the same pull request') and behavioral checkpoints ('Re-read the whole sentence or row before you finish'). Not 5 because ordinary (non-move) edits have no explicit verification step — the checkpoints are principles rather than a runable check, leaving minor validation gaps.

4 / 5

Progressive Disclosure

The skill is self-contained (~80 lines) with eight well-named sections and a clear overview sentence; it delegates syntax authority to a clearly signaled one-level-deep reference ('Invoke obsidian:obsidian-markdown... It is the syntax authority for this vault') instead of inlining it, and no content that belongs in a separate file is bundled here. Navigation is trivial via the numbered headings.

5 / 5

Total

18

/

20

Passed

Description

87%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, tightly scoped description: it states explicit triggers (create/edit/restructure pages under wiki/), enumerates what the skill covers, and carves out a distinct niche. Trigger term coverage and phrasing of capabilities as 'Covers...' topics rather than direct actions keep it just short of perfect on two dimensions.

DimensionReasoningScore

Specificity

The description enumerates several concrete covered actions — 'creating, editing or restructuring any page under wiki/', 'required frontmatter, linking a new page into the map, and how to write a measured number' — but phrases them as topic coverage ('Covers where edits must be made, the syntax skill to load') rather than fully concrete operations, leaving minor gaps versus the comprehensive anchor.

4 / 5

Completeness

It explicitly answers both questions: what ('Covers where edits must be made, the syntax skill to load, what renders on GitHub as well as in Obsidian, required frontmatter, linking a new page into the map, and how to write a measured number') and when ('Use before creating, editing or restructuring any page under wiki/') with concrete trigger phrasing. Not 4 because the 'when' clause is explicit and specific, not merely present.

5 / 5

Trigger Term Quality

Natural trigger words are present — 'wiki/', 'page', 'Obsidian', 'GitHub', 'frontmatter', 'restructuring' — which a user editing the vault would plausibly say. A few natural variants ('vault', 'wikilink', 'note') are missing, so it falls just short of the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

The trigger is location-scoped ('any page under wiki/ — the Obsidian vault for the whole monorepo'), a clear niche unlikely to fire for unrelated skills. The closely related obsidian-markdown skill is explicitly delegated to rather than overlapped, keeping conflict risk minimal.

5 / 5

Total

18

/

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

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

15

/

16

Passed

Repository

englishstreetventures/osn

Path

.claude/skills/write-wiki/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.