CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

worldbuilding

How to work in a Worldbuilding project (the `worldbuilding` starter pack): a fiction encyclopedia of characters, settings, themes, factions, and lore. Read when the project has these folders, OR when asked to add a character, setting, faction, or piece of lore, or to check the world for internal consistency. Carries the auto-stub and consistency behaviors so that guidance does not live inside template bodies or folder descriptions. Complements the platform `open-knowledge` skill; does not replace it.

Quality

86%

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

80%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 exemplary lean instruction-only skill body: well-organized, concrete folder and template conventions with no padding and correct delegation to the platform skill. Its main gap is that the flagship auto-stub and contradiction-flagging behaviors are described as rules rather than as a sequenced workflow with checkpoints, leaving a few operational details to inference.

Suggestions

Add a short numbered auto-stub sequence (e.g., 1. Search existing entries for the mentioned name; 2. Pick the folder by entity type; 3. Create the stub with that folder's frontmatter fields; 4. Add backlinks to the mentioning entry) so the flagship behavior is a workflow rather than a rule.

Specify what a stub body and backlink look like with one small example, and state where a flagged contradiction should be recorded (conversation only vs. a dedicated entry or field).

Clarify how to check whether a name is already captured (e.g., a graph/keyword search step or an index file) so stub creation has an explicit validation checkpoint.

DimensionReasoningScore

Conciseness

The ~24-line body is lean and every section earns its place: folder conventions with their frontmatter fields, four behavioral rules, and one concrete template call. It assumes Claude's competence — no explanations of what wikis, templates, or graphs are — and even the flavor lines ("The 'where' of the story") compress real guidance. This matches the 5 anchor ("every token earns its place") rather than 4, where noticeable over-explanation would remain.

5 / 5

Actionability

Mostly concrete guidance: an exact API call (`write({ document: { path, template: "<name>" } })`), named shipped templates per folder, per-folder frontmatter fields, and an explicit prohibition on TTRPG stat-block fields. It falls short of fully executable because key operations are underspecified: what a stub's body/backlinks should look like, how to search for whether a name is "not yet captured", and what "surface the conflict" concretely means (file vs. conversation). This is the 4 anchor ("mostly executable; minor gaps"), not 3, since no pseudocode or vague-only direction appears.

4 / 5

Workflow Clarity

The core behaviors are individually unambiguous, but the auto-stub workflow is only implicit (mention → pick folder → stub with backlinks) rather than sequenced, and no checkpoints exist (e.g., how to verify a name is truly uncaptured before stubbing, or where a flagged contradiction gets recorded). This matches the 3 anchor ("sequence present but checkpoints missing or implicit"). It does not reach 4's "clear sequence with most checkpoints"; the destructive/batch cap does not apply since stubbing and flagging are additive, non-destructive operations.

3 / 5

Progressive Disclosure

Per the simple-skill guideline (under 50 lines, no external references needed), well-organized sections alone warrant a 5: the body is a clean overview with Folders, Agent behaviors, and Templates sections, no inlined content that belongs in separate files, and it correctly delegates platform mechanics to the `open-knowledge` skill instead of duplicating them. No bundle files (references/, scripts/, assets/) exist, and none are needed at this size.

5 / 5

Total

17

/

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 well-crafted description that explicitly answers both what the skill covers and when to read it, with concrete worldbuilding trigger terms and explicit disambiguation from the related platform skill. The only weakness is a slightly indirect "what" (behaviors the skill carries rather than a crisp action list) and a few missing natural synonyms.

DimensionReasoningScore

Specificity

The description names the domain concretely ("a fiction encyclopedia of characters, settings, themes, factions, and lore") and lists several specific capabilities and triggers ("add a character, setting, faction, or piece of lore", "check the world for internal consistency", "auto-stub and consistency behaviors"). It falls just short of the 5 anchor because the "what" is framed as what the skill carries rather than an exhaustive action list like the 5 example's "Extract text and tables, fill forms, merge documents".

4 / 5

Completeness

Both halves are explicit: the "what" ("a fiction encyclopedia of characters, settings, themes, factions, and lore", "carries the auto-stub and consistency behaviors") and a concrete multi-trigger "when" ("Read when the project has these folders, OR when asked to add a character, setting, faction, or piece of lore, or to check the world for internal consistency"). This mirrors the 5 anchor's structure of concrete what + explicit when with trigger phrases; it is well above the 4 anchor, where the "when" would be only broadly specified.

5 / 5

Trigger Term Quality

Strong natural trigger phrases: "add a character", "setting", "faction", "piece of lore", "check the world for internal consistency", plus the folder-based trigger ("when the project has these folders"). A few natural synonyms users might say are missing (e.g. "NPC", "location", "canon", "world map"), which matches the 4 anchor's "good keyword coverage; a few natural terms missing" rather than the comprehensive 5 anchor.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (worldbuilding fiction encyclopedia) and actively manages the one real overlap risk: "Complements the platform `open-knowledge` skill; does not replace it", plus a folder-based trigger that ties activation to this specific pack. Triggers (character/faction/lore/consistency) are unlikely to fire for unrelated skills, matching the 5 anchor's "clear niche with distinct triggers; minimal conflict risk".

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

inkeep/open-knowledge

Path

packages/server/assets/skills/packs/worldbuilding/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.