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-status

skills/dld-status/SKILL.md

Discovery

17%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This description provides a basic sense of the skill's domain (decision log management) but fails to include explicit trigger guidance and uses internal terminology rather than natural user language. The lack of a 'Use when...' clause and absence of user-facing trigger terms significantly limits Claude's ability to correctly select this skill.

Suggestions

Add an explicit 'Use when...' clause with natural trigger phrases like 'show my decisions', 'decision summary', 'what decisions have been made', 'review decisions'

Replace technical jargon ('decision log state', 'run tracking info') with user-friendly terms that describe what users actually see or ask for

Expand the capability list to be more specific about outputs, e.g., 'Shows total decision counts, lists recent decisions with timestamps, displays tracking statistics'

DimensionReasoningScore

Specificity

Names the domain (decision log) and some actions (counts by status, recent decisions, run tracking info), but lacks comprehensive detail about what specific operations are performed or what outputs are generated.

2 / 3

Completeness

Describes what it does (overview of decision log state) but completely lacks any 'Use when...' clause or explicit trigger guidance for when Claude should select this skill.

1 / 3

Trigger Term Quality

Uses technical/internal jargon like 'decision log state', 'run tracking info' that users wouldn't naturally say. Missing common trigger terms users might use like 'show decisions', 'decision summary', 'what decisions', 'list decisions'.

1 / 3

Distinctiveness Conflict Risk

'Decision log' is somewhat specific and wouldn't conflict with generic document or code skills, but 'overview' and 'state' are vague enough that it could overlap with other logging or status-related skills.

2 / 3

Total

6

/

12

Passed

Implementation

70%

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

This skill provides a well-structured overview of what to generate but relies heavily on Claude inferring implementation details for file operations. The workflow is clear and the output format is well-specified with examples, but the lack of concrete code for parsing YAML frontmatter and scanning directories reduces actionability. The content could be more concise by reducing example output verbosity.

Suggestions

Add a concrete code snippet showing how to parse YAML frontmatter from decision files (e.g., using Python's yaml module or a regex pattern)

Provide a brief code example for recursively scanning the decisions/records/ directory including namespace subdirectories

Consolidate the example output tables - show one complete example rather than separate examples for each section

DimensionReasoningScore

Conciseness

The skill is reasonably efficient but includes some redundant explanations (e.g., explaining what each section should contain with example tables that could be more compact). The repeated example output formats add length without adding much instructional value.

2 / 3

Actionability

Provides clear structure for what to output but lacks executable code for reading YAML frontmatter, scanning directories, or parsing state files. Claude must infer the implementation details for file reading and parsing operations.

2 / 3

Workflow Clarity

Clear sequential workflow: check prerequisites, read config, scan files, generate each section in order. The prerequisite check provides a validation checkpoint, and the sections are logically ordered with explicit conditional handling (namespaced vs flat, state file exists vs not).

3 / 3

Progressive Disclosure

Appropriate for a simple skill - well-organized with clear section headers, no external references needed, and content is structured logically from prerequisites through each output section. No monolithic walls of text.

3 / 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.