New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Hns Oss Docs I18n Rules

by modu-ai in modu-ai/moai-adk

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).

Apache-2.0Auto-check: notesFrontend & Design

Install Hns Oss Docs I18n Rules

skills CLI
$ npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rules -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install modu-ai/moai-adk hns-oss-docs-i18n-rules --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/modu-ai/moai-adk.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/hns-oss-docs-i18n-rules .claude/skills/hns-oss-docs-i18n-rules && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
hns-oss-docs-i18n-rules
GitHub stars
1.2k
Token cost
~1.2k tokens
SKILL.md length
488 words
Files
1
Skills in repo
48
Repo updated
First seen
Licence
Apache-2.0

At a glance

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).

  • Works in 9 steps: Canonical-locale chains [HARD] → 4-locale simultaneous-update obligation… → Mermaid TD-only [HARD] → …
  • Tasks that involve Internationalization
  • SKILL.md covers 1. Canonical-locale chains…, 2. 4-locale…, 3. Mermaid TD-only [HARD] and 4. No emoji in body text [HARD], plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Hns Oss Docs I18n Rules is an agent skill from modu-ai/moai-adk. 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.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Frontend & Design, covering Internationalization, Diagrams and Static sites and blogs. It works with Vercel and Mermaid. The repository describes itself as: Agentic development harness for Claude Code — SPEC-driven plan/run/sync, TRUST 5 quality gates, model+effort routing, and Claude×GLM multi-LLM cost control. Single Go binary, 16… The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Internationalization
  • Tasks that involve Diagrams
  • Tasks that involve Static sites and blogs

Example prompts

  • “/hns-oss-docs-i18n-rules”

Requirements

  • Pre-approved tools (allowed-tools): Read, Grep, Glob, Bash

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. Canonical-locale chains [HARD]
  2. 4-locale simultaneous-update obligation [HARD]
  3. Mermaid TD-only [HARD]
  4. No emoji in body text [HARD]
  5. Emphasis-marker spacing [HARD]
  6. URL blacklist [HARD]
  7. Version SSOT [HARD]
  8. Moved pages need redirects [HARD]
  9. Vercel binding immutable [HARD]

What it can do on your machine

Read from SKILL.md and the folder at commit 2aab5f7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Grep
    • Glob
    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Hns Oss Docs I18n Rules loads about 1.2k tokens when it runs. Until then it costs about 116 tokens; SKILL.md has 488 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~116
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Grep, Glob, Bash

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from modu-ai/moai-adk at commit 2aab5f7, republished under its Apache-2.0 licence (© modu-ai). 488 words, ~1,210 tokens.

Download SKILL.mdSave it as .claude/skills/hns-oss-docs-i18n-rules/SKILL.md (or your agent's skills folder).
name
hns-oss-docs-i18n-rules
description
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.
allowed-tools
Read, Grep, Glob, Bash
user-invocable
false
metadata.version
1.1.0
metadata.category
harness
metadata.status
active
metadata.updated
2026-08-17
metadata.tags
oss-docs,i18n,4-locale,readme,docs-site,adk.mo.ai.kr

oss-docs HARD i18n Rules

SSOT: .moai/docs/docs-site-i18n-rules.md (+ CLAUDE.local.md §17.1 for the design/icon regime). This skill is the working digest; on conflict, the SSOT wins — EXCEPT the two stale items in § Known-Stale below, where reality wins.

1. Canonical-locale chains [HARD]

SurfaceCanonicalDerivation chainDerived files
docs-sitekoko → en → ja/zh, same PRdocs-site/content/{en,ja,zh}/
READMEko (README.ko.md)ko → en/ja/zh, same PRREADME.md, README.ja.md, README.zh.md

README canonical flipped en → ko by card t47 (operator decision 2026-08-17): the ko new-skeleton (12-section feature-oriented structure) was promoted to canonical, and en/ja/zh are re-derived from it. Both surfaces are now ko-canonical — the surface chains agree.

  • Author in the canonical locale only; derive the rest. Never "fix" canonical content inside a translation — report the discrepancy back instead.

2. 4-locale simultaneous-update obligation [HARD]

Every canonical content change MUST land in all 4 locales in the same PR. A canonical edit without its 3 derived counterparts is a locale-parity FAIL (sprint contract locale-parity threshold 1.0, must_pass).

3. Mermaid TD-only [HARD]

  • Allowed: flowchart TD, graph TB.
  • Forbidden: LR / RL directions (flowchart LR, graph LR, flowchart RL, graph RL).
  • Translation preserves diagram direction verbatim.

4. No emoji in body text [HARD]

  • Use the icon shortcode instead: {{</* icon <name> [variant] */>}} (defined in docs-site/layouts/shortcodes/icon.html; variants: ok|warn|danger|primary|muted).
  • Preserved (NOT emoji — do not strip): typographic symbols → ← ↓ ✓ ✗, and branding emoji inside MoAI orchestrator-banner example code blocks.

5. Emphasis-marker spacing [HARD]

  • Correct: **바이브코딩** (Vibe Coding) — parenthetical OUTSIDE the markers.
  • Wrong: **바이브코딩(Vibe Coding)**.

6. URL blacklist [HARD]

Only adk.mo.ai.kr is a valid docs-site domain. Forbidden (all occurrences, including link labels and translated prose):

  • docs.moai-ai.dev
  • adk.moai.com
  • adk.moai.kr
Show full SKILL.md (231 more words)Show less

7. Version SSOT [HARD]

docs-site/hugo.toml params.version / params.releaseDate is the single version surface. Never hardcode divergent version/date strings into pages, menus, or READMEs beyond what the release process syncs.

Release-sync obligation (operator decision 2026-08-18): every release updates ALL version DISPLAYS to the release number in the same PR — hugo.toml version + releaseDate together (the file's own two-line contract), the README release badges (all 4 locales), and in-page example outputs that show the product version (statusline examples 🗿 vX.Y.Z, update-prompt examples X ⬆️ Y, version-column example values). Historical citations ("introduced in vX.Y.Z", "retired in v3.0.0", "default-on since v3.0.0") are NOT displays and stay untouched. The verify recipe's version-string check (Skill "hns-oss-docs-verify" §6) enforces this at the exit gate.

8. Moved pages need redirects [HARD]

Every docs-site page move/rename adds to docs-site/vercel.json:

  1. Locale-aware: /:locale(ko|en|ja|zh)/old-path → /:locale/new-path
  2. Non-locale fallback: /old-path → /ko/new-path

9. Vercel binding immutable [HARD]

The Vercel project binding and deployment config are never changed by this harness (redirects array excepted). Push = production deploy at adk.mo.ai.kr, which is why specialists NEVER commit/push — publishing is human-gated.

Known-Stale items in the SSOT doc

The SSOT .moai/docs/docs-site-i18n-rules.md predates the current site and carries 2 stale facts — reality wins:

  1. It says the theme is Hextra → reality: hugo-geekdoc.
  2. It says config is hugo.yaml → reality: docs-site/hugo.toml (defaultContentLanguage=ko).

Also: the scripts docs-i18n-check.sh and gen_menu.py referenced there DO NOT exist. Never shell out to them — run the inlined checks in Skill("hns-oss-docs-verify") instead.

© modu-ai, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/hns-oss-docs-i18n-rules of modu-ai/moai-adk.

Open the folder on GitHubat commit 2aab5f7

Compare with similar skills

Hns Oss Docs I18n Rules next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Hns Oss Docs I18n Rules compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hns Oss Docs I18n Rules this skillmodu-ai/moai-adk1.2k—~1.2kAutomated safety check: NotesApache-2.0
Create Docsvictorgarciaesgi/nuxt-typed-router4132 repos~2.8kAutomated safety check: PassMIT
Nextjs Nextra Starter Distillpdsuwwz/nextjs-nextra-starter318—~596Automated safety check: PassMIT
Nextjs Nextra Starter Distill Zhpdsuwwz/nextjs-nextra-starter318—~313Automated safety check: PassMIT
Previewhanamizuki/solopreneur152—~5.2kAutomated safety check: PassMIT
Update Web Assetsgarfiec/Librechat-Mobile111—~1.8kAutomated safety check: NotesMIT

Similar skills

  • Create Docs

    victorgarciaesgi/nuxt-typed-router

    Create complete documentation sites for projects. An agent skill from victorgarciaesgi/nuxt-typed-router.

    413 GitHub starsUsed in 2 repos~2.8k tokens
    Frontend & DesignAuto-check passed

  • Nextjs Nextra Starter Distill

    pdsuwwz/nextjs-nextra-starter

    Distill and apply this repository's Next.js Nextra starter architecture, implemented features, extension points, and migration patterns.

    318 GitHub stars~596 tokensUpdated 23 days ago
    Frontend & DesignAuto-check passed

  • Nextjs Nextra Starter Distill Zh

    pdsuwwz/nextjs-nextra-starter

    蒸馏并应用当前仓库的 Next.js Nextra 启动模板架构、已实现功能、二次开发扩展点与迁移模式。适用于理解本项目、继续二次开发、修改 docs/landing/i18n/theme/auth/UI 行为，或把这些 Next.js 16 + Nextra 4 + Tailwind CSS 4 模式复用到其他项目。

    318 GitHub stars~313 tokensUpdated 23 days ago
    Frontend & DesignAuto-check passed

  • Preview

    hanamizuki/solopreneur

    Create an interactive HTML preview of any proposal, plan, idea, doc, brief, or spec and land it in the browsable local Preview Library by default (opens under file:// with a catalog sidebar and…

    152 GitHub stars~5.2k tokensUpdated 14 days ago
    Frontend & DesignAuto-check passed

  • Update Web Assets

    garfiec/Librechat-Mobile

    Update the third-party JavaScript vendored into the app for the artifact, diagram, and math WebViews (KaTeX, mermaid, marked, highlight.js, Tailwind, Babel, React).

    111 GitHub stars~1.8k tokensUpdated yesterday
    Frontend & DesignAuto-check: notes

  • Frontend Design Ultimate

    aAAaqwq/AGI-Super-Team

    Create distinctive, production-grade static sites with React, Tailwind CSS, and shadcn/ui — no mockups needed.

    105 GitHub starsUsed in 2 repos~2.7k tokens
    Frontend & DesignAuto-check passed

More from modu-ai/moai-adk

All 48 skills in this repo

  • SVG Technical Infographic Author

    modu-ai/moai-adk

    Builds hand-editable SVG diagrams from computed layout coordinates, lints the source and renders a 2x PNG, with rules for when mermaid is the better choice.

    1.2k GitHub stars~5.2k tokensUpdated yesterday
    Auto-check: notes

  • MoAI Foundation Core

    modu-ai/moai-adk

    Reference for MoAI-ADK's core development principles: TRUST 5 quality gates, SPEC-first domain-driven workflow, agent delegation and token budgeting.

    1.2k GitHub stars~5k tokensUpdated yesterday
    Auto-check passed

  • MoAI SPEC Workflow

    modu-ai/moai-adk

    Manages SPEC documents for MoAI-ADK development, with GEARS or EARS requirement notation, acceptance criteria and a link into the Plan-Run-Sync workflow.

    1.2k GitHub stars~5.1k tokensUpdated yesterday
    Auto-check passed

  • MoAI TDD Workflow

    modu-ai/moai-adk

    Drives test-first development through the RED, GREEN, REFACTOR cycle, with a config switch that selects between TDD and a DDD workflow for existing code.

    1.2k GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed

  • MoAI Worktree Management

    modu-ai/moai-adk

    Gives each SPEC its own Git worktree with a registry of active workspaces, base-branch sync and cleanup of merged ones, inside the MoAI-ADK workflow.

    1.2k GitHub stars~3.9k tokensUpdated yesterday
    Auto-check passed

  • CI Watch and Auto-Fix Loop

    modu-ai/moai-adk

    Watches a pull request's CI checks after creation, separates required from auxiliary failures, applies limited safe fixes and escalates anything semantic to you.

    1.2k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check: notes

Works with

Categories

Questions about Hns Oss Docs I18n Rules

What does Hns Oss Docs I18n Rules do?

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). Hns Oss Docs I18n Rules is an agent skill from modu-ai/moai-adk.kr).

When should I use Hns Oss Docs I18n Rules?

Hns Oss Docs I18n Rules fits situations like: tasks that involve Internationalization; tasks that involve Diagrams; tasks that involve Static sites and blogs.

How do I install Hns Oss Docs I18n Rules in Claude Code?

Run `npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rules -a claude-code`. Or copy the skill folder (.claude/skills/hns-oss-docs-i18n-rules in modu-ai/moai-adk) into .claude/skills/hns-oss-docs-i18n-rules in your project. Claude Code loads it when a task matches its description.

How do I install Hns Oss Docs I18n Rules in Codex?

Run `npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rules -a codex`. Or copy the skill folder (.claude/skills/hns-oss-docs-i18n-rules in modu-ai/moai-adk) into .agents/skills/hns-oss-docs-i18n-rules in your project. Codex loads it when a task matches its description.

Can I use Hns Oss Docs I18n Rules in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rules -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hns-oss-docs-i18n-rules, .gemini/skills/hns-oss-docs-i18n-rules, .github/skills/hns-oss-docs-i18n-rules and .opencode/skills/hns-oss-docs-i18n-rules in your project.

What does Hns Oss Docs I18n Rules need to run?

SKILL.md names no scripts, command-line tools or credentials: Hns Oss Docs I18n Rules is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Grep, Glob, Bash.

Does Hns Oss Docs I18n Rules access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Hns Oss Docs I18n Rules safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Hns Oss Docs I18n Rules use?

Hns Oss Docs I18n Rules is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Hns Oss Docs I18n Rules use?

About 1.2k tokens (SKILL.md is roughly 4.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Hns Oss Docs I18n Rules?

Skills that share tags, products or a category with Hns Oss Docs I18n Rules: Create Docs (victorgarciaesgi/nuxt-typed-router, 413 stars), Nextjs Nextra Starter Distill (pdsuwwz/nextjs-nextra-starter, 318 stars), Nextjs Nextra Starter Distill Zh (pdsuwwz/nextjs-nextra-starter, 318 stars) and Preview (hanamizuki/solopreneur, 152 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hns Oss Docs I18n Rules?

modu-ai (a GitHub organization) maintains it in modu-ai/moai-adk, which has 1,230 GitHub stars. The repository holds 48 skills in this directory. The repository was last updated on October 9, 2026.

Source: modu-ai/moai-adk on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.