CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

78%

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

68%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 tight, highly actionable rules digest with excellent correct/wrong examples and clearly quarantined stale-facts, appropriate for a small self-contained skill with no bundle files. Its weakest area is workflow clarity: the 4-locale batch obligation and release-sync duties have no inline step sequence or validation checkpoints, relying on a named external verify skill instead.

Suggestions

Add a short numbered workflow for the 4-locale obligation (author in ko → derive en/ja/zh → run the verify recipe's checks before handoff) so the batch edit path has inline validation checkpoints instead of delegating entirely to Skill 'hns-oss-docs-verify' by name.

Trim date-laden provenance ('operator decision 2026-08-17', 'card t47', 'operator decision 2026-08-18') from sections 1 and 7, or move it into the Known-Stale/provenance section, to keep the operative rules free of time-sensitive detail.

Include a concrete two-line vercel.json redirect example (locale-aware plus non-locale fallback) so rule 8 is copy-paste ready rather than pattern-only.

DimensionReasoningScore

Conciseness

A dense, lean rules digest where nearly every token is rule content ('Allowed: `flowchart TD`, `graph TB`. Forbidden: `LR` / `RL` directions') with no padding explaining concepts Claude already knows; however time-sensitive specifics outside a deprecation section ('operator decision 2026-08-17', 'operator decision 2026-08-18', 'card t47') warrant a minor penalty, keeping it at anchor 4 rather than 5 — though stale facts are properly quarantined in the Known-Stale section.

4 / 5

Actionability

Rules are concrete and largely executable — exact canonical-chain table, correct/wrong emphasis examples ('Correct: `**바이브코딩** (Vibe Coding)` — parenthetical OUTSIDE the markers'), icon shortcode syntax, and redirect path patterns — but there is no full vercel.json snippet and the checks are delegated by name ('run the inlined checks in Skill("hns-oss-docs-verify") instead'), so it fits anchor 4 rather than the fully copy-paste-ready anchor 5.

4 / 5

Workflow Clarity

The rules are clearly numbered and organized but there is no step sequence for the 4-locale batch edit obligation, and validation is only delegated by reference ('The verify recipe's version-string check (Skill "hns-oss-docs-verify" §6) enforces this at the exit gate') rather than inlined as checkpoints — matching anchor 3 ('checkpoints missing or implicit'), and the batch 4-locale/deploy context without explicit validation steps caps it at 3.

3 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent) and the body is self-contained with a clearly signaled one-level-deep SSOT pointer at the top ('SSOT: `.moai/docs/docs-site-i18n-rules.md`') plus a dedicated stale-facts section — good structure matching anchor 4; minor gaps (cross-skill references by name only) keep it below the fully well-signaled anchor 5.

4 / 5

Total

15

/

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 highly specific, niche-scoped description that clearly states what it covers and when it is loaded, with strong trigger terminology for its target audience. Its main weakness is enumerating covered topics rather than concrete actions, and relying on project-specific jargon over broadly natural keywords.

DimensionReasoningScore

Specificity

Enumerates many specific covered items ('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'), but lists topics covered rather than concrete executable actions, so it fits anchor 4 rather than 5 and is clearly above anchor 3's 1-2 actions.

4 / 5

Completeness

The 'what' is clear (a HARD i18n rules digest covering nine enumerated rules) and the 'when' is explicitly present ('Loaded FIRST by every oss-docs specialist before any edit'), so it avoids the missing-trigger cap of 3; however the trigger is a load-order directive for specialists rather than a concrete user trigger phrase, keeping it at anchor 4 rather than 5.

4 / 5

Trigger Term Quality

Contains good natural domain keywords ('i18n', 'README', '4-locale', 'docs-site', 'Mermaid', 'Vercel', 'emoji', 'URL blacklist') that a contributor on this repo would say, but coverage is heavy on project-specific jargon ('oss-docs harness specialists', 'adk.mo.ai.kr') and misses common synonyms like 'translation' or 'localization', placing it at anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

Scoped to the 'moai-adk-go README 4-locale set and the docs-site (adk.mo.ai.kr)' — a clear niche with distinct triggers and minimal conflict risk with any general skill, matching anchor 5.

5 / 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

allowed_tools_field

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

Warning

Total

15

/

16

Passed

Repository

modu-ai/moai-adk

Path

.claude/skills/hns-oss-docs-i18n-rules/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.