CtrlK
BlogDocsLog inGet started
Tessl Logo

hns-oss-docs-i18n-rules

HARD i18n rules digest for the oss-docs harness specialists working on moai-adk-go README 4-locale set and the docs-site (adk.mo.ai.kr). Covers the canonical-locale chains, the 4-locale same-PR obligation, Mermaid TD-only, the no-emoji + icon-shortcode rule, emphasis-marker spacing, the URL blacklist, version SSOT, vercel.json redirect pattern, and the immutable Vercel binding. Loaded FIRST by every oss-docs specialist before any edit.

58

Quality

67%

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

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/hns-oss-docs-i18n-rules/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

80%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 body is a lean, well-structured rules digest with concrete, executable specifics and explicit validation hooks for its batch/destructive obligations. Its main weakness is that the actual validate→fix→retry feedback loop is delegated to an external skill rather than inlined.

DimensionReasoningScore

Conciseness

Dense rule-list format with tables that assumes Claude's competence and explains no background concepts; time-sensitive dates are load-bearing operator decisions and staleness is explicitly quarantined in a Known-Stale section, so no token is wasted.

5 / 5

Actionability

Provides concrete executable specifics (exact forbidden URLs, exact icon-shortcode syntax, correct/wrong emphasis examples, redirect patterns), but enforcement leans on 'report back' rather than fix and delegates verification to an external skill.

4 / 5

Workflow Clarity

Each HARD rule states a clear obligation with its validation hook (locale-parity must_pass threshold, exit-gate verify recipe), giving clear sequencing for batch/destructive 4-locale edits; minor gaps because the validate→fix→retry loop itself lives in the referenced verify skill rather than inlined here.

4 / 5

Progressive Disclosure

Well-organized numbered sections in a single file with one-level-deep, clearly signaled references (SSOT doc and the verify skill); no nested or buried references, though the SSOT override relationship could be flagged even more crisply.

4 / 5

Total

17

/

20

Passed

Description

55%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 is specific and clearly occupies a distinct niche, but it leans on internal jargon and lacks an explicit natural 'when to use' trigger clause. Adding a plain-language 'Use when…' trigger with user-facing synonyms would lift the trigger and completeness dimensions.

Suggestions

Add an explicit 'Use when …' clause with natural phrases a user would say (e.g. 'Use when translating or editing the moai-adk-go README or the adk.mo.ai.kr docs-site across locales').

Replace or supplement internal jargon ('oss-docs harness specialists', 'canonical-locale chains') with user-facing synonyms ('docs translation', 'keep all 4 locales in sync').

Trim the status note 'Loaded FIRST by every oss-docs specialist before any edit' in favor of a concrete trigger condition.

DimensionReasoningScore

Specificity

Enumerates many concrete rules (canonical-locale chains, 4-locale same-PR obligation, Mermaid TD-only, no-emoji + icon-shortcode, emphasis-marker spacing, URL blacklist, version SSOT, vercel.json redirect pattern, immutable Vercel binding), but these are constraints to enforce rather than actions, and the 'Loaded FIRST…' status note is not a capability.

4 / 5

Completeness

The 'what' is clear (a HARD i18n rules digest covering a specific listed set), but there is no explicit 'Use when…' trigger; 'Loaded FIRST by every oss-docs specialist before any edit' is a load-order hint rather than a use condition, which caps completeness at 3.

3 / 5

Trigger Term Quality

Contains some domain keywords (i18n, README, docs-site, 4-locale) but is dominated by internal jargon (oss-docs harness specialists, moai-adk-go, canonical-locale chains, vercel.json redirect pattern) and lacks the natural phrases a user would actually say.

2 / 5

Distinctiveness Conflict Risk

Highly specific niche (oss-docs i18n for a named repo/docs-site) with distinct terminology, making conflict with other skills extremely unlikely.

5 / 5

Total

14

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository
modu-ai/moai-adk
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.