CtrlK
BlogDocsLog inGet started
Tessl Logo

knowledge-base

How to work in a Knowledge Base project (the `knowledge-base` starter pack). Read when the project has the three-layer source-grounded layout — `external-sources/` → `research/` → `articles/` — or when asked how this project is organized. Carries the layer model, per-folder rules, status flows, and log discipline so this guidance does NOT live inside template bodies or log.md. The three procedures live elsewhere: ingest in the platform `open-knowledge` skill, research and consolidate as their own sibling skills in this pack. Complements the platform `open-knowledge` skill; does not replace it.

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

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.

A tight, instruction-dense body: concrete frontmatter contracts, an explicit procedure-routing table, gated transitions between layers, and a copy-paste log template. Only slight trimming of the motivational framing would make it fully lean.

DimensionReasoningScore

Conciseness

Efficient overall: rules are stated imperatively with concrete field names (`status: draft`, `supersedes:`, `cluster: architecture`) and no tutorial padding. Minor trims possible — the Karpathy motivation paragraph ("Humans abandon wikis because maintenance costs exceed perceived value...") and the "Link at creation" scene-setting are rationale rather than instruction.

4 / 5

Actionability

Fully concrete, executable guidance: a procedure table mapping each layer to its skill and trigger conditions, exact frontmatter values per layer, a copy-paste log entry template, the exact call form `write({ document: { path, template: "<name>" } })`, and explicit link syntax for log entries. Nothing is left as vague direction.

5 / 5

Workflow Clarity

The ingest → research → consolidate loop is clearly sequenced via the layer diagram, the procedure table, and a "typical day-2 flow" walkthrough, with explicit decision checkpoints ("Don't chain silently. After ingest, ask whether to proceed to research") and a rule resolving STOP gates vs. session-level autonomy. The log discipline adds an audit-trail feedback mechanism (brokenLinkSuppression handling), so anchor 5 fits.

5 / 5

Progressive Disclosure

The body is a well-organized overview that deliberately delegates each procedure to its own skill one level deep ("Sibling skill `/research-with-sources`", platform skill's `references/ingest-and-sources.md`) — a clean split with clearly signaled navigation. No bundle files ship with this skill, and nothing that belongs elsewhere is inlined; sections are short and scannable.

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 with an explicit "Read when..." trigger tied to concrete project-layout signals, a clear statement of what the skill carries, and deliberate boundary-drawing against the platform skill and sibling procedures. Minor room to broaden natural trigger synonyms.

DimensionReasoningScore

Specificity

Names the domain (Knowledge Base project with the three-layer `external-sources/` → `research/` → `articles/` layout) and enumerates several concrete capabilities: "Carries the layer model, per-folder rules, status flows, and log discipline". It stops slightly short of anchor 5 because the described actions are what the skill carries rather than a fully comprehensive list of what it does with them.

4 / 5

Completeness

Explicitly answers both: what ("Carries the layer model, per-folder rules, status flows, and log discipline") and when ("Read when the project has the three-layer source-grounded layout... or when asked how this project is organized") with concrete trigger phrases. It even adds scope boundaries ("Complements the platform `open-knowledge` skill; does not replace it"), so anchor 5 fits better than 4.

5 / 5

Trigger Term Quality

Good natural trigger coverage: "Knowledge Base project", "when asked how this project is organized", and the folder names external-sources/research/articles a user would naturally mention. A few common phrasings (e.g. "wiki", "notes", "sources") are missing, so it falls between anchors 3 and 5.

4 / 5

Distinctiveness Conflict Risk

Clear niche: the description pins triggers to the specific three-folder layout, states where the three procedures live (platform `open-knowledge` skill and sibling skills), and explicitly says "Complements the platform `open-knowledge` skill; does not replace it" — minimal conflict risk.

5 / 5

Total

18

/

20

Passed

Validation

75%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 12 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 4 missing, 1 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

12

/

16

Passed

Repository
inkeep/open-knowledge
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.