CtrlK
BlogDocsLog inGet started
Tessl Logo

dld-kit/dld

Decision-Linked Development (DLD) — a workflow for recording, linking, and maintaining development decisions alongside code. Skills for planning, recording, implementing, auditing, and documenting decisions via @decision annotations.

68

Quality

68%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

Overview
Skills
Evals
Files

dld-audit

skills/dld-audit/SKILL.md

Discovery

42%

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 effectively communicates specific capabilities around detecting drift between decisions and code, with concrete actions like finding orphaned annotations and stale references. However, it critically lacks any 'Use when...' guidance, making it difficult for Claude to know when to select this skill. The trigger terms are somewhat technical and may not match natural user language.

Suggestions

Add a 'Use when...' clause with explicit triggers, e.g., 'Use when checking if documentation matches implementation, verifying ADRs are current, or auditing code annotations.'

Include more natural user phrases like 'outdated documentation', 'docs out of sync', 'architecture decision records', or 'verify decisions are implemented'.

Clarify what 'decisions' refers to (ADRs, design docs, annotations) to reduce potential conflicts with general documentation skills.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'Scan for drift', 'Finds orphaned annotations', 'stale references', and 'undocumented changes'. These are clear, actionable capabilities.

3 / 3

Completeness

Describes what the skill does but completely lacks a 'Use when...' clause or any explicit trigger guidance. Per rubric guidelines, missing explicit trigger guidance caps completeness at 2, and this has no 'when' component at all.

1 / 3

Trigger Term Quality

Contains some relevant technical terms like 'drift', 'orphaned annotations', 'stale references', but missing common user phrases like 'outdated docs', 'sync documentation', 'code comments out of date', or 'ADR' if applicable.

2 / 3

Distinctiveness Conflict Risk

The focus on 'decisions and code' drift is somewhat specific, but 'decisions' is vague and could overlap with documentation, architecture, or code review skills. The term 'annotations' could conflict with code comment or documentation skills.

2 / 3

Total

8

/

12

Passed

Implementation

77%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured audit skill with excellent workflow clarity and actionability. The step-by-step process is clear, includes proper edge case handling (unreachable commits), and provides concrete output templates. Minor improvements could be made in conciseness by trimming explanatory text and potentially extracting report templates.

Suggestions

Remove the explanatory sentence 'This helps catch situations where code evolved but decisions weren't updated' - the skill description already covers this

Consider extracting the report templates to a separate TEMPLATES.md file to reduce inline bulk

DimensionReasoningScore

Conciseness

The content is mostly efficient but includes some unnecessary explanation. Phrases like 'This helps catch situations where code evolved but decisions weren't updated' explain the obvious purpose. The report templates are useful but could be more compact.

2 / 3

Actionability

Provides concrete, executable bash commands throughout. Each step has specific scripts to run, exact output formats, and clear examples of what to look for. The report templates are copy-paste ready.

3 / 3

Workflow Clarity

Excellent multi-step workflow with clear sequencing (1-6). Includes validation handling for edge cases like unreachable commits, explicit error recovery guidance, and a clear remediation section. The 'if commit is unreachable' branch shows good feedback loop thinking.

3 / 3

Progressive Disclosure

Content is well-organized with clear sections, but the entire audit process is inline rather than referencing external documentation. The report templates could potentially be in a separate file. However, for a skill of this complexity, the inline approach is reasonable.

2 / 3

Total

10

/

12

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.