CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

diary

Unified Diary System: A context-preserving automated logger for multi-project development.

Quality

57%

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

Quality

Content

61%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 delivers a well-sequenced, concrete multi-step workflow with executable script commands and complete output templates, and it correctly pushes automation into bundled scripts. Its main weaknesses are repetitive 'force continue' padding, undefined path placeholders, and the absence of validation checkpoints around its destructive deletion and batch cloud-sync steps.

Suggestions

State the 'do not stop between steps' requirement once in the top-level constraint block and delete the redundant repetitions in Steps 1 and 1.5 to cut padding.

Add explicit validation checkpoints: after each script run, confirm expected output (e.g., 'verify fetch_diaries.py printed both Global and Project sections before proceeding') and verify the sync succeeded before moving to experience extraction.

Define how to resolve {diary_system_path} and {Knowledge_Base_Path} (e.g., where these values are configured), and add a one-line purpose note for each bundled script, including sync_to_notion.py.

DimensionReasoningScore

Conciseness

The body is instruction-dense and explains no concepts Claude already knows, but the 'do not stop between steps' mandate is repeated roughly four times (the One-Shot Integrity block with its worked failure example, '⚡ Force Continue' in Step 1, 'After Completion' in Step 1.5), with heavy ALL-CAPS/emoji emphasis padding. This fits 'Mostly efficient but... could be tightened' better than 2, since most sections carry real instructions, but the redundant repetition exceeds the 'minor instances' bar of 4.

3 / 5

Actionability

Concrete executable commands are provided for each automation step (pwd / (Get-Item .).Name, prepare_context.py with argument, fetch_diaries.py with absolute-path argument, master_diary_sync.py --sync-only) plus complete copy-paste markdown templates for both diary types and an acceptance checklist. It falls short of 5 because {diary_system_path} and {Knowledge_Base_Path} are never defined or resolved anywhere, and 'qmd embed (if applicable)' is left conditional and unexplained.

4 / 5

Workflow Clarity

The sequence is explicit and well-ordered (Steps 1, 1.5, 2, 3, 4) with an end-of-task acceptance checklist, but the workflow includes a destructive operation ('must force-delete any temporary files') and a batch cloud sync to Notion and Obsidian with no mid-workflow validation — no verification that prepare_context.py or fetch_diaries.py produced the expected output, no check that the sync succeeded, and no error-recovery loop. Per the rubric's cap for destructive/batch workflows without validation, clarity cannot exceed the 'sequence present but checkpoints missing' anchor.

3 / 5

Progressive Disclosure

Good structure: heavy automation is appropriately externalized into four real scripts on disk, three of which are referenced with concrete one-level-deep invocation paths; sections and templates are clearly organized with headers. It falls short of 5 because sync_to_notion.py is never mentioned, the scripts get no one-line description of purpose, and the ~65-line template section sits inline (defensible since it is used every run, but a minor organization gap remains).

4 / 5

Total

14

/

20

Passed

Description

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

The description reads as a product tagline rather than a functional trigger description: it identifies the domain but lists no concrete actions and omits any 'use when' guidance. Strong natural trigger phrases (dev log, daily review, Notion, Obsidian) that appear in the body are squandered by not being surfaced here.

Suggestions

Add an explicit 'Use when...' clause naming natural trigger moments, e.g. 'Use when the user asks to write a daily dev log, summarize session progress, or perform a daily review across projects.'

Replace the abstract label with 2-4 concrete actions the skill performs: writes project-local diary files, merges them into a global diary, and syncs to Notion and Obsidian.

Include natural synonyms and tool names users would actually say (dev log, daily log, journal, daily review, Notion, Obsidian) to improve trigger-term coverage.

DimensionReasoningScore

Specificity

The description "A context-preserving automated logger for multi-project development" names the domain (multi-project development logging) but offers only a generic characterization of the action — no concrete operations like "summarize progress", "write daily dev logs", or "sync to Notion/Obsidian" appear. It matches the anchor 'Names the domain but actions are minimal or generic'; it is above 1 because the domain is clearly identified, and below 3 because no concrete action verbs are listed.

2 / 5

Completeness

The 'what' is only a vague label ("context-preserving automated logger") and the 'when' is entirely absent — there is no "Use when..." clause or equivalent trigger guidance, which alone caps completeness at 3. Because the 'what' is also vague rather than clear, it drops to the anchor 'Has a vague what and no when', which matches better than 3.

2 / 5

Trigger Term Quality

Some relevant keywords are present ("Diary", "logger", "multi-project development") but natural user phrases are missing — "dev log", "daily log", "journal", "daily review", "summarize progress", and tool names (Notion, Obsidian) never appear, and "context-preserving" is jargon users would not say. This fits 'Some relevant keywords but missing common variations or synonyms', not 4, since natural trigger phrasing is largely absent.

3 / 5

Distinctiveness Conflict Risk

The multi-project diary/logging niche is somewhat specific, but since the description names no concrete artifacts, tools, or file types, it could still overlap with general journaling, note-taking, changelog, or logging skills. It fits 'Somewhat specific but could still overlap with similar skills'; it is above 2 because the domain is not as broad as 'document files', and below 4 because nothing pins it to a distinct trigger surface.

3 / 5

Total

10

/

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

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/diary/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.