CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

data-structure-protocol

Give agents persistent structural memory of a codebase — navigate dependencies, track public APIs, and understand why connections exist without re-reading the whole repo.

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/data-structure-protocol/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

76%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 highly actionable, with executable CLI commands, clear workflow rules, and useful tables that cover setup, navigation, and maintenance comprehensively. Its main weakness is the absence of validation checkpoints around destructive and batch operations (remove-entity cascade cleanup, full-project bootstrap), despite shipping diagnostics commands that would serve that role. Progressive disclosure and conciseness are solid with only minor organization/trim opportunities.

Suggestions

Add validation checkpoints after destructive/batch operations, e.g. run `get-orphans` and `get-stats` after `remove-entity` or after bootstrap to confirm graph consistency, and re-verify `find-by-source` after `move-entity`.

Split the Key Commands table and full CLI flag documentation into a bundled reference file (e.g. references/commands.md), keeping SKILL.md as a lean overview that links to it.

Trim the Integration section or fold it into a single sentence, since it does not instruct the agent on any action.

DimensionReasoningScore

Conciseness

The body is dense and protocol-specific — storage layout, UID scheme, workflow rules, and command tables all carry information Claude does not already know. Minor trimmable parts exist (the Integration section and some conceptual prose like 'Everything is plain text. Diffable. Reviewable.'), placing it at anchor 4 rather than 5.

4 / 5

Actionability

Guidance is fully executable: copy-paste-ready bash commands in three examples, a complete command table by category, a change→DSP-action mapping table, and concrete workflow rules ('Call add-import with a brief why'). Common cases (setup, navigation, impact analysis) are all covered with runnable commands.

5 / 5

Workflow Clarity

Bootstrap has a clear 5-step sequence and update workflows are tabulated, but destructive and batch operations lack validation checkpoints: 'remove-entity' triggers automatic cascade cleanup and bootstrap traverses the whole project, yet the available diagnostics (get-stats, get-orphans, detect-cycles) are never wired in as verification steps. Per the judging guideline, missing validation in destructive/batch workflows caps this at 3.

3 / 5

Progressive Disclosure

The body is well-sectioned (concepts, setup, workflow, examples, best practices) with clearly labeled references (external ARCHITECTURE.md, CLI source, article). The inlined full command documentation could live in a separate reference file for a ~190-line SKILL.md, which is the minor gap keeping it at anchor 4 rather than 5.

4 / 5

Total

16

/

20

Passed

Description

58%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 clearly communicates what the skill does with several specific capabilities, but it lacks any explicit 'when to use' trigger guidance and misses the natural trigger phrases (DSP, .dsp, map structure, impact analysis) that the skill's own body identifies. Adding a 'Use when...' clause would resolve both the completeness cap and the trigger-term gaps.

Suggestions

Append an explicit trigger clause, e.g. 'Use when a .dsp/ directory exists, the user mentions DSP/dsp-cli, or when setting up, navigating, or updating a structural map of a project.'

Include natural synonyms and artifacts users would say: 'map the codebase', 'what depends on what', 'impact analysis', 'refactor safety', and the '.dsp' directory name.

Mention the maintenance loop ('keep the graph updated when creating, modifying, or deleting files') so the ongoing-use trigger is explicit, not just initial setup.

DimensionReasoningScore

Specificity

The description lists three concrete actions — 'navigate dependencies, track public APIs, and understand why connections exist' — in a clear domain. It is not comprehensive (bootstrap, graph updates, impact analysis are absent), which keeps it below 5, but it covers more than the 1-2 actions of anchor 3.

4 / 5

Completeness

The 'what' is clear ('persistent structural memory of a codebase'), but there is no 'Use when...' clause or equivalent explicit trigger guidance — 'without re-reading the whole repo' is a benefit statement, not a trigger. Per the judging guideline, a missing 'when' clause caps completeness at 3.

3 / 5

Trigger Term Quality

Terms like 'codebase', 'dependencies', and 'public APIs' are relevant, but common variations users would actually say are missing: DSP, '.dsp', 'map the project structure', 'refactor', 'impact analysis'. This matches anchor 3 (some relevant keywords but missing common variations or synonyms), below anchor 4's good coverage.

3 / 5

Distinctiveness Conflict Risk

'Persistent structural memory of a codebase' carves out a distinct niche, but 'navigate dependencies' could overlap with generic code-exploration or architecture skills, so it does not reach anchor 5's minimal conflict risk.

4 / 5

Total

14

/

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

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/data-structure-protocol/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.