CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

dsh-translate-docs

Manually run the extended DeepSeek Harness bilingual-document workflow, including generated briefings, delegated prose translation, whole-document translation, and scoped pairing verification.

Quality

82%

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

SKILL.md
Quality
Evals
Security

Quality

Content

100%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 instruction-only skill: dense, rule-driven, and command-first, with triage that decides the path, explicit verification gates around every write, and clean one-level-deep delegation to the repo's i18n sources of truth. Every token earns its place.

DimensionReasoningScore

Conciseness

The ~63-line body packs a triage section, two full workflow paths, finishing steps, and review handling with zero padding and no explanations of concepts Claude already knows (e.g., 'Never re-translate a whole document to apply an update — a minimal update preserves the reviewed phrasing of everything that didn't change'). Every sentence states a binding rule or a command, assuming the reader's competence.

5 / 5

Actionability

Guidance is fully executable: concrete commands ('pnpm run gen-translation-brief --apply <pair>', 'pnpm run verify-translation-pairing --write <pair>', '--list', 'pnpm run doc-sync'), exact switcher-line formats ('[English](foo.md) | 中文'), explicit file paths, and precise terminology-column instructions for each target language. As an instruction-only skill, its guidance is copy-paste actionable.

5 / 5

Workflow Clarity

Change-type triage routes to two clearly numbered paths, each with explicit validation checkpoints and feedback loops: '--apply' 'structure-validates the result before writing', step 5's record-then-verify sequence, 'the gate goes red if you forget', and escalation rules for unanswerable briefings. Batch recording is explicitly guarded ('it refuses to run bare so a bulk re-record is always an explicit --all'), so the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

The body is a well-organized overview with clear triage-based navigation; detailed rules live one level deep in clearly signaled references, each introduced with its purpose ('the pairing contract', 'how to translate: faithfulness, structure preservation, terminology discipline…'). Nothing that belongs in a separate file is inlined, and no reference is buried.

5 / 5

Total

20

/

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 and specifically states what the skill does within a distinct niche, but provides no explicit when-to-use guidance and misses the natural trigger terms (languages, file extensions, sync/localize vocabulary) users would actually say. It sits solidly above the midpoint yet below the explicitly-triggered good examples.

Suggestions

Add a 'Use when…' clause or equivalent trigger guidance (e.g., 'Use when the user explicitly asks to translate or re-sync DeepSeek Harness documentation pairs'), since its absence currently caps completeness at 3.

Include natural trigger vocabulary users would say: 'Chinese', 'English', '.zh.md', 'translate', 'sync', 'localization' — currently only 'bilingual' and 'translation' appear.

Briefly unpack the jargon components ('briefings', 'pairing verification') so the capability list reads as concrete actions rather than internal workflow terminology.

DimensionReasoningScore

Specificity

'generated briefings, delegated prose translation, whole-document translation, and scoped pairing verification' names several concrete actions in a specific domain. Not 5: the terms are internal jargon ('briefings', 'pairing verification') without unpacking, and sub-capabilities like the mechanical '--apply' path are not represented.

4 / 5

Completeness

The 'what' is clear (manually run the workflow with its four named components), but there is no 'Use when…' clause or equivalent explicit trigger guidance; 'Manually run' only weakly implies the invocation context. Per the rubric guideline, a missing trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

Relevant keywords exist ('bilingual-document', 'translation', 'prose translation', 'whole-document translation') but common natural variations are missing: 'Chinese', 'English', '.zh.md', 'translate', 'sync', 'localize'. This matches the anchor for some relevant keywords missing common synonyms, rather than 4 where only a few natural terms are absent.

3 / 5

Distinctiveness Conflict Risk

'DeepSeek Harness bilingual-document workflow' plus 'pairing verification' carves a distinct niche with minimal conflict risk. Not 5: anchor-5 requires distinct trigger phrases, which the description lacks, and generic wording like 'prose translation' leaves minor overlap risk with a general translation skill.

4 / 5

Total

14

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 2 missing, 14 suspicious

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

river666/deepseek-harness-enterprise

Path

.agents/skills/dsh-translate-docs/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.