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
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'
| Dimension | Reasoning | Score |
|---|---|---|
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
| Dimension | Reasoning | Score |
|---|---|---|
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.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.