CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

wiki-update

Sync knowledge from the current project into the Obsidian wiki. Use when work already in the current project should be distilled into the vault; named-vault routing includes @work update wiki. wiki-capture saves the current conversation and wiki-ingest handles external/new sources.

Quality

76%

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/wiki-update/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 dense, highly actionable workflow with genuine error-recovery checkpoints (rebase detection, guard clauses, QMD verification) and concrete templates throughout. Its weaknesses are editorial rather than structural: duplicated sections, a repeated guard, and a mis-numbered step list that could be tightened without losing content.

Suggestions

Merge the duplicated Step 6 sections: fold the short "### Update index.md" into "### Update index.md, log.md, and hot.md" so the locked memory-sync call is presented once as the single way to update all three tracking files.

Fix the "Before You Start" list numbering (currently 1, 3, 4) and deduplicate the Step 3b guard — state the skip-on-failure rule once instead of twice (lines 73 and 97).

Move the page-format YAML template and provenance-marker spec (Step 4) into a references/ file (e.g. references/PAGE_FORMAT.md) to slim SKILL.md and keep only the field requirements inline.

DimensionReasoningScore

Conciseness

The body is almost purely operational with no concept explanations, but contains several avoidable redundancies: a duplicated "Update index.md" section inside Step 6, the code-understand guard stated twice (Step 3b opening and closing), and a mis-numbered list (1, 3, 4) in "Before You Start". This matches "mostly efficient but... could be tightened"; it is not a 2 because nothing is padded with knowledge Claude already has.

3 / 5

Actionability

Highly executable throughout: copy-paste bash commands (git merge-base check, obsidian-wiki code-understand/memory sync, qmd update/embed/get), exact JSON manifest and YAML frontmatter templates, and verbatim warning text for the rebase fallback. Minor gaps — "Compute the rough fractions" for provenance and reliance on llm-wiki/SKILL.md sections — keep it below the fully-self-contained score-5 anchor.

4 / 5

Workflow Clarity

Steps 1–7 are clearly sequenced with real validation checkpoints (SHA ancestor check with explicit rebase/force-push fallback and warning, code-understand and QMD guards, post-refresh verification via qmd get, and an enumerated QMD status report), so the batch-operation cap does not apply. The mis-numbered Before-You-Start list and the duplicate Step 6 section headers slightly blur the sequence, holding it at 4 rather than 5.

4 / 5

Progressive Disclosure

Well-sectioned with one-level-deep, clearly signaled external references ("Writing Profile Resolution section in llm-wiki/SKILL.md", "Link Format section", "Provenance Markers section", ".skills/llm-wiki/references/MEMORY.md"). Minor gaps: the ~40-line inline page-format/frontmatter template and provenance spec could live in a local references/ file, and the cross-referenced files are not part of this bundle.

4 / 5

Total

15

/

20

Passed

Description

73%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 with an explicit Use-when clause, good natural trigger terms, and excellent disambiguation against sibling skills. Its main weakness is modest action specificity — it states one core operation rather than enumerating what the sync concretely does.

DimensionReasoningScore

Specificity

The description names the domain ("current project" → "Obsidian wiki") and one concrete action ("Sync knowledge... distilled into the vault"), but does not list several specific operations (page distillation, cross-linking, manifest tracking), matching the 'names domain and 1-2 concrete actions' anchor. It is not the level above because it lacks the multi-action coverage of the score-4 anchor.

3 / 5

Completeness

Both "what" ("Sync knowledge from the current project into the Obsidian wiki") and "when" (explicit "Use when work already in the current project should be distilled into the vault") are present. Falls short of 5 because the when-clause is an abstract condition rather than concrete user trigger phrasing, though "@work update wiki" partially compensates.

4 / 5

Trigger Term Quality

Good natural keyword coverage: "wiki", "vault", "update wiki", "distill", "sync", plus the concrete trigger phrase "@work update wiki". Not a 5 because common synonyms like "notes", "knowledge base", or file/format terms are missing; not a 3 because the included terms are the phrases a user of this vault would actually say.

4 / 5

Distinctiveness Conflict Risk

The description carves a clear niche (current-project → vault) and explicitly routes against sibling skills ("wiki-capture saves the current conversation and wiki-ingest handles external/new sources"), giving distinct triggers with minimal conflict risk. It clearly matches the score-5 anchor rather than the minor-overlap wording of score 4.

5 / 5

Total

16

/

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

Ar9av/obsidian-wiki

Path

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