CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

dsh-doc-standards

Use when writing, moving, reviewing, or auditing documentation in the deepseek-harness repo — choosing hierarchy and detail, separating tutorials from references, checking tutorial progression, trimming doc slop, responding to a verify-doc-budgets failure, or requests like "improve the docs", "audit the docs", "where should this be documented", or "this doc is too long".

Quality

94%

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-doc-standards in river666/deepseek-harness-enterprise

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exemplary workflow skill body: lean, densely prescriptive, correctly ordered with validation gates, feedback loops, and safety exclusions, and structured as an overview that delegates each source of truth to a clearly labeled one-level-deep link. The only shortfall is a couple of delegated or under-specified steps (PR base verification, the routine-path fragment) that keep actionability just short of fully copy-paste ready.

DimensionReasoningScore

Conciseness

The ~55-line body is dense and rule-bearing throughout — e.g. 'A move is atomic: remove from the old home, add to the new home, and fix every inbound link in the same change' and 'Exclude .agents/notes/archived/ from corpus audits and edits'. It assumes Claude's competence (no explanation of what Markdown or budgets are), delegates the standard itself to linked sources ('read, don't re-summarize'), and contains no padding or restated basics, matching 'lean and efficient; every token earns its place'.

5 / 5

Actionability

Mostly executable, copy-paste-ready commands: 'pnpm run verify-doc-budgets --list', "git ls-files '*.md' ':(exclude)vendor/**' | xargs wc -w | sort -rn | head -30", 'pnpm run doc-sync', 'pnpm run lint', 'git diff --check', 'pnpm run verify-translation-pairing --write <pair>'. Minor gaps keep it below anchor 5: 'Verify and fetch the PR's live base' gives direction without a command, and steps like the 'lightweight routine path' and 'relocate-condense-raise policy' are delegated to fragments in docs/AGENTS.md rather than stated inline. This sits between anchors 4 and 5, noticeably above the midpoint but not fully self-contained.

4 / 5

Workflow Clarity

The process is explicitly ordered — structural pass ('Apply the standard's authoring order'), then 'After the structural pass, hunt the standard's slop checklist', then 'Validation and PR hygiene' — with numbered steps inside each phase. Risky batch operations (doc moves, corpus-wide edits) have pre-validation ('Before renaming or moving any doc, grep for inbound references'), a feedback loop ('After a retarget or base merge, rerun the report and audit prose introduced by the new base'), a safety exclusion for the frozen archive, and a failure path section ('When verify-doc-budgets goes red'). This matches 'clear sequence with explicit validation steps; feedback loops for error recovery'.

5 / 5

Progressive Disclosure

The body is a workflow overview that pushes the standard itself to clearly signaled, one-level-deep references with per-link purpose descriptions: 'docs/AGENTS.md — hierarchy, tutorial/reference forms, taxonomy, budgets, and slop checklist', '.agents/notes/README.md — when a decision earns an Agent Note', 'docs/i18n/README.md — the bilingual pairing rules', plus three sibling skills. No content that belongs in a separate file is inlined and no reference is nested, matching 'clear overview with well-signaled one-level-deep references; easy navigation'. No bundle files exist in this skill directory, so the structure is the SKILL.md body itself.

5 / 5

Total

19

/

20

Passed

Description

96%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: it explicitly states both what the skill does and when to use it, packs in multiple concrete actions, and quotes the exact natural-language requests a user would make. Its only weakness is minor overlap risk with the closely related prose-standard skill on generic doc-improvement triggers.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'choosing hierarchy and detail, separating tutorials from references, checking tutorial progression, trimming doc slop, responding to a verify-doc-budgets failure' — plus the operation modes 'writing, moving, reviewing, or auditing documentation'. This matches the anchor 'lists multiple specific concrete actions; comprehensive coverage' for the documentation-governance domain; score 4 would require minor coverage gaps, and none are evident.

5 / 5

Completeness

It opens with an explicit 'Use when writing, moving, reviewing, or auditing documentation in the deepseek-harness repo' clause and closes with concrete quoted trigger requests, while the middle enumerates what the skill does. Both 'what' and 'when' are explicitly and concretely answered, matching the anchor-5 example pattern; the 'Use when' clause means the cap of 3 does not apply.

5 / 5

Trigger Term Quality

It includes verbatim natural request phrases users would actually say: '"improve the docs", "audit the docs", "where should this be documented", or "this doc is too long"', alongside the natural verb set 'writing, moving, reviewing, or auditing documentation' and the repo-specific gate name 'verify-doc-budgets'. Coverage of natural terms including direct quoted synonyms is comprehensive; score 4 would require clearly missing common variations, which is not the case.

5 / 5

Distinctiveness Conflict Risk

It is well-scoped ('in the deepseek-harness repo', 'responding to a verify-doc-budgets failure') giving it a clear niche, but generic triggers like '"improve the docs"' could also plausibly fire the sibling dsh-prose-standard skill (which the body says owns 'required coverage and editorial judgment'), and the description does not disambiguate against it. This fits 'mostly distinct; minor overlap risk with closely related skills' rather than the minimal-conflict anchor 5.

4 / 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: 12 suspicious

Warning

Total

15

/

16

Passed

Repository

river666/deepseek-harness-enterprise

Path

.claude/skills/dsh-doc-standards/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.