CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

dsh-archive-agent-notes

Use when adding, auditing, pruning, archiving, restoring, or reviewing Agent Notes in deepseek-harness; checks every new note for superseded active records, classifies implemented notes by future decision value, deletes rejected notes that no longer prevent a tempting fallacy, and applies the frozen archived/{kind} triplet and manifest rules.

Quality

93%

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

The canonical home for this skill is dsh-archive-agent-notes in river666/deepseek-harness-enterprise

SKILL.md
Quality
Evals
Security

Quality

Content

93%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.

Excellent instruction-only skill body: concrete decision rules, calibrated examples, an exact archive procedure with validation commands, and clean external references. The single gap is the absence of explicit failure-handling steps after validation commands run.

DimensionReasoningScore

Conciseness

The body is lean and dense with policy that Claude could not infer (lifecycle outcomes, calibrated word-count examples, the frozen-triplet sealing rules); no filler or explanations of known concepts. Every section earns its tokens.

5 / 5

Actionability

Fully executable guidance: exact file moves ('Move the complete foo.md, foo.zh.md, and foo.i18n.yaml triplet from implemented/<kind>/ to archived/<kind>/'), exact metadata edits ('Insert only Archived: YYYY-MM-DD immediately below Status: implemented'), and exact commands ('pnpm run verify-archived-agent-notes --write', 'pnpm run doc-sync', 'pnpm run lint', 'git diff --check'). Classification rules are concrete with named examples.

5 / 5

Workflow Clarity

The archive procedure is a clear numbered 1-5 sequence with an embedded validation step (the append-only verifier 'first proves every existing seal still matches') plus a dedicated validate-and-report section, so the destructive/batch cap does not apply. Not 5 because explicit error-recovery feedback loops (what to do when a verifier or check fails) are not spelled out — a minor validation gap matching anchor 4 rather than the anchor-5 'if errors: fix and re-validate' pattern.

4 / 5

Progressive Disclosure

Well-organized sections with clearly signaled, one-level-deep references ('Read [the Agent Note rules](../../notes/README.md)', '[the archive instructions](../../notes/archived/AGENTS.md)', '[dsh-pre-push-checks](../dsh-pre-push-checks/SKILL.md)'); no content that belongs in a separate file is inlined, and navigation is easy.

5 / 5

Total

19

/

20

Passed

Description

92%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 strong description: explicit 'Use when' triggers covering the full note lifecycle, followed by concrete capability statements, all scoped to a distinct domain. The only minor weakness is slightly less exhaustive synonym coverage for trigger terms.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'adding, auditing, pruning, archiving, restoring, or reviewing', 'checks every new note for superseded active records', 'classifies implemented notes by future decision value', 'deletes rejected notes', 'applies the frozen archived/{kind} triplet and manifest rules' — giving comprehensive coverage of the skill's capabilities. Not the level below (4) because there are no meaningful gaps in the action inventory.

5 / 5

Completeness

Both 'what' and 'when' are explicit: the 'Use when adding, auditing, pruning, archiving, restoring, or reviewing Agent Notes in deepseek-harness' clause gives concrete trigger phrases, and the remainder states concretely what the skill does (supersession checks, classification, deletion, triplet/manifest rules). Clearly matches the anchor-5 example structure.

5 / 5

Trigger Term Quality

Good keyword coverage with natural lifecycle verbs users would say ('adding', 'archiving', 'pruning', 'restoring', 'reviewing', 'auditing') plus the domain object 'Agent Notes'. Not 5 because a few plausible natural phrasings (e.g., 'clean up', 'consolidate', 'supersede') are absent, and the extension-like artifacts are limited to the 'archived/{kind}' path pattern.

4 / 5

Distinctiveness Conflict Risk

A clear niche ('Agent Notes in deepseek-harness') with distinct, domain-specific triggers; no generic terms that would cause overlap with unrelated skills.

5 / 5

Total

19

/

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

relative_links

Relative link issues: 3 suspicious

Warning

Total

15

/

16

Passed

Repository

river666/deepseek-harness-enterprise

Path

.claude/skills/dsh-archive-agent-notes/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.