CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

obsidian-homelab-logbook

Logs homelab events, changes, incidents, and maintenance notes to structured Obsidian notes.

Quality

74%

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/obsidian-homelab-logbook/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 is a lean, well-organized instruction for a simple skill, with a clear step sequence and thoughtful failure handling. Its main weakness is that the note template — the skill's core output artifact — is never defined, leaving the actual structured format implicit.

Suggestions

Add a short note template (frontmatter keys, heading structure) so the "structured" output format is concrete rather than implied.

Specify the tag naming conventions (e.g. status values and host tag prefixes) instead of just "Apply status and host tags".

Include one brief example of a filled-in incident note to anchor the expected output shape.

DimensionReasoningScore

Conciseness

The body is lean with no explanations of concepts Claude already knows, and the Failure Modes section is genuinely useful. It falls short of anchor 5 because the Inputs section duplicates Workflow Steps 1-2 (event type, timestamp, host/service, severity) and the Invocation section is agent-specific boilerplate that could be trimmed.

4 / 5

Actionability

There is concrete guidance (the note path pattern `Homelab/Logs/YYYY-MM-DD-event-title.md`, backlinking, tagging, MOC updates), but the central output artifact — the note's structure (frontmatter fields, headings, an example note) — is never specified, nor are tag naming conventions. This is a key-details gap rather than a minor one, matching anchor 3.

3 / 5

Workflow Clarity

The six workflow steps are clearly numbered and sequenced, and the Failure Modes section provides recovery paths (vault write conflict, missing host note). Not anchor 5 because there is no validation step confirming the note was written correctly or that backlinks resolve; not anchor 3 because the sequence and recovery guidance are solid.

4 / 5

Progressive Disclosure

This is a ~50-line, single-purpose skill with clean, well-organized sections and no need for external bundle files (references/ and scripts/ contain only .gitkeep), so per the simple-skill guideline, well-organized sections alone merit a 5. All content is appropriately placed in the single file.

5 / 5

Total

16

/

20

Passed

Description

66%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 is concise, specific, and names a clear niche, but it lacks any "Use when..." trigger guidance, which caps completeness and weakens its ability to fire at the right moment. It also does not differentiate itself from the companion `homelab-logbook` skill within the description itself.

Suggestions

Add an explicit trigger clause, e.g. "Use when logging a homelab change, incident, or maintenance event, or when the user mentions homelab events, outages, or their vault journal."

Include natural synonyms users would say — "vault", "journal", "logbook", "outage", "downtime" — to broaden trigger-term coverage.

State the distinction from `homelab-logbook` in the description (e.g. "Obsidian-native formatting and cross-linking") so the two skills are distinguishable at trigger time.

DimensionReasoningScore

Specificity

The description lists several concrete object types ("events, changes, incidents, and maintenance notes") and a specific destination ("structured Obsidian notes"), matching the several-specific-actions-with-minor-gaps anchor. It stops short of anchor 5 because covered types the body handles (VM/container state changes, network topology updates) are omitted.

4 / 5

Completeness

The "what" is clear (logs homelab events to structured Obsidian notes), but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. The "when" is entirely absent rather than weakly implied.

3 / 5

Trigger Term Quality

Good natural keyword coverage ("homelab", "incidents", "maintenance", "Obsidian", "notes") that users would plausibly say. Not anchor 5 because common synonyms and variations like "journal", "logbook", "vault", "outage", and "downtime" are missing.

4 / 5

Distinctiveness Conflict Risk

The homelab-plus-Obsidian logging niche is mostly distinct with clear scope. Not anchor 5 because the closely related companion skill `homelab-logbook` covers the same logging domain, and the description itself does not articulate the distinction (that only appears in the body's Purpose section).

4 / 5

Total

15

/

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

pvnkmnk/AgenticSelfHostSkills

Path

skills/obsidian-homelab-logbook/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.