CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

note-taking

How to work in a Plain Notes project (the `plain-notes` starter pack): a flat notes/ folder plus a daily/ journal. The 'I just want to write' layout. Read when the project has these folders, OR when asked to jot a note, capture a quick thought, or write today's journal entry. Carries the linking habit and daily-entry behavior so templates and folder descriptions stay minimal. Complements the platform `open-knowledge` skill; does not replace it.

Quality

85%

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.

An exemplarily lean instruction-only skill body: no padding, no explanations of things Claude already knows, and pack-specific behaviors (link-stubbing, yesterday-linking, frontmatter fields) stated concretely. The remaining gaps are small: unresolved template references, an unspecified note-naming convention, and a few implicit steps in the daily-entry workflow.

Suggestions

Link the 'note' and 'daily' templates by path (or show their structure inline) so the closing Templates section resolves to actual files.

Give a concrete note-file naming convention (e.g., kebab-case topic slug) so 'one file per topic, flat' produces consistent filenames.

Make the daily-entry workflow fully explicit — what pre-filling the date and the morning/evening sections look like — to remove the remaining implicit steps.

DimensionReasoningScore

Conciseness

The ~20-line body is lean and assumes Claude's competence: 'The lightest pack: no posture imposed, just write and link', 'one file per topic, flat', 'carry only structure; write freely'. Every sentence adds pack-specific behavior rather than explaining concepts Claude already knows, matching the 5 anchor; even 'OK's link graph builds itself from those edges' earns its place by justifying the linking rule.

5 / 5

Actionability

Guidance is concrete and executable for an instruction-only skill: journal entries as 'YYYY-MM-DD.md', 'link to yesterday's entry (its own dated file, e.g. 2026-07-08.md) and pre-fill the date', 'stub the page if it doesn't exist yet', and fill the named 'mood, top3, and gratitude' frontmatter fields. It falls short of 5 because note-file naming is unspecified ('one file per topic, flat' gives no convention) and the 'note' and 'daily' templates are mentioned without being shown or linked.

4 / 5

Workflow Clarity

As a simple single-purpose skill the core action is unambiguous (write files, link liberally), and the daily-entry behavior is sequenced ('on the first entry of a day, link to yesterday's entry... and pre-fill the date'). It sits at 4 rather than 5 because small steps remain implicit — what 'pre-fill the date' concretely produces, how the evening reflection is structured, and when to promote a note out of the flat layout ('later if you outgrow this' has no trigger).

4 / 5

Progressive Disclosure

The body is short and well-organized into 'Folders', 'Agent behaviors', and 'Templates' sections, which under the simple-skill guidance could merit a 5. It drops to 4 because the closing line references the 'note' and 'daily' templates without paths or links — a dangling reference that leaves navigation to those materials unresolved.

4 / 5

Total

17

/

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 both what and when, uses natural trigger phrases a user would actually say, and proactively scopes its relationship to the sibling `open-knowledge` skill. Minor room to grow by broadening trigger synonyms and spelling out more of the concrete behaviors (frontmatter fields, linking/stubbing).

DimensionReasoningScore

Specificity

The description lists several concrete actions and artifacts ('a flat notes/ folder plus a daily/ journal', 'jot a note, capture a quick thought, or write today's journal entry', 'Carries the linking habit and daily-entry behavior') with only minor gaps in coverage. It does not reach 5 because it stops short of enumerating the full behavior set (e.g., filling mood/top3/gratitude frontmatter) and 'How to work in a Plain Notes project' is partly structural framing rather than a concrete action.

4 / 5

Completeness

Both what and when are explicitly and concretely answered: what — 'How to work in a Plain Notes project... Carries the linking habit and daily-entry behavior so templates and folder descriptions stay minimal'; when — 'Read when the project has these folders, OR when asked to jot a note, capture a quick thought, or write today's journal entry' with concrete trigger phrases. It clearly matches the 5 anchor rather than 4, since the 'when' clause is already specific and multi-triggered, not something that 'could be more explicit'.

5 / 5

Trigger Term Quality

Natural user phrases are well covered: 'jot a note', 'capture a quick thought', 'write today's journal entry', plus folder-based triggers ('when the project has these folders'). Not a 5 because a few common synonyms users might say (e.g., 'diary', 'daily note', 'make a note') are missing, and no file-extension or naming triggers are given.

4 / 5

Distinctiveness Conflict Risk

It has a clear niche (the `plain-notes` starter pack) and explicitly manages the closest skill boundary: 'Complements the platform `open-knowledge` skill; does not replace it.' It stays at 4 rather than 5 because generic triggers like 'jot a note' and 'capture a quick thought' carry some overlap risk with other note-taking skills, and the folder-presence trigger depends on project layout.

4 / 5

Total

17

/

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/plain-notes/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.