CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

baoyu-translate

This skill should be used when the user asks to "translate", "翻译", "精翻", "translate article", "translate to Chinese", "translate to English", "改成中文", "改成英文", "convert to Chinese", "localize", "本地化", "refined translation", "精细翻译", "proofread translation", "快速翻译", "快翻", "这篇文章翻译一下", or provides a URL/file with translation intent. Supports three modes (quick/normal/refined) with custom glossary support.

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

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

The content is a strong example of an operational skill: dense reference tables, executable commands with placeholder-resolution rules, exact output contracts, and a well-signaled one-level-deep bundle. The only notable gaps are minor — slightly redundant preset-table columns and no explicit post-merge consistency check for chunked translations.

DimensionReasoningScore

Conciseness

The body is information-dense — defaults, modes, style/audience presets, and output artifacts are all conveyed via compact tables, with no explanation of concepts Claude already knows. Minor trimmable padding exists (the style and audience preset tables carry both a "Description" and an "Effect" column that partially restate each other), which matches anchor 4 rather than anchor 5's every-token-earns-its-place bar.

4 / 5

Actionability

Guidance is copy-paste ready: an executable chunking command with flags ("${BUN_X} {baseDir}/scripts/main.ts <file> [--max-words <chunk_max_words>] [--output-dir <output-dir>]") plus explicit resolution rules for both placeholders, exact artifact filenames for every mode, exact quoted user-facing messages, and concrete output templates (image-localization list, summary block). This fully matches anchor 5 for an instruction-based skill.

5 / 5

Workflow Clarity

The five-step workflow is clearly sequenced with numbered sub-steps, a BLOCKING first-time-setup gate before any translation, a quick-mode long-content warning with user confirmation, ordered chunk merging, and a genuine critique→revision feedback loop in refined mode. It falls short of anchor 5 because chunked (batch) translation has no explicit post-merge validation that chunks are complete and terminology stayed consistent.

4 / 5

Progressive Disclosure

SKILL.md is a well-organized overview that pushes details to six real, verified reference files (first-time-setup.md, extend-schema.md, glossary-en-zh.md, workflow-mechanics.md, subagent-prompt-template.md, refined-workflow.md) and a scripts/ directory containing the cited main.ts and chunk.ts. All references are one level deep, linked in markdown at their point of use, and inline content (mode/style/audience tables) is core operational material that belongs in the overview — matching anchor 5.

5 / 5

Total

18

/

20

Passed

Description

81%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 excels at trigger coverage and explicit use-when guidance, with bilingual natural phrases that make activation highly reliable. Its main weakness is the thin capability statement — it names three modes and glossary support but omits language pairs, content types, and outputs, leaving the 'what' under-specified relative to the strong 'when'.

Suggestions

Expand the 'what' with concrete actions, e.g. "Translates articles and documents between English and Chinese in three modes (quick/normal/refined), applying custom glossaries and producing a translated markdown file" — this would lift specificity and completeness together.

State the supported language pair(s) explicitly (EN↔ZH is only implied by trigger terms like "translate to Chinese"), so users with other target languages know whether the skill applies.

Mention the headline output artifact (a translation.md file with optional analysis/critique intermediate files) so the deliverable is clear from the description alone.

DimensionReasoningScore

Specificity

The capability statement is limited to "Supports three modes (quick/normal/refined) with custom glossary support" — the translation domain plus a couple of concrete features, but it never states what is translated (language pairs, content types, outputs). This matches anchor 3 (domain named with 1-2 concrete actions, not comprehensive); it is above anchor 2 because modes and glossary support are concrete, but below anchor 4 because no list of specific actions is given.

3 / 5

Completeness

Both parts are present: an explicit when-clause ("This skill should be used when the user asks to... or provides a URL/file with translation intent") with concrete trigger phrases, and a what-statement ("Supports three modes (quick/normal/refined) with custom glossary support"). The 'when' fully meets the anchor-5 bar, but the 'what' is a thin feature mention rather than a concrete action list (no language direction, content types, or outputs), placing this between anchors 4 and 5.

4 / 5

Trigger Term Quality

Seventeen natural trigger phrases span both English and Chinese — "translate", "翻译", "精翻", "translate to Chinese", "改成英文", "localize", "本地化", "proofread translation", "快翻", "这篇文章翻译一下" — plus "provides a URL/file with translation intent". This is comprehensive natural-term coverage including synonyms and colloquial variants users would actually say, matching anchor 5.

5 / 5

Distinctiveness Conflict Risk

Translation is a clear niche with distinct, mostly bilingual triggers ("精翻", "proofread translation", "改成中文") that would not fire for unrelated skills. Overlap risk is minimal — only generic terms like "localize" could conceivably collide with a dedicated localization skill, matching anchor 5.

5 / 5

Total

17

/

20

Passed

Validation

68%

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

Validation — 11 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 2 missing, 2 deeper-than-1-level

Warning

referenced_paths_exist

Referenced path issues: 4 deeper-than-1-level

Warning

Total

11

/

16

Passed

Repository

JimLiu/baoyu-skills

Path

skills/baoyu-translate/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.