CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

wiki-stage-commit

Review staged wiki writes and promote accepted pages to final locations when WIKI_STAGED_WRITES is enabled. Use for staging approval/commit; rejected pages return to _raw/ for editing.

Quality

91%

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

92%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 excellent operational skill: exact CLI commands, revision-based concurrency guards, and an explicit conflict-recovery loop make the workflow safe and reproducible. The only ding is minor redundancy — a couple of rationale sentences and Notes bullets repeat points already made in the step bodies.

Suggestions

Trim the redundant Notes bullets that restate the patch refusal and index/log handling from Steps 3-4, keeping only the new information (template reuse, graph-view exclusion, staging.py location).

DimensionReasoningScore

Conciseness

The body is almost entirely operational (CLI commands, field tables, exit-code semantics) with no basic-concept padding, but a few spots could be trimmed: 'The whole point of the check is...' re-explains the revision check, and the Notes section repeats the patch-refusal and index/log points already made in Steps 3-4. Anchor 4 — efficient with minor instances of over-explanation.

4 / 5

Actionability

Fully executable throughout: exact commands with flags (--expect-staged, --expect-live, --expect-new), a field table for the inventory JSON, concrete conflict semantics (exit code 9 with 'conflict: ...' on stderr), and the rejection naming convention ('-2' suffix). The only non-mechanical step (patch merging) is explicitly justified as judgment work. Anchor 5.

5 / 5

Workflow Clarity

Clear sequence (config check -> inventory -> per-file review -> apply -> reconcile -> report) with strong validation for a batch/mutating operation: revision preconditions, the --expect-new guard against concurrent writers, and an explicit conflict-recovery loop (re-run staging list, show the user what changed, ask again) rather than blind retry. Anchor 5.

5 / 5

Progressive Disclosure

A single self-contained SKILL.md with nothing inlined that belongs in a separate file; sections are clearly organized and the one external pointer (the Config Resolution Protocol in llm-wiki/SKILL.md) is well-signaled and one level deep. No bundle files exist, and none are needed.

5 / 5

Total

19

/

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 description: it states concrete actions on both sides of the decision (promote accepted, return rejected) and gives an explicit 'Use for' trigger clause tied to a config flag. Minor gaps in capability coverage (list/inspect, patch merging) and a few missing natural trigger synonyms keep specificity and trigger quality just below top marks.

Suggestions

Add one more capability phrase such as 'inspect or list staged pages' to make capability coverage comprehensive.

Include a natural synonym in the trigger clause, e.g. 'Use for approving, rejecting, or committing staged wiki pages', to broaden trigger coverage.

DimensionReasoningScore

Specificity

Names three concrete actions — 'Review staged wiki writes', 'promote accepted pages to final locations', 'rejected pages return to _raw/' — plus a config gate, but coverage has minor gaps (listing/inspecting staged files and applying patches are unmentioned). Matches anchor 4 ('lists several specific actions; minor gaps'), not 5 since coverage isn't comprehensive.

4 / 5

Completeness

Explicitly answers both 'what' (review, promote, reject staged writes with rejected pages returning to _raw/) and 'when' ('Use for staging approval/commit... when WIKI_STAGED_WRITES is enabled'). Both are concrete and explicit, matching the anchor-5 example's structure.

5 / 5

Trigger Term Quality

'staged wiki writes', 'staging approval/commit', and 'WIKI_STAGED_WRITES' are natural phrases a user would say, but common variations like 'accept/reject staged pages' or 'pending wiki writes' are missing. Good coverage with a few natural terms absent — anchor 4.

4 / 5

Distinctiveness Conflict Risk

Clear niche (staging approval/commit) with distinctive tokens — WIKI_STAGED_WRITES, _raw/, promote — that separate it from general wiki-writing skills. Minimal conflict risk; the config gate further disambiguates.

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

Ar9av/obsidian-wiki

Path

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