CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

translate-docs-zh-en

Translate Chinese rtp2httpd docs into docs/en/ and synchronize English navigation, links, and terminology after source changes.

Quality

91%

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 body: lean, concrete, and complete. It specifies exact transformation rules with worked examples, covers all three task modes, and closes with an explicit verification checklist and build-validation feedback loop.

DimensionReasoningScore

Conciseness

The body is lean and instruction-dense — every sentence prescribes behavior ("Preserve heading hierarchy, lists, tables, qualifiers, and numeric values", "External URLs remain unchanged") with no explanation of concepts Claude already knows. It even tells the model to keep English concise, matching the top anchor.

5 / 5

Actionability

Guidance is fully concrete: exact link mappings (`/guide/quick-start` → `/en/guide/quick-start`), a worked asset-path example (`../images/foo.png` → `../../images/foo.png`), literal markup (`> [!NOTE]`), a real value translation (`group-title="央视"` → `group-title="CCTV"`), the exact config file (`docs/.vitepress/config.ts`), and the verification command `pnpm run docs:build`. For an instruction-only skill this covers the common cases copy-paste ready.

5 / 5

Workflow Clarity

The three task modes (new page, update via diff, batch) are delineated up front, sections proceed logically from content to links to navigation, and completion has an explicit checklist ("complete translation, valid links/assets, and preserved example behavior") plus a build-validate-fix loop: "Run `pnpm run docs:build` ... Correct failures caused by the translation before finishing." Validation is present for batch work, so no cap applies.

5 / 5

Progressive Disclosure

The short body is a well-organized overview with one clearly signaled, one-level-deep reference — [translation-memory.md](references/translation-memory.md), described with its purpose ("established terminology and alert conventions") and verified to exist — and the doc explicitly keeps that file limited to confirmed, reusable choices to prevent bloating.

5 / 5

Total

20

/

20

Passed

Description

78%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, specific description with clear concrete actions and a distinct niche. Its main weakness is the trigger phrasing: "after source changes" implies when but never states an explicit "Use when..." clause with the phrases a user would naturally say.

Suggestions

Add an explicit trigger clause, e.g., "Use when the user asks to translate or update the English docs after Chinese source pages change, or mentions the docs/en/ mirror."

Include a couple of natural synonyms such as "localization" or "English documentation" so the description matches how users are likely to phrase the request.

DimensionReasoningScore

Specificity

The description names several concrete actions — "Translate Chinese rtp2httpd docs into docs/en/" plus "synchronize English navigation, links, and terminology" — with only minor gaps (e.g., updating the terminology memory is not mentioned). It lists multiple specific actions but is a touch short of the comprehensive anchor 5.

4 / 5

Completeness

The "what" is clear and concrete, and a "when" is present via "after source changes", which acts as explicit trigger guidance. It falls short of anchor 5 because the trigger is a condition embedded in the what rather than an explicit "Use when..." clause covering how a user would phrase the request.

4 / 5

Trigger Term Quality

Natural terms a user would say are present: "Translate", "Chinese", "docs", "English", "navigation", "links", "terminology", "source changes". A few natural variants are missing (e.g., "localization", "i18n", "documentation"), so it sits at good-but-not-comprehensive coverage rather than anchor 5.

4 / 5

Distinctiveness Conflict Risk

"Translate Chinese rtp2httpd docs into docs/en/" carves out a clear niche — a specific project, direction, and target directory — with distinct triggers and minimal overlap risk with any other skill.

5 / 5

Total

17

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

stackia/rtp2httpd

Path

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