CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

wiki-builder

Start, structure, and grow a persistent research wiki indexed in pro-workflow's SQLite knowledge base. Each wiki is a folder of markdown pages with provenance, plus a shadow FTS5 index so any session can recall it. Use when the user says "start a wiki", "add to wiki", "compile a page", "wiki on X", or wants a long-lived knowledge base on a topic, paper, product, person, project, or codebase.

Quality

78%

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

Quality

Content

63%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.

The body is well-structured with executable CLI commands and a clear workflow, but it has two concrete integrity problems: the referenced `templates/` directory is absent from the bundle (breaking `init`), and `references/wiki-flavors.md` is never signaled from the body. The speculative auto-research section with version numbers also spends tokens on future functionality.

Suggestions

Add the `templates/` directory (wiki.config.md, index.md, sources.md, maintenance-log.md, prompts/) to the bundle, or remove the "See templates/" section — as bundled, `init_wiki.sh` cannot run because its template source directory does not exist.

Link `references/wiki-flavors.md` from the Flavors section (e.g., "Per-flavor folder layouts: see [wiki-flavors.md](references/wiki-flavors.md)") so the existing reference file is discoverable instead of orphaned.

Move the "Auto-research opt-in" section (Phase 3.3.0/3.3.1 version talk and a YAML block for a not-yet-shipped feature) out of SKILL.md into a reference file, restoring token efficiency and removing time-sensitive version numbers from the main body.

DimensionReasoningScore

Conciseness

Mostly efficient — the Locations, Layout, CLI surface, and Quality bar sections are tight and earn their tokens — but the "Auto-research opt-in" section spends ~10 lines on a feature that "Phase 3.3.0 ships builder + query only. Loop arrives in 3.3.1", i.e. time-sensitive version-anchored content about a capability that does not exist yet, which the guidelines penalize. Not 4 because that speculative block plus the version numbers are clear padding; not 2 because the rest of the body is lean with no explanations of concepts Claude already knows.

3 / 5

Actionability

The CLI surface gives fully executable commands ("node $SKILL_ROOT/scripts/wiki-cli.js init <slug> --title 'X' --flavor research [--scope project]"), the layout tree is concrete, and the workflow references real operations. Not 5 because "See `templates/`" points at a directory that does not exist in the bundle (init_wiki.sh copies from $skill_dir/templates, so `init` cannot actually run as bundled), and compile-page guidance is deferred to prompt files that are also only in the missing templates/. Not 3 because the commands that are present are copy-paste ready.

4 / 5

Workflow Clarity

The "Workflow when invoked" section gives a clear 6-step sequence (resolve action → read wiki.config.md → cite sources.md rows → call wiki-cli.js page to sync FTS → append maintenance-log entry → update index.md), with the FTS re-index acting as a sync checkpoint. Not 5 because there is no validation or error-recovery step (e.g., what to do when a citation is missing or the CLI write fails) for what is a batch-write operation; not 3 because the sequence is explicit, ordered, and each step names its artifact.

4 / 5

Progressive Disclosure

Scored against the actual bundle: the body references `scripts/wiki-cli.js` and `init_wiki.sh` (both real), but "See `templates/` for wiki.config.md, index.md, prompt files" is a dangling reference — no templates/ directory exists in the bundle — and `references/wiki-flavors.md` (109 lines of per-flavor layouts) is never linked from the body at all, so the reference is buried and the inline Flavors table partially duplicates its role. Not 4 because one reference is broken and one bundle file is undiscoverable; not 2 because the body itself is well-sectioned and short with most content appropriately placed.

3 / 5

Total

14

/

20

Passed

Description

83%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 that explicitly answers what the skill does and when to use it, with genuinely natural trigger phrases and concrete mechanism details (SQLite, FTS5, provenance). Minor room to improve by naming more capabilities (compile/ingest/query) and a few more trigger synonyms.

DimensionReasoningScore

Specificity

Quotes concrete actions and mechanisms — "Start, structure, and grow a persistent research wiki", "folder of markdown pages with provenance", "shadow FTS5 index so any session can recall it" — but stops short of comprehensive coverage (page compiling, source ingestion, and querying are absent from the description). Not 5 because several real capabilities are left unnamed; not 3 because it goes well beyond 1-2 actions by naming the storage format, provenance model, and indexing mechanism.

4 / 5

Completeness

Both questions are explicitly answered: what ("Start, structure, and grow a persistent research wiki indexed in pro-workflow's SQLite knowledge base... shadow FTS5 index") and when ("Use when the user says 'start a wiki', 'add to wiki', 'compile a page', 'wiki on X'...") with concrete trigger phrases. Matches the score-5 anchor exactly; the 'Use when' clause is explicit, so the completeness cap of 3 does not apply.

5 / 5

Trigger Term Quality

Natural trigger phrases are quoted directly — "start a wiki", "add to wiki", "compile a page", "wiki on X", "long-lived knowledge base on a topic, paper, product, person, project, or codebase" — the phrasing a user would actually say. Not 5 because common variations like "notes on X", "remember this topic", or "second brain" are missing; well above 3 since multiple natural phrasings plus a topic-type list are present.

4 / 5

Distinctiveness Conflict Risk

The wiki/FTS5/knowledge-base niche is mostly distinct with dedicated triggers ("start a wiki", "compile a page") that few other skills would claim. Not 5 because "long-lived knowledge base on a topic, paper, product, person, project, or codebase" is broad enough to overlap with generic research or note-taking skills; not 3 because the wiki-specific triggers make mis-triggering unlikely.

4 / 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

rohitg00/pro-workflow

Path

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