CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cs-wiki-librarian

Dispatched sub-agent that answers queries against an LLM Wiki vault. Reads index.md first, drills into 3-10 relevant pages across categories, synthesizes an answer with inline [[wikilink]] citations, and offers to file the answer back into the wiki as a new comparison or synthesis page. Spawn when the user asks a substantive question the wiki might answer, says "what does the wiki say about X", "compare A and B across my sources", or wants to explore a topic.

73

Quality

92%

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 tight, well-structured instruction body: lean role framing, a clearly sequenced 6-step workflow with a fallback search loop and a red-flags self-check list, plus concrete script commands. The gaps are minor but real: an unresolved `<plugin>` path placeholder, an unnamed index-update script, and no verification step after filing an answer back into the wiki.

Suggestions

Resolve or define the `<plugin>` placeholder (e.g., a one-line note mapping it to the llm-wiki plugin root) so the wiki_search.py and append_log.py commands are truly copy-paste ready.

In step 6, name the specific script for updating the index (parallel to the append_log.py invocation) or drop "via script" in favor of concrete inline-edit guidance.

Add a post-file verification checkpoint to the workflow — e.g., confirm the new page appears in index.md and optionally run the wiki lint — to close the feedback loop on the write path.

DimensionReasoningScore

Conciseness

The ~75-line body is lean and imperative throughout ("Read the index first. Do not grep the entire wiki on every query", "Every claim cites a page. No uncited assertions.") and assumes Claude's competence — no priming of concepts Claude already knows. Not 4: lines like "The wiki has done the hard work" are working guidance about trusting pre-synthesized pages, not trimmable padding.

5 / 5

Actionability

Mostly executable: exact script invocations ("python <plugin>/scripts/wiki_search.py --vault . --query \"<terms>\" --limit 5", the append_log.py command with args), a verbatim offer-to-file blockquote, and named frontmatter fields. Not 5: the `<plugin>` placeholder is never resolved to a concrete path, and "Update wiki/index.md (inline or via script)" leaves the script unnamed. Not 3: the commands given are real and copy-paste ready, not pseudocode.

4 / 5

Workflow Clarity

The 6-step workflow is clearly sequenced, with a fallback search loop (step 4) and a red-flags checklist giving explicit recovery actions ("Answering without reading the index → go back", "Citing only one source for a multi-source question → broaden"). Not 5: there is no validation checkpoint after the write path — nothing confirms the filed page landed in the index or passes lint. The destructive/batch cap at 3 does not apply since the write operations (create page, append log) are additive, not destructive.

4 / 5

Progressive Disclosure

Good structure: the body summarizes the workflow and delegates the full version and page templates to clearly signaled references ("Follow engineering/llm-wiki/skills/llm-wiki/references/query-workflow.md", page-formats.md) one level deep. Not 5: the referenced files live in another skill's bundle (this skill ships no references/, scripts/, or assets/ of its own), so the paths are long, repeated, and unverifiable from this skill's directory — a minor navigation gap.

4 / 5

Total

17

/

20

Passed

Description

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

An exemplary description: third-person voice, a comprehensive chain of concrete capabilities, and an explicit 'Spawn when...' clause with quoted natural-language triggers. It clearly communicates both what the sub-agent does and when it should be dispatched, with a distinct wiki-Q&A niche.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with specifics — "Reads index.md first, drills into 3-10 relevant pages across categories, synthesizes an answer with inline [[wikilink]] citations, and offers to file the answer back into the wiki as a new comparison or synthesis page" — covering the full read-select-synthesize-cite-file pipeline. Not 4: there is no noticeable coverage gap in the actions named.

5 / 5

Completeness

Both halves are explicit: the "what" is the concrete action chain, and the "when" is "Spawn when the user asks a substantive question the wiki might answer, says 'what does the wiki say about X'..." with concrete trigger phrases. This matches the anchor-5 exemplar structure exactly.

5 / 5

Trigger Term Quality

Natural user phrasings are quoted directly — "what does the wiki say about X", "compare A and B across my sources", "explore a topic" — alongside the synonym "substantive question the wiki might answer". Not 4: the quoted variants cover the query, compare, and explore phrasings users would actually say, not just a few keywords.

5 / 5

Distinctiveness Conflict Risk

The niche — answering queries against an LLM Wiki vault — is unmistakable, and the quoted triggers are wiki-specific, giving minimal conflict risk with other skills. Not 4: the only mildly broad clause ("or wants to explore a topic") stays anchored to "the wiki might answer", so overlap risk is minimal rather than minor.

5 / 5

Total

20

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/skills/cs-wiki-librarian/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.