CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

dsh-prose-standard

Use when writing, reviewing, restoring, trimming, or auditing prose in the deepseek-harness repo, including deciding where documentation or comments are required across Markdown, JSDoc, code and test comments, prompts, descriptions, diagnostics, and CLI or UI strings.

Quality

85%

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-prose-standard in river666/deepseek-harness-enterprise

SKILL.md
Quality
Evals
Security

Quality

Content

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

A tightly written, repo-specific editorial standard: dense rules with no filler, copy-ready exclusion commands, and a validated 7-step workflow. The residual gaps are the absence of an explicit fix-and-revalidate loop, judgment guidance that stays abstract by delegating all worked examples to the reference file, and an inline-heavy coverage list.

DimensionReasoningScore

Conciseness

The body is lean and rule-dense ("Write enough to preserve the contract, then remove reasoning transcripts, repetition, and decoration") with every sentence carrying policy; the only definitions given ("A contract is an obligation, invariant, precondition, postcondition, or compatibility promise...") define repo-local terminology Claude cannot know. There is no padding, no restatement of concepts Claude already knows, and no over-explanation — matching the 5 anchor's "every token earns its place".

5 / 5

Actionability

Concrete, executable directives are present: exact command suffixes ("end ripgrep commands with `--glob '!vendor/**'`", "give Git commands an explicit `:(exclude)vendor/**` pathspec"), explicit input/mode handling, and a fixed classification taxonomy ("keep, add, trim, restore, restructure, or defer"). It is not a 5 because the core semantic-judgment guidance is inherently abstract and worked before/after examples are delegated to the external examples file rather than shown inline.

4 / 5

Workflow Clarity

The 7-step workflow is clearly sequenced with explicit validation in step 6 ("Run the narrow relevant checks, documentation gates, `git diff --check`, and behavior tests... Verify the final diff contains no `vendor/` path") and a feedback loop ("Re-check analogous passages after learning a new rule"). It stays at 4 rather than 5 because there is no explicit fix-and-re-validate loop when a check fails, and the reporting format in step 7 is a list of contents rather than a template.

4 / 5

Progressive Disclosure

The bundle matches the body: a single one-level-deep reference (references/examples.md) is well signaled ("For calibration or unfamiliar cases, read [the distilled examples](references/examples.md)") and external material (repo docs, sibling skills) is linked rather than duplicated. It is a 4 rather than 5 because the long per-location coverage list is fully inline and the examples reference is surfaced only in two spots rather than a dedicated navigation point.

4 / 5

Total

17

/

20

Passed

Description

83%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 trigger phrasing, a specific repo-scoped niche, and a comprehensive enumeration of the prose surfaces it covers. Its main weaknesses are generic editorial verbs carrying the action list, some missing natural synonyms, and no self-distinction from sibling documentation/trimming skills.

DimensionReasoningScore

Specificity

The description lists several actions ("writing, reviewing, restoring, trimming, or auditing prose") plus a coverage decision task enumerated across concrete surfaces ("Markdown, JSDoc, code and test comments, prompts, descriptions, diagnostics, and CLI or UI strings"). It falls short of a 5 because the verbs themselves are generic editorial actions rather than object-level concrete operations, leaving minor coverage gaps.

4 / 5

Completeness

It explicitly answers both what and when: an explicit "Use when" clause with concrete trigger phrases ("writing, reviewing, restoring, trimming, or auditing prose... including deciding where documentation or comments are required") states the activities, surfaces, and repo scope. This matches the 5 anchor's requirement of explicit what-and-when with concrete triggers; the 4 anchor applies when the 'when' is less specific.

5 / 5

Trigger Term Quality

Good keyword coverage of natural terms users would say: "prose", "trimming", "auditing", "documentation", "comments", "Markdown", "JSDoc", "prompts", "diagnostics", "CLI or UI strings". A few common synonyms are missing (e.g., "docs", "wording", "tighten", "prune"), which keeps it below the comprehensive 5 anchor.

4 / 5

Distinctiveness Conflict Risk

The repo scoping ("in the deepseek-harness repo") plus surface-specific terms ("JSDoc", "CLI or UI strings") gives it a mostly distinct niche. It stays at 4 rather than 5 because the description does not distinguish it from closely related sibling skills (dsh-doc-standards, dsh-trim-cot-leakage), so minor overlap risk remains.

4 / 5

Total

17

/

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: 5 suspicious

Warning

Total

15

/

16

Passed

Repository

river666/deepseek-harness-enterprise

Path

.claude/skills/dsh-prose-standard/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.