CtrlK
BlogDocsLog inGet started
Tessl Logo

diks

Document infra work as Zettelkasten notes in the Infra repo. Trigger: documentar, runbook, incidente, postmortem.

65

Quality

78%

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 ./ywai/skills/diks/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 well-structured, lean instruction-only skill that uses progressive disclosure effectively via a task-to-reference table and includes explicit human-in-the-loop validation checkpoints. The main executable detail lives in the referenced files, which is appropriate but keeps body-level actionability just off the top.

Suggestions

Inline a minimal copy-paste note skeleton (frontmatter + section headings) so the most common case is executable without opening references/note-template.md.

Add an explicit error-recovery step (e.g., what to do when a target linked note does not exist or a commit fails) to push workflow_clarity to 5.

DimensionReasoningScore

Conciseness

The body is efficient and assumes Claude's competence, using lean lists and brief sections without explaining Zettelkasten/Obsidian basics; only minor stretches (the repo-path caveats and the repeated human-validation reminder) could be trimmed, keeping it just below the fully lean 5.

4 / 5

Actionability

Concrete, actionable guidance is present throughout (write to Infra/ relative to cwd, read DIKS_WIKI_PATH or ask, use <PASSWORD>/<API_KEY>/<TOKEN> placeholders, follow the 4-step output format), so it meets the mostly-executable bar; it is not 5 because the core note-writing procedure itself is delegated to references rather than shown inline.

4 / 5

Workflow Clarity

The Propósito section lays out a clear 5-step sequence with an explicit validation checkpoint ('El humano siempre valida antes de git add/commit/push') and the output format requires waiting for confirmation before writing to disk, satisfying most checkpoints; it is not 5 because error-recovery feedback loops are only implicit.

4 / 5

Progressive Disclosure

The body is a clean overview with a well-signaled references table mapping each task to a single one-level-deep file, and every referenced file (workflow.md, note-template.md, conventions.md, git-workflow.md, notebooklm.md) exists, giving easy navigation with no nesting.

5 / 5

Total

17

/

20

Passed

Description

78%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 concise, third-person description that clearly states both capability and trigger conditions with infra-specific keywords. It is slightly light on enumerating multiple concrete actions, which keeps specificity from the top tier.

Suggestions

Add 1-2 more concrete actions (e.g., 'structure atomic notes, link them to existing notes, generate the .md file in Infra/') to lift specificity toward 5.

Include a common synonym or file cue (e.g., 'wiki', 'nota', '.md') in the trigger list for fuller keyword coverage.

DimensionReasoningScore

Specificity

The description names the domain ('Document infra work as Zettelkasten notes in the Infra repo') and one concrete action (documenting as atomic notes), but does not enumerate multiple specific actions, so it stops at the 1-2 concrete actions anchor rather than the comprehensive coverage of 4-5.

3 / 5

Completeness

It explicitly answers both what ('Document infra work as Zettelkasten notes in the Infra repo') and when ('Trigger: documentar, runbook, incidente, postmortem') with concrete trigger phrases, matching the top anchor; it does not fall to 4 because the 'when' is explicit and specific rather than merely present.

5 / 5

Trigger Term Quality

'Trigger: documentar, runbook, incidente, postmortem' provides four natural keywords a Spanish-speaking infra user would actually say, giving good coverage though a few common synonyms (e.g. 'postmortem'/'retrospectiva', 'wiki', 'nota') are missing.

4 / 5

Distinctiveness Conflict Risk

The Zettelkasten/Infra niche with ops-specific triggers (runbook, incidente, postmortem) is mostly distinct with only minor overlap risk against generic documentation skills, so it sits just below the minimal-conflict 5 anchor.

4 / 5

Total

16

/

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
YoizenSA/dev-ai-workflow
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.