CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

75

Quality

93%

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

93%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 instruction-only skill body: every line carries a project-specific rule Claude could not guess, concrete commands and templates abound, and the seven-step workflow is unambiguous. The sole weakness is the absence of an explicit end-of-edit verification checklist.

Suggestions

Add a short final verification step (e.g. re-check that last-reviewed is set, the page links to two others, and wiki/index.md was updated) to close the workflow-clarity gap.

DimensionReasoningScore

Conciseness

Lean throughout: dense folder and rendering tables, exact tool and file names, and rules stated in a single line each ("A page links to at least two others"), with zero explanation of concepts Claude already knows. The only dates appear inside a legitimately instructional example of the measured-figure format, so no time-sensitivity penalty applies.

5 / 5

Actionability

Guidance is copy-paste concrete: named tools to avoid ("create_vault_file", "patch_vault_file", "search_and_replace"), an exact command ("grep -rn \"wiki/<old-folder>/<name>\" ."), exact frontmatter keys (title, tags, related, last-reviewed), and a ready-to-use markdown template for measured figures. Only a minor gap ("in the right section" of index.md is not enumerated), which keeps it from being an anchor-4 case with real missing steps.

5 / 5

Workflow Clarity

Seven clearly numbered, explicitly sequenced steps ("Follow each step before you finish the edit") with embedded rule-checkpoints like "Set last-reviewed to today on every page you touch" and "A page links to at least two others". Not 5 because there is no explicit final verification pass (e.g. re-check links, frontmatter, and index entry before finishing); not 3 since per-step rules function as implicit checkpoints and the sequence is unambiguous.

4 / 5

Progressive Disclosure

A single compact, well-sectioned file with no content that belongs in a separate file, and one clearly signaled one-level-deep external reference ("Invoke obsidian:obsidian-markdown before writing"). No bundle files exist, and none are needed at this size, so navigation is trivial.

5 / 5

Total

19

/

20

Passed

Description

92%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: imperative, third-person, concrete on both what it covers and when to use it, with tight scoping to wiki/ pages that all but eliminates conflict risk. The only gap is missing natural synonyms (notes, vault, documentation, .md) in the trigger vocabulary.

Suggestions

Add a few natural synonyms or extensions users might say — e.g. "wiki page (note)" or ".md pages under wiki/" — to widen the trigger vocabulary toward anchor 5 on trigger term quality.

DimensionReasoningScore

Specificity

Names three concrete actions ("creating, editing or restructuring") and enumerates six specific coverage areas ("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") that map one-to-one onto the skill's sections — comprehensive with no padding. Not 4 because no coverage area of the skill is missing.

5 / 5

Completeness

Explicitly answers both questions: "Use before creating, editing or restructuring any page under wiki/" is a concrete when-clause, and "Covers where edits must be made, the syntax skill to load, …" is a clear what. Not 4 because the when-clause is specific and trigger-shaped rather than generic.

5 / 5

Trigger Term Quality

Good natural keyword coverage — "wiki/", "Obsidian", "GitHub", "page", "frontmatter", "restructuring" — that a user would plausibly say. Not 5 because synonyms and file extensions users might naturally use ("notes", "vault", "documentation", ".md") are absent.

4 / 5

Distinctiveness Conflict Risk

The trigger is tightly scoped to "any page under wiki/ — the Obsidian vault for the whole monorepo", a clear niche with distinct triggers and minimal conflict risk against generic docs or markdown skills. Not 4 because the wiki/-path scoping leaves essentially no overlap with closely related skills.

5 / 5

Total

19

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
englishstreetventures/osn
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.