CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

wiki-update

Sync the current project's knowledge into the Obsidian wiki. Use this skill from any project when the user says "update wiki", "sync to wiki", "save this to my wiki", "update obsidian", or wants to distill what they've been working on into their knowledge base. This is the cross-project skill that lets you push knowledge from wherever you are into the vault.

Quality

87%

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

82%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 well-structured, highly actionable instruction-only skill: exact paths, commands, templates, and formats throughout, with a clear step sequence and meaningful pre-operation checkpoints. Minor improvements are possible in trimming duplicated frontmatter/provenance guidance and adding a post-sync verification step. The dangling references to sibling skills (llm-wiki, wiki-ingest) slightly weaken navigation.

DimensionReasoningScore

Conciseness

The body is dense and instructional with almost no explanation of concepts Claude already knows, but has minor trimmable redundancy: the summary frontmatter requirement appears both in the page-format template ("summary: >-" block) and again in a bolded paragraph, and the provenance guidance is likewise given twice (template block plus the "Apply provenance markers" section). This matches the score-4 anchor (efficient with minor instances of over-explanation) rather than 5, where every token would earn its place.

4 / 5

Actionability

Guidance is fully concrete: exact config keys ("OBSIDIAN_VAULT_PATH"), exact commands ("git log <last_commit>..HEAD --oneline"), exact file layouts (the projects/<project-name>/ tree), a copy-paste page frontmatter template, a JSON manifest schema, and an exact log-line format. This is an instruction-only skill and the guidance is copy-paste actionable, matching the score-5 anchor.

5 / 5

Workflow Clarity

The sequence (Before You Start → Steps 1–6 → Tips) is clearly numbered with pre-operation checkpoints: "If nothing meaningful changed since last sync, tell the user and stop", "Check index.md to see what's already there before creating anything new", and the merge-not-duplicate rule. It is not 5 because there is no post-sync verification step (e.g., confirming manifest/index/pages are consistent after writing) for what is a batch write across many vault files; it is not 3 because validation checkpoints are present, not absent.

4 / 5

Progressive Disclosure

With no bundle files, the skill is a single well-sectioned document with clear headers, a routing table for global categories, and a template block. It is not 5 because some content (the ~30-line page-format template and provenance rules) could live in a reference file, and the pointers to external material ("per `llm-wiki` (Provenance Markers section)", "the template in `wiki-ingest`") are dangling for readers without those resources. It is not 3 because the structure is good and nothing large is misplaced.

4 / 5

Total

17

/

20

Passed

Description

85%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 explicit what/when structure and comprehensive natural trigger phrases. Its main weakness is voice and action coverage: the second-person "lets you push" phrasing and the single restated action keep specificity low. The final sentence largely duplicates the first and adds tokens without new triggers or capabilities.

Suggestions

Rewrite in third person: replace "This is the cross-project skill that lets you push knowledge from wherever you are into the vault" with e.g. "Pushes knowledge from any project directory into the vault" to avoid the second-person penalty.

Enumerate the concrete actions performed, e.g. "Creates and merges wiki pages, applies provenance markers, cross-links related pages, and updates the vault manifest, index, and hot notes" instead of restating the single sync action.

Trim the redundant final sentence; it repeats the first sentence's meaning and adds no new triggers or capabilities.

DimensionReasoningScore

Specificity

The description names the domain ("Sync the current project's knowledge into the Obsidian wiki") but restates a single sync/push action rather than enumerating several concrete actions, matching the score-3 anchor; however, the second-person phrasing "lets you push knowledge from wherever you are into the vault" triggers the third-person voice penalty, reducing it to 2. It is not 1 because a concrete domain and action are clearly stated.

2 / 5

Completeness

Both parts are explicit: "what" is "Sync the current project's knowledge into the Obsidian wiki" and "when" is "Use this skill from any project when the user says [trigger phrases]". This matches the score-5 anchor with concrete trigger phrases, not 4 where the "when" would be less explicit.

5 / 5

Trigger Term Quality

It quotes multiple natural trigger phrases — "update wiki", "sync to wiki", "save this to my wiki", "update obsidian" — plus "distill what they've been working on into their knowledge base", covering verb variants (update/sync/save/distill) and noun variants (wiki/obsidian/knowledge base/vault) comprehensively. Score 4 would require natural terms to be missing, but the common user phrasings are all present.

5 / 5

Distinctiveness Conflict Risk

It carves out a clear niche — pushing project knowledge into the Obsidian vault — with distinct triggers ("update wiki", "update obsidian") and an explicit scope differentiator ("works from any project, not just the obsidian-wiki repo"). Conflict risk with unrelated skills is minimal, matching the score-5 anchor.

5 / 5

Total

17

/

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

saski/arnesto

Path

.agents/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.