CtrlK
BlogDocsLog inGet started
Tessl Logo

wiki-init

One-time, guided setup of a standalone LLM-maintained wiki — a Karpathy "LLM Wiki" style knowledge base for a problem domain and your general architecture best practices. Scaffolds an external wiki vault (its own git repo) with /ingest, /query, /lint commands and a conventions doc. Use when a developer wants to start, create, bootstrap, or initialize a wiki / second-brain / knowledge base to understand a problem space before building. The front of the Human Loop's Understanding phase.

71

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

85%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 unusually well-engineered instruction-only skill: the guided flow is fully sequenced with approval checkpoints and feedback loops, the scaffold spec is exact down to directory and file names, and progressive disclosure is exemplary — all references are one level deep, signaled with read-order guidance, and exist on disk. The only real weakness is token efficiency: key constraints are repeated several times over, and the pattern/provenance narrative overlaps with what references/llm-wiki-pattern.md already carries.

Suggestions

Consolidate the repeated constraints: state 'never write into the app codebase / the wiki gets its own git repo / never clobber an existing wiki' once in Preconditions and once in Hard nevers, and drop the 3-4 restatements in Step 0, Step 4, and the Invocation contract.

Trim 'The pattern (and the credit)' to a 2-3 line summary pointing at references/llm-wiki-pattern.md, which already carries the provenance and kept-vs-changed details; keep only the Karpathy-credit-by-name instruction inline.

Compress P1–P8 to one line each with the fuller rationale moved to references/hardening-lessons.md (they already overlap it), keeping only the plain-language cue the skill says to surface during the session.

DimensionReasoningScore

Conciseness

The body is mostly efficient and specific to a novel skill (no filler explaining things Claude already knows), but it could be tightened: the same constraints repeat many times ("outside the app codebase" and "its own git repo" appear ~6 times, "never clobber" three times, the Karpathy credit three times), and 'The pattern (and the credit)' section restates content also carried in references/llm-wiki-pattern.md. It sits above the 2 anchor ('noticeably verbose; padded sections') because every section is on-topic, but below the 4 anchor because the repetition is a real token cost that trimming would eliminate without losing information.

3 / 5

Actionability

Guidance is fully concrete for an instruction-only skill: exact directory tree ("wiki/{concepts,entities,workflows,sources,indexes,inbox}/", "_meta/ingest-log.md"), exact asset templates to render, exact Step-1 interview questions, the exact user loop to teach ("/ingest <path-or-url>", "/query \"<question>\""), and re-run behavior. Per the rubric's instruction-skill note, the absence of code is not penalized when guidance is this actionable — specific steps cover both first-run and re-run cases, matching the 5 anchor.

5 / 5

Workflow Clarity

Steps 0–5 are clearly sequenced with an explicit validation checkpoint in the plan-pass ("Stop and wait for approval, unless --yolo"), a running explain → confirm → act → show → feedback rule for every write, a git-commit confirmation gate, and dedicated idempotency/re-run and hard-nevers sections. Feedback loops for the semi-destructive operations (scaffold writes, git init/commit, clobbering an existing wiki) are all present, matching the 5 anchor's explicit-checkpoints-and-recovery-loop profile.

5 / 5

Progressive Disclosure

The SKILL.md is a clear overview with well-signaled, one-level-deep references: read order is explicit ("Read first, before talking to the user: references/llm-wiki-pattern.md, references/hardening-lessons.md", then "load references/domain-discovery.md when you reach Step 1"), and every referenced path exists in the bundle (3 references, 4 asset templates, assets/commands/{ingest,query,lint}.md, gitignore.snippet). The canonical-vs-tailored split plus per-reference 'hackable seam' notes make navigation easy, matching the 5 anchor.

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 description: it concretely states what is scaffolded (external wiki vault, own git repo, /ingest /query /lint commands, conventions doc) and gives an explicit, multi-synonym 'Use when' clause. The only weaknesses are the trailing internal jargon ("The front of the Human Loop's Understanding phase"), which adds abstraction without trigger value, and a few missing natural synonyms.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Scaffolds an external wiki vault (its own git repo) with /ingest, /query, /lint commands and a conventions doc" — naming the artifacts produced. It falls just short of the 5 anchor because the trailing phrase "The front of the Human Loop's Understanding phase" is abstract jargon with no concrete referent, a minor coverage gap; it is well above the 3 anchor since multiple scaffold actions are explicitly enumerated.

4 / 5

Completeness

Both halves are explicit: the 'what' ("One-time, guided setup of a standalone LLM-maintained wiki... Scaffolds an external wiki vault... with /ingest, /query, /lint commands") and the 'when' with concrete trigger phrases ("Use when a developer wants to start, create, bootstrap, or initialize a wiki / second-brain / knowledge base to understand a problem space before building"). This matches the 5 anchor exactly; it is not the 4 anchor because the 'when' clause is explicit and trigger-phrase-driven, not merely implied.

5 / 5

Trigger Term Quality

Good natural-keyword coverage: "wiki / second-brain / knowledge base" and "start, create, bootstrap, or initialize" give users multiple synonymous phrasings they would actually say. A few natural terms are missing (e.g. "notes", "Zettelkasten", "Obsidian vault"), which keeps it at 4 rather than the comprehensive synonym-plus-extension coverage of the 5 anchor; it clearly exceeds the 3 anchor's 'some relevant keywords but missing common variations'.

4 / 5

Distinctiveness Conflict Risk

The niche is distinct — a one-time scaffold for a standalone LLM-maintained wiki with named slash-commands — and triggers ("start, create, bootstrap, or initialize a wiki / second-brain / knowledge base") are unlikely to fire for other skills. It matches the 5 anchor's 'clear niche with distinct triggers; minimal conflict risk'; overlap risk with generic documentation or note-taking skills is minimal given the explicit initialization framing.

5 / 5

Total

18

/

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
tdg-ninja/context-specs-factory-ai
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.