Creator · modu-ai
Last updated · Sep 2, 2026
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 spaci
Creator · modu-ai
Last updated · Sep 2, 2026
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 spaci
Creator · modu-ai
Last updated · Sep 2, 2026
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 spaci
Creator · modu-ai
Last updated · Sep 2, 2026
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 spaci
Review then install
Install targets
Codex install prompt
Install the "hns-oss-docs-i18n-rules" agent skill from https://github.com/modu-ai/moai-adk/tree/main/.claude/skills/hns-oss-docs-i18n-rules. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: 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. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {"event_id":"install_<unique-id>","skill_slug":"modu-ai-hns-oss-docs-i18n-rules","task":"Install hns-oss-docs-i18n-rules","agent":"codex","outcome":"success","install_used":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes.Supply asset profile
Deep research, source comparison, literature review, RAG, knowledge search, and reports.
Scenario
Research agents
I need my agent to research a topic, compare sources, and produce a concise report.
Agent fit
Claude Code + CLI + Codex
Codex, Claude Code, Cursor, CLI, or custom agents.
Install
Ready
npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rules
Maintenance
fresh
3d since push
Risk
Safe to try
Quality score needs review
GitHub quality
1.2K
77/100 Quality · 82/100 Trust
Coverage tags
Review notes
Quality score needs review
Agent adoption scorecard
These scores combine public repository metadata, OpenAgentSkill review signals, maintenance freshness, and install readiness. They are a shortlist signal, not a replacement for human review.
Quality
StrongSolid option that is likely worth shortlisting for production workflows.
Trust
Review then installGood shortlist signal, but the agent should review audit notes, install policy, and outcome evidence before running it.
Audit
Safe to tryA machine-readable review of install readiness, security metadata, maintenance, and adoption risk.
OpenAgentSkill Trust Score v5
Use as the primary candidate after human or sandbox review.
Stars
1.2K GitHub stars
Repo activity
1.2K stars, 222 forks
Maintenance
3d since push
License
Apache-2.0
Install
npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rules
Install safety
Agent-readable metadata
Use this block or the embedded JSON to decide whether an agent should install this skill, choose an alternative, or ask for human review first.
Suited tasks
Suited agents
Install decision
Trust and risk
Outcome loop
Install command
npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rulesDo not use when
Alternative
1.9K Stars
npx skills add yanliudesign/mono-color-skill --skill mono-color
Alternative
61.0K Stars
npx skills add mvanhorn/last30days-skill -g
Alternative
38.4K Stars
npx skills add Imbad0202/academic-research-skills
Alternative
28.0K Stars
npx skills add assafelovic/gpt-researcher
Agent safety v2
Sparse or mixed signals. Useful for discovery, but not for autonomous installation.
Test manually in an isolated workspace and compare against safer alternatives.
high
Skill metadata references terminal, CLI, shell, subprocess, or command execution workflows.
medium
Skill likely fetches remote pages, APIs, repositories, or external services.
medium
Skill may read or write project files, documents, generated artifacts, or local workspace state.
Agent resolve plan
The Resolve API returns the selected skill, alternatives, safety policy, audit notes, install target, and copy-paste prompt an agent can follow without scraping this page.
Open JSON
/api/agent/resolve?task=Use%20hns-oss-docs-i18n-rules%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Resolve text
/api/agent/resolve?task=Use%20hns-oss-docs-i18n-rules%20for%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text
Install handoff
/api/skills/modu-ai-hns-oss-docs-i18n-rules/install
Agent should check
Copy prompt
Task: Use hns-oss-docs-i18n-rules in this workspace.
Resolve first: https://www.openagentskill.com/api/agent/resolve?task=Use%20hns-oss-docs-i18n-rules%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Review install handoff: https://www.openagentskill.com/api/skills/modu-ai-hns-oss-docs-i18n-rules/install
Install command: npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rules
Before running it, summarize audit warnings, required permissions, and the fallback skill if install is risky.Agent handoff
Use the public install endpoint to fetch the command, safety checklist, target prompts, and canonical links for this skill.
Install handoff
/api/skills/modu-ai-hns-oss-docs-i18n-rules/install
LLM text format
/api/skills/modu-ai-hns-oss-docs-i18n-rules/install?format=text
Find alternatives
/api/skills/search?q=hns-oss-docs-i18n-rules&limit=3
Agent prompt
Use hns-oss-docs-i18n-rules for this task. Review https://www.openagentskill.com/api/skills/modu-ai-hns-oss-docs-i18n-rules/install, then install with: npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rulesRegistry metadata
This page exposes the same decision, trust, audit, use-case, and install signals through the Registry API, so agents can rank this skill without scraping the UI.
Manifest
/api/registry/manifest/modu-ai-hns-oss-docs-i18n-rules
LLM text
/api/registry/manifest/modu-ai-hns-oss-docs-i18n-rules?format=text
Install alias
/api/registry/install/modu-ai-hns-oss-docs-i18n-rules
Recommend
/api/registry/recommend?task=Use%20hns-oss-docs-i18n-rules%20in%20an%20agent%20workflow&limit=3
Agent fit
Research agents
Use-case tags
Platforms
Claude Code
Audit report
A machine-readable review of install readiness, security metadata, maintenance, and adoption risk.
Agent decision cockpit
Use this as a leading candidate, then validate the README and install path in your own agent stack.
Role in stack
Primary pick
Primary fit
Research agents
Trust label
Production-ready
Install path
Command ready
Use when
Evidence
review first
Implementation path
Trust profile
Good shortlist signal, but the agent should review audit notes, install policy, and outcome evidence before running it.
GitHub adoption
PASS1.2K GitHub stars
Stars/forks activity
INFO1.2K stars, 222 forks; issue activity unavailable in current metadata
Recent maintenance
PASS3d since push
License clarity
PASSApache-2.0
Good signals
Review before install
Recommended action
Use as the primary candidate after human or sandbox review.
Quality profile
Solid option that is likely worth shortlisting for production workflows.
Workflow fit
Investigate faster
I need my agent to research a topic, compare sources, and produce a concise report.
Build and ship code
I need a coding agent that can understand a repository, edit code, and review pull requests.
Manage repositories
I need my agent to triage GitHub issues, review pull requests, and summarize repository changes.
Workflow fit
Find, compare, and synthesize
A workflow for agents that gather sources, compare claims, summarize long material, and draft useful research briefs.
Scrape, clean, and reuse web data
A practical workflow for agents that crawl public pages, extract clean content, normalize data, and hand it to downstream research or RAG workflows.
Inspect, patch, and verify code
A workflow for software agents that inspect repositories, review pull requests, generate tests, and turn findings into shippable patches.
Alternative shortlist
Similar skills that may fit this task.
Generate original one-ink or controlled two-ink editorial images from any theme, sentence, article idea, object, or reference photo. Always use this skill when the user asks for 单色海报、双色印刷、单色调视觉、蓝色/绿色孔版印刷、risograph、网点照片、复古或当代编辑排版、zine poster, monochrome editorial poster, duotone print, or asks to use the mono-color style. It uses an adaptive white, gray, or pale-beige substrate, no more than two printing inks, active negative space, terse human language, and strong serif/grotesk/mono typography without making retro styling the default or copying a source composition, wording, logo, or artwork. Produce both the final generation prompt and the generated raster image unless the user explicitly asks for prompt only.
Research the last 30 days across Reddit, X, YouTube, Hacker News, Polymarket, GitHub, and the web, then synthesize a grounded brief for an AI agent.
Academic Research Skills for Claude Code: research → write → review → revise → finalize
Run autonomous deep research over web and local sources
--- 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" category: "harness" status: "active" updated: "2026-08-17" 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]
| Surface | Canonical | Derivation chain | Derived files | |---------|-----------|------------------|---------------| | docs-site | **ko** | ko → en → ja/zh, same PR | `docs-site/content/{en,ja,zh}/` | | README | **ko** (`README.ko.md`) | ko → en/ja/zh, same PR | `README.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`
## 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.
Source provenance
Decision snapshot
1,195 GitHub stars
Audit
Install and adoption review
Agent-proven evidence
Outcome reports after resolve, review, install, and one narrow run.
No agent outcome data yet. The first agent run can report success, setup needs, risk blocks, failure, or not-relevant through /api/agent/outcome.
Install
Free and open source. Review the report before installing into production agents.
Growth loop
Scenario-led draft for hns-oss-docs-i18n-rules, ready for a manual X post.
A practical pick for a web workflow: 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 (a... 1.2K stars https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-i18n-rules?ref=x
Listing + install path for hns-oss-docs-i18n-rules: https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-i18n-rules?ref=x Install: npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rules
Listing source
This listing was indexed from public sources and is not marked official until a maintainer claim is approved.
Attribution links to the public repository or creator profile. Creators can claim the listing to update ownership signals.
Claim this skillOwner claim
This Registry indexed listing is attributed to modu-ai but is not marked official yet. Claim it to add a verified owner signal and make future launch, install, and audit updates easier to trust.
Creator backlink kit
Show the canonical listing, current trust and audit signals, and real Agent-Proven evidence where developers evaluate the repository.
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-i18n-rules?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-i18n-rules?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-i18n-rules/audit)
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-i18n-rules?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)modu-ai
@modu-ai
Share whether this skill looks useful for your agent workflow. Aggregated feedback improves rankings over time.
Review then install
mono-color
Generate original one-ink or controlled two-ink editorial images from any theme, sentence, article idea, object, or reference photo. Always use this skill when the user asks for 单色海报、双色印刷、单色调视觉、蓝色/绿色孔版印刷、risograph、网点照片、复古或当代编辑排版、zine poster, monochrome editorial poster, duotone print, or asks to use the mono-color style. It uses an adaptive white, gray, or pale-beige substrate, no more than two printing inks, active negative space, terse human language, and strong serif/grotesk/mono typography without making retro styling the default or copying a source composition, wording, logo, or artwork. Produce both the final generation prompt and the generated raster image unless the user explicitly asks for prompt only.
1.9K StarsLast30days Skill
Research the last 30 days across Reddit, X, YouTube, Hacker News, Polymarket, GitHub, and the web, then synthesize a grounded brief for an AI agent.
61.0K StarsAcademic Research Skills
Academic Research Skills for Claude Code: research → write → review → revise → finalize
38.4K StarsGPT Researcher
Run autonomous deep research over web and local sources
28.0K StarsReview then install
Install targets
Codex install prompt
Install the "hns-oss-docs-i18n-rules" agent skill from https://github.com/modu-ai/moai-adk/tree/main/.claude/skills/hns-oss-docs-i18n-rules. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: 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. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {"event_id":"install_<unique-id>","skill_slug":"modu-ai-hns-oss-docs-i18n-rules","task":"Install hns-oss-docs-i18n-rules","agent":"codex","outcome":"success","install_used":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes.Supply asset profile
Deep research, source comparison, literature review, RAG, knowledge search, and reports.
Scenario
Research agents
I need my agent to research a topic, compare sources, and produce a concise report.
Agent fit
Claude Code + CLI + Codex
Codex, Claude Code, Cursor, CLI, or custom agents.
Install
Ready
npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rules
Maintenance
fresh
3d since push
Risk
Safe to try
Quality score needs review
GitHub quality
1.2K
77/100 Quality · 82/100 Trust
Coverage tags
Review notes
Quality score needs review
Agent adoption scorecard
These scores combine public repository metadata, OpenAgentSkill review signals, maintenance freshness, and install readiness. They are a shortlist signal, not a replacement for human review.
Quality
StrongSolid option that is likely worth shortlisting for production workflows.
Trust
Review then installGood shortlist signal, but the agent should review audit notes, install policy, and outcome evidence before running it.
Audit
Safe to tryA machine-readable review of install readiness, security metadata, maintenance, and adoption risk.
OpenAgentSkill Trust Score v5
Use as the primary candidate after human or sandbox review.
Stars
1.2K GitHub stars
Repo activity
1.2K stars, 222 forks
Maintenance
3d since push
License
Apache-2.0
Install
npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rules
Install safety
Agent-readable metadata
Use this block or the embedded JSON to decide whether an agent should install this skill, choose an alternative, or ask for human review first.
Suited tasks
Suited agents
Install decision
Trust and risk
Outcome loop
Install command
npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rulesDo not use when
Alternative
1.9K Stars
npx skills add yanliudesign/mono-color-skill --skill mono-color
Alternative
61.0K Stars
npx skills add mvanhorn/last30days-skill -g
Alternative
38.4K Stars
npx skills add Imbad0202/academic-research-skills
Alternative
28.0K Stars
npx skills add assafelovic/gpt-researcher
Agent safety v2
Sparse or mixed signals. Useful for discovery, but not for autonomous installation.
Test manually in an isolated workspace and compare against safer alternatives.
high
Skill metadata references terminal, CLI, shell, subprocess, or command execution workflows.
medium
Skill likely fetches remote pages, APIs, repositories, or external services.
medium
Skill may read or write project files, documents, generated artifacts, or local workspace state.
Agent resolve plan
The Resolve API returns the selected skill, alternatives, safety policy, audit notes, install target, and copy-paste prompt an agent can follow without scraping this page.
Open JSON
/api/agent/resolve?task=Use%20hns-oss-docs-i18n-rules%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Resolve text
/api/agent/resolve?task=Use%20hns-oss-docs-i18n-rules%20for%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text
Install handoff
/api/skills/modu-ai-hns-oss-docs-i18n-rules/install
Agent should check
Copy prompt
Task: Use hns-oss-docs-i18n-rules in this workspace.
Resolve first: https://www.openagentskill.com/api/agent/resolve?task=Use%20hns-oss-docs-i18n-rules%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Review install handoff: https://www.openagentskill.com/api/skills/modu-ai-hns-oss-docs-i18n-rules/install
Install command: npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rules
Before running it, summarize audit warnings, required permissions, and the fallback skill if install is risky.Agent handoff
Use the public install endpoint to fetch the command, safety checklist, target prompts, and canonical links for this skill.
Install handoff
/api/skills/modu-ai-hns-oss-docs-i18n-rules/install
LLM text format
/api/skills/modu-ai-hns-oss-docs-i18n-rules/install?format=text
Find alternatives
/api/skills/search?q=hns-oss-docs-i18n-rules&limit=3
Agent prompt
Use hns-oss-docs-i18n-rules for this task. Review https://www.openagentskill.com/api/skills/modu-ai-hns-oss-docs-i18n-rules/install, then install with: npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rulesRegistry metadata
This page exposes the same decision, trust, audit, use-case, and install signals through the Registry API, so agents can rank this skill without scraping the UI.
Manifest
/api/registry/manifest/modu-ai-hns-oss-docs-i18n-rules
LLM text
/api/registry/manifest/modu-ai-hns-oss-docs-i18n-rules?format=text
Install alias
/api/registry/install/modu-ai-hns-oss-docs-i18n-rules
Recommend
/api/registry/recommend?task=Use%20hns-oss-docs-i18n-rules%20in%20an%20agent%20workflow&limit=3
Agent fit
Research agents
Use-case tags
Platforms
Claude Code
Audit report
A machine-readable review of install readiness, security metadata, maintenance, and adoption risk.
Agent decision cockpit
Use this as a leading candidate, then validate the README and install path in your own agent stack.
Role in stack
Primary pick
Primary fit
Research agents
Trust label
Production-ready
Install path
Command ready
Use when
Evidence
review first
Implementation path
Trust profile
Good shortlist signal, but the agent should review audit notes, install policy, and outcome evidence before running it.
GitHub adoption
PASS1.2K GitHub stars
Stars/forks activity
INFO1.2K stars, 222 forks; issue activity unavailable in current metadata
Recent maintenance
PASS3d since push
License clarity
PASSApache-2.0
Good signals
Review before install
Recommended action
Use as the primary candidate after human or sandbox review.
Quality profile
Solid option that is likely worth shortlisting for production workflows.
Workflow fit
Investigate faster
I need my agent to research a topic, compare sources, and produce a concise report.
Build and ship code
I need a coding agent that can understand a repository, edit code, and review pull requests.
Manage repositories
I need my agent to triage GitHub issues, review pull requests, and summarize repository changes.
Workflow fit
Find, compare, and synthesize
A workflow for agents that gather sources, compare claims, summarize long material, and draft useful research briefs.
Scrape, clean, and reuse web data
A practical workflow for agents that crawl public pages, extract clean content, normalize data, and hand it to downstream research or RAG workflows.
Inspect, patch, and verify code
A workflow for software agents that inspect repositories, review pull requests, generate tests, and turn findings into shippable patches.
Alternative shortlist
Similar skills that may fit this task.
Generate original one-ink or controlled two-ink editorial images from any theme, sentence, article idea, object, or reference photo. Always use this skill when the user asks for 单色海报、双色印刷、单色调视觉、蓝色/绿色孔版印刷、risograph、网点照片、复古或当代编辑排版、zine poster, monochrome editorial poster, duotone print, or asks to use the mono-color style. It uses an adaptive white, gray, or pale-beige substrate, no more than two printing inks, active negative space, terse human language, and strong serif/grotesk/mono typography without making retro styling the default or copying a source composition, wording, logo, or artwork. Produce both the final generation prompt and the generated raster image unless the user explicitly asks for prompt only.
Research the last 30 days across Reddit, X, YouTube, Hacker News, Polymarket, GitHub, and the web, then synthesize a grounded brief for an AI agent.
Academic Research Skills for Claude Code: research → write → review → revise → finalize
Run autonomous deep research over web and local sources
--- 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" category: "harness" status: "active" updated: "2026-08-17" 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]
| Surface | Canonical | Derivation chain | Derived files | |---------|-----------|------------------|---------------| | docs-site | **ko** | ko → en → ja/zh, same PR | `docs-site/content/{en,ja,zh}/` | | README | **ko** (`README.ko.md`) | ko → en/ja/zh, same PR | `README.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`
## 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.
Source provenance
Decision snapshot
1,195 GitHub stars
Audit
Install and adoption review
Agent-proven evidence
Outcome reports after resolve, review, install, and one narrow run.
No agent outcome data yet. The first agent run can report success, setup needs, risk blocks, failure, or not-relevant through /api/agent/outcome.
Install
Free and open source. Review the report before installing into production agents.
Growth loop
Scenario-led draft for hns-oss-docs-i18n-rules, ready for a manual X post.
A practical pick for a web workflow: 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 (a... 1.2K stars https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-i18n-rules?ref=x
Listing + install path for hns-oss-docs-i18n-rules: https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-i18n-rules?ref=x Install: npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rules
Listing source
This listing was indexed from public sources and is not marked official until a maintainer claim is approved.
Attribution links to the public repository or creator profile. Creators can claim the listing to update ownership signals.
Claim this skillOwner claim
This Registry indexed listing is attributed to modu-ai but is not marked official yet. Claim it to add a verified owner signal and make future launch, install, and audit updates easier to trust.
Creator backlink kit
Show the canonical listing, current trust and audit signals, and real Agent-Proven evidence where developers evaluate the repository.
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-i18n-rules?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-i18n-rules?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-i18n-rules/audit)
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-i18n-rules?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)modu-ai
@modu-ai
Share whether this skill looks useful for your agent workflow. Aggregated feedback improves rankings over time.
Review then install
mono-color
Generate original one-ink or controlled two-ink editorial images from any theme, sentence, article idea, object, or reference photo. Always use this skill when the user asks for 单色海报、双色印刷、单色调视觉、蓝色/绿色孔版印刷、risograph、网点照片、复古或当代编辑排版、zine poster, monochrome editorial poster, duotone print, or asks to use the mono-color style. It uses an adaptive white, gray, or pale-beige substrate, no more than two printing inks, active negative space, terse human language, and strong serif/grotesk/mono typography without making retro styling the default or copying a source composition, wording, logo, or artwork. Produce both the final generation prompt and the generated raster image unless the user explicitly asks for prompt only.
1.9K StarsLast30days Skill
Research the last 30 days across Reddit, X, YouTube, Hacker News, Polymarket, GitHub, and the web, then synthesize a grounded brief for an AI agent.
61.0K StarsAcademic Research Skills
Academic Research Skills for Claude Code: research → write → review → revise → finalize
38.4K StarsGPT Researcher
Run autonomous deep research over web and local sources
28.0K StarsReview then install
Install targets
Codex install prompt
Install the "hns-oss-docs-i18n-rules" agent skill from https://github.com/modu-ai/moai-adk/tree/main/.claude/skills/hns-oss-docs-i18n-rules. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: 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. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {"event_id":"install_<unique-id>","skill_slug":"modu-ai-hns-oss-docs-i18n-rules","task":"Install hns-oss-docs-i18n-rules","agent":"codex","outcome":"success","install_used":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes.Supply asset profile
Deep research, source comparison, literature review, RAG, knowledge search, and reports.
Scenario
Research agents
I need my agent to research a topic, compare sources, and produce a concise report.
Agent fit
Claude Code + CLI + Codex
Codex, Claude Code, Cursor, CLI, or custom agents.
Install
Ready
npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rules
Maintenance
fresh
3d since push
Risk
Safe to try
Quality score needs review
GitHub quality
1.2K
77/100 Quality · 82/100 Trust
Coverage tags
Review notes
Quality score needs review
Agent adoption scorecard
These scores combine public repository metadata, OpenAgentSkill review signals, maintenance freshness, and install readiness. They are a shortlist signal, not a replacement for human review.
Quality
StrongSolid option that is likely worth shortlisting for production workflows.
Trust
Review then installGood shortlist signal, but the agent should review audit notes, install policy, and outcome evidence before running it.
Audit
Safe to tryA machine-readable review of install readiness, security metadata, maintenance, and adoption risk.
OpenAgentSkill Trust Score v5
Use as the primary candidate after human or sandbox review.
Stars
1.2K GitHub stars
Repo activity
1.2K stars, 222 forks
Maintenance
3d since push
License
Apache-2.0
Install
npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rules
Install safety
Agent-readable metadata
Use this block or the embedded JSON to decide whether an agent should install this skill, choose an alternative, or ask for human review first.
Suited tasks
Suited agents
Install decision
Trust and risk
Outcome loop
Install command
npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rulesDo not use when
Alternative
1.9K Stars
npx skills add yanliudesign/mono-color-skill --skill mono-color
Alternative
61.0K Stars
npx skills add mvanhorn/last30days-skill -g
Alternative
38.4K Stars
npx skills add Imbad0202/academic-research-skills
Alternative
28.0K Stars
npx skills add assafelovic/gpt-researcher
Agent safety v2
Sparse or mixed signals. Useful for discovery, but not for autonomous installation.
Test manually in an isolated workspace and compare against safer alternatives.
high
Skill metadata references terminal, CLI, shell, subprocess, or command execution workflows.
medium
Skill likely fetches remote pages, APIs, repositories, or external services.
medium
Skill may read or write project files, documents, generated artifacts, or local workspace state.
Agent resolve plan
The Resolve API returns the selected skill, alternatives, safety policy, audit notes, install target, and copy-paste prompt an agent can follow without scraping this page.
Open JSON
/api/agent/resolve?task=Use%20hns-oss-docs-i18n-rules%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Resolve text
/api/agent/resolve?task=Use%20hns-oss-docs-i18n-rules%20for%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text
Install handoff
/api/skills/modu-ai-hns-oss-docs-i18n-rules/install
Agent should check
Copy prompt
Task: Use hns-oss-docs-i18n-rules in this workspace.
Resolve first: https://www.openagentskill.com/api/agent/resolve?task=Use%20hns-oss-docs-i18n-rules%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Review install handoff: https://www.openagentskill.com/api/skills/modu-ai-hns-oss-docs-i18n-rules/install
Install command: npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rules
Before running it, summarize audit warnings, required permissions, and the fallback skill if install is risky.Agent handoff
Use the public install endpoint to fetch the command, safety checklist, target prompts, and canonical links for this skill.
Install handoff
/api/skills/modu-ai-hns-oss-docs-i18n-rules/install
LLM text format
/api/skills/modu-ai-hns-oss-docs-i18n-rules/install?format=text
Find alternatives
/api/skills/search?q=hns-oss-docs-i18n-rules&limit=3
Agent prompt
Use hns-oss-docs-i18n-rules for this task. Review https://www.openagentskill.com/api/skills/modu-ai-hns-oss-docs-i18n-rules/install, then install with: npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rulesRegistry metadata
This page exposes the same decision, trust, audit, use-case, and install signals through the Registry API, so agents can rank this skill without scraping the UI.
Manifest
/api/registry/manifest/modu-ai-hns-oss-docs-i18n-rules
LLM text
/api/registry/manifest/modu-ai-hns-oss-docs-i18n-rules?format=text
Install alias
/api/registry/install/modu-ai-hns-oss-docs-i18n-rules
Recommend
/api/registry/recommend?task=Use%20hns-oss-docs-i18n-rules%20in%20an%20agent%20workflow&limit=3
Agent fit
Research agents
Use-case tags
Platforms
Claude Code
Audit report
A machine-readable review of install readiness, security metadata, maintenance, and adoption risk.
Agent decision cockpit
Use this as a leading candidate, then validate the README and install path in your own agent stack.
Role in stack
Primary pick
Primary fit
Research agents
Trust label
Production-ready
Install path
Command ready
Use when
Evidence
review first
Implementation path
Trust profile
Good shortlist signal, but the agent should review audit notes, install policy, and outcome evidence before running it.
GitHub adoption
PASS1.2K GitHub stars
Stars/forks activity
INFO1.2K stars, 222 forks; issue activity unavailable in current metadata
Recent maintenance
PASS3d since push
License clarity
PASSApache-2.0
Good signals
Review before install
Recommended action
Use as the primary candidate after human or sandbox review.
Quality profile
Solid option that is likely worth shortlisting for production workflows.
Workflow fit
Investigate faster
I need my agent to research a topic, compare sources, and produce a concise report.
Build and ship code
I need a coding agent that can understand a repository, edit code, and review pull requests.
Manage repositories
I need my agent to triage GitHub issues, review pull requests, and summarize repository changes.
Workflow fit
Find, compare, and synthesize
A workflow for agents that gather sources, compare claims, summarize long material, and draft useful research briefs.
Scrape, clean, and reuse web data
A practical workflow for agents that crawl public pages, extract clean content, normalize data, and hand it to downstream research or RAG workflows.
Inspect, patch, and verify code
A workflow for software agents that inspect repositories, review pull requests, generate tests, and turn findings into shippable patches.
Alternative shortlist
Similar skills that may fit this task.
Generate original one-ink or controlled two-ink editorial images from any theme, sentence, article idea, object, or reference photo. Always use this skill when the user asks for 单色海报、双色印刷、单色调视觉、蓝色/绿色孔版印刷、risograph、网点照片、复古或当代编辑排版、zine poster, monochrome editorial poster, duotone print, or asks to use the mono-color style. It uses an adaptive white, gray, or pale-beige substrate, no more than two printing inks, active negative space, terse human language, and strong serif/grotesk/mono typography without making retro styling the default or copying a source composition, wording, logo, or artwork. Produce both the final generation prompt and the generated raster image unless the user explicitly asks for prompt only.
Research the last 30 days across Reddit, X, YouTube, Hacker News, Polymarket, GitHub, and the web, then synthesize a grounded brief for an AI agent.
Academic Research Skills for Claude Code: research → write → review → revise → finalize
Run autonomous deep research over web and local sources
--- 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" category: "harness" status: "active" updated: "2026-08-17" 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]
| Surface | Canonical | Derivation chain | Derived files | |---------|-----------|------------------|---------------| | docs-site | **ko** | ko → en → ja/zh, same PR | `docs-site/content/{en,ja,zh}/` | | README | **ko** (`README.ko.md`) | ko → en/ja/zh, same PR | `README.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`
## 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.
Source provenance
Decision snapshot
1,195 GitHub stars
Audit
Install and adoption review
Agent-proven evidence
Outcome reports after resolve, review, install, and one narrow run.
No agent outcome data yet. The first agent run can report success, setup needs, risk blocks, failure, or not-relevant through /api/agent/outcome.
Install
Free and open source. Review the report before installing into production agents.
Growth loop
Scenario-led draft for hns-oss-docs-i18n-rules, ready for a manual X post.
A practical pick for a web workflow: 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 (a... 1.2K stars https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-i18n-rules?ref=x
Listing + install path for hns-oss-docs-i18n-rules: https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-i18n-rules?ref=x Install: npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rules
Listing source
This listing was indexed from public sources and is not marked official until a maintainer claim is approved.
Attribution links to the public repository or creator profile. Creators can claim the listing to update ownership signals.
Claim this skillOwner claim
This Registry indexed listing is attributed to modu-ai but is not marked official yet. Claim it to add a verified owner signal and make future launch, install, and audit updates easier to trust.
Creator backlink kit
Show the canonical listing, current trust and audit signals, and real Agent-Proven evidence where developers evaluate the repository.
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-i18n-rules?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-i18n-rules?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-i18n-rules/audit)
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-i18n-rules?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)modu-ai
@modu-ai
Share whether this skill looks useful for your agent workflow. Aggregated feedback improves rankings over time.
Review then install
mono-color
Generate original one-ink or controlled two-ink editorial images from any theme, sentence, article idea, object, or reference photo. Always use this skill when the user asks for 单色海报、双色印刷、单色调视觉、蓝色/绿色孔版印刷、risograph、网点照片、复古或当代编辑排版、zine poster, monochrome editorial poster, duotone print, or asks to use the mono-color style. It uses an adaptive white, gray, or pale-beige substrate, no more than two printing inks, active negative space, terse human language, and strong serif/grotesk/mono typography without making retro styling the default or copying a source composition, wording, logo, or artwork. Produce both the final generation prompt and the generated raster image unless the user explicitly asks for prompt only.
1.9K StarsLast30days Skill
Research the last 30 days across Reddit, X, YouTube, Hacker News, Polymarket, GitHub, and the web, then synthesize a grounded brief for an AI agent.
61.0K StarsAcademic Research Skills
Academic Research Skills for Claude Code: research → write → review → revise → finalize
38.4K StarsGPT Researcher
Run autonomous deep research over web and local sources
28.0K StarsReview then install
Install targets
Codex install prompt
Install the "hns-oss-docs-i18n-rules" agent skill from https://github.com/modu-ai/moai-adk/tree/main/.claude/skills/hns-oss-docs-i18n-rules. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: 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. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {"event_id":"install_<unique-id>","skill_slug":"modu-ai-hns-oss-docs-i18n-rules","task":"Install hns-oss-docs-i18n-rules","agent":"codex","outcome":"success","install_used":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes.Supply asset profile
Deep research, source comparison, literature review, RAG, knowledge search, and reports.
Scenario
Research agents
I need my agent to research a topic, compare sources, and produce a concise report.
Agent fit
Claude Code + CLI + Codex
Codex, Claude Code, Cursor, CLI, or custom agents.
Install
Ready
npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rules
Maintenance
fresh
3d since push
Risk
Safe to try
Quality score needs review
GitHub quality
1.2K
77/100 Quality · 82/100 Trust
Coverage tags
Review notes
Quality score needs review
Agent adoption scorecard
These scores combine public repository metadata, OpenAgentSkill review signals, maintenance freshness, and install readiness. They are a shortlist signal, not a replacement for human review.
Quality
StrongSolid option that is likely worth shortlisting for production workflows.
Trust
Review then installGood shortlist signal, but the agent should review audit notes, install policy, and outcome evidence before running it.
Audit
Safe to tryA machine-readable review of install readiness, security metadata, maintenance, and adoption risk.
OpenAgentSkill Trust Score v5
Use as the primary candidate after human or sandbox review.
Stars
1.2K GitHub stars
Repo activity
1.2K stars, 222 forks
Maintenance
3d since push
License
Apache-2.0
Install
npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rules
Install safety
Agent-readable metadata
Use this block or the embedded JSON to decide whether an agent should install this skill, choose an alternative, or ask for human review first.
Suited tasks
Suited agents
Install decision
Trust and risk
Outcome loop
Install command
npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rulesDo not use when
Alternative
1.9K Stars
npx skills add yanliudesign/mono-color-skill --skill mono-color
Alternative
61.0K Stars
npx skills add mvanhorn/last30days-skill -g
Alternative
38.4K Stars
npx skills add Imbad0202/academic-research-skills
Alternative
28.0K Stars
npx skills add assafelovic/gpt-researcher
Agent safety v2
Sparse or mixed signals. Useful for discovery, but not for autonomous installation.
Test manually in an isolated workspace and compare against safer alternatives.
high
Skill metadata references terminal, CLI, shell, subprocess, or command execution workflows.
medium
Skill likely fetches remote pages, APIs, repositories, or external services.
medium
Skill may read or write project files, documents, generated artifacts, or local workspace state.
Agent resolve plan
The Resolve API returns the selected skill, alternatives, safety policy, audit notes, install target, and copy-paste prompt an agent can follow without scraping this page.
Open JSON
/api/agent/resolve?task=Use%20hns-oss-docs-i18n-rules%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Resolve text
/api/agent/resolve?task=Use%20hns-oss-docs-i18n-rules%20for%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text
Install handoff
/api/skills/modu-ai-hns-oss-docs-i18n-rules/install
Agent should check
Copy prompt
Task: Use hns-oss-docs-i18n-rules in this workspace.
Resolve first: https://www.openagentskill.com/api/agent/resolve?task=Use%20hns-oss-docs-i18n-rules%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Review install handoff: https://www.openagentskill.com/api/skills/modu-ai-hns-oss-docs-i18n-rules/install
Install command: npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rules
Before running it, summarize audit warnings, required permissions, and the fallback skill if install is risky.Agent handoff
Use the public install endpoint to fetch the command, safety checklist, target prompts, and canonical links for this skill.
Install handoff
/api/skills/modu-ai-hns-oss-docs-i18n-rules/install
LLM text format
/api/skills/modu-ai-hns-oss-docs-i18n-rules/install?format=text
Find alternatives
/api/skills/search?q=hns-oss-docs-i18n-rules&limit=3
Agent prompt
Use hns-oss-docs-i18n-rules for this task. Review https://www.openagentskill.com/api/skills/modu-ai-hns-oss-docs-i18n-rules/install, then install with: npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rulesRegistry metadata
This page exposes the same decision, trust, audit, use-case, and install signals through the Registry API, so agents can rank this skill without scraping the UI.
Manifest
/api/registry/manifest/modu-ai-hns-oss-docs-i18n-rules
LLM text
/api/registry/manifest/modu-ai-hns-oss-docs-i18n-rules?format=text
Install alias
/api/registry/install/modu-ai-hns-oss-docs-i18n-rules
Recommend
/api/registry/recommend?task=Use%20hns-oss-docs-i18n-rules%20in%20an%20agent%20workflow&limit=3
Agent fit
Research agents
Use-case tags
Platforms
Claude Code
Audit report
A machine-readable review of install readiness, security metadata, maintenance, and adoption risk.
Agent decision cockpit
Use this as a leading candidate, then validate the README and install path in your own agent stack.
Role in stack
Primary pick
Primary fit
Research agents
Trust label
Production-ready
Install path
Command ready
Use when
Evidence
review first
Implementation path
Trust profile
Good shortlist signal, but the agent should review audit notes, install policy, and outcome evidence before running it.
GitHub adoption
PASS1.2K GitHub stars
Stars/forks activity
INFO1.2K stars, 222 forks; issue activity unavailable in current metadata
Recent maintenance
PASS3d since push
License clarity
PASSApache-2.0
Good signals
Review before install
Recommended action
Use as the primary candidate after human or sandbox review.
Quality profile
Solid option that is likely worth shortlisting for production workflows.
Workflow fit
Investigate faster
I need my agent to research a topic, compare sources, and produce a concise report.
Build and ship code
I need a coding agent that can understand a repository, edit code, and review pull requests.
Manage repositories
I need my agent to triage GitHub issues, review pull requests, and summarize repository changes.
Workflow fit
Find, compare, and synthesize
A workflow for agents that gather sources, compare claims, summarize long material, and draft useful research briefs.
Scrape, clean, and reuse web data
A practical workflow for agents that crawl public pages, extract clean content, normalize data, and hand it to downstream research or RAG workflows.
Inspect, patch, and verify code
A workflow for software agents that inspect repositories, review pull requests, generate tests, and turn findings into shippable patches.
Alternative shortlist
Similar skills that may fit this task.
Generate original one-ink or controlled two-ink editorial images from any theme, sentence, article idea, object, or reference photo. Always use this skill when the user asks for 单色海报、双色印刷、单色调视觉、蓝色/绿色孔版印刷、risograph、网点照片、复古或当代编辑排版、zine poster, monochrome editorial poster, duotone print, or asks to use the mono-color style. It uses an adaptive white, gray, or pale-beige substrate, no more than two printing inks, active negative space, terse human language, and strong serif/grotesk/mono typography without making retro styling the default or copying a source composition, wording, logo, or artwork. Produce both the final generation prompt and the generated raster image unless the user explicitly asks for prompt only.
Research the last 30 days across Reddit, X, YouTube, Hacker News, Polymarket, GitHub, and the web, then synthesize a grounded brief for an AI agent.
Academic Research Skills for Claude Code: research → write → review → revise → finalize
Run autonomous deep research over web and local sources
--- 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" category: "harness" status: "active" updated: "2026-08-17" 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]
| Surface | Canonical | Derivation chain | Derived files | |---------|-----------|------------------|---------------| | docs-site | **ko** | ko → en → ja/zh, same PR | `docs-site/content/{en,ja,zh}/` | | README | **ko** (`README.ko.md`) | ko → en/ja/zh, same PR | `README.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`
## 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.
Source provenance
Decision snapshot
1,195 GitHub stars
Audit
Install and adoption review
Agent-proven evidence
Outcome reports after resolve, review, install, and one narrow run.
No agent outcome data yet. The first agent run can report success, setup needs, risk blocks, failure, or not-relevant through /api/agent/outcome.
Install
Free and open source. Review the report before installing into production agents.
Growth loop
Scenario-led draft for hns-oss-docs-i18n-rules, ready for a manual X post.
A practical pick for a web workflow: 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 (a... 1.2K stars https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-i18n-rules?ref=x
Listing + install path for hns-oss-docs-i18n-rules: https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-i18n-rules?ref=x Install: npx skills add modu-ai/moai-adk --skill hns-oss-docs-i18n-rules
Listing source
This listing was indexed from public sources and is not marked official until a maintainer claim is approved.
Attribution links to the public repository or creator profile. Creators can claim the listing to update ownership signals.
Claim this skillOwner claim
This Registry indexed listing is attributed to modu-ai but is not marked official yet. Claim it to add a verified owner signal and make future launch, install, and audit updates easier to trust.
Creator backlink kit
Show the canonical listing, current trust and audit signals, and real Agent-Proven evidence where developers evaluate the repository.
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-i18n-rules?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-i18n-rules?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-i18n-rules/audit)
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-i18n-rules?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)modu-ai
@modu-ai
Share whether this skill looks useful for your agent workflow. Aggregated feedback improves rankings over time.
Review then install
mono-color
Generate original one-ink or controlled two-ink editorial images from any theme, sentence, article idea, object, or reference photo. Always use this skill when the user asks for 单色海报、双色印刷、单色调视觉、蓝色/绿色孔版印刷、risograph、网点照片、复古或当代编辑排版、zine poster, monochrome editorial poster, duotone print, or asks to use the mono-color style. It uses an adaptive white, gray, or pale-beige substrate, no more than two printing inks, active negative space, terse human language, and strong serif/grotesk/mono typography without making retro styling the default or copying a source composition, wording, logo, or artwork. Produce both the final generation prompt and the generated raster image unless the user explicitly asks for prompt only.
1.9K StarsLast30days Skill
Research the last 30 days across Reddit, X, YouTube, Hacker News, Polymarket, GitHub, and the web, then synthesize a grounded brief for an AI agent.
61.0K StarsAcademic Research Skills
Academic Research Skills for Claude Code: research → write → review → revise → finalize
38.4K StarsGPT Researcher
Run autonomous deep research over web and local sources
28.0K StarsPermission surface
shell or command execution, filesystem or document access
Agent outcomes
No agent outcome data yet
Docs
Strong README/SKILL.md context
Risk summary
Install readiness
Permission surface
shell or command execution, filesystem or document access
Agent outcomes
No agent outcome data yet
Docs
Strong README/SKILL.md context
Risk summary
Install readiness
Permission surface
shell or command execution, filesystem or document access
Agent outcomes
No agent outcome data yet
Docs
Strong README/SKILL.md context
Risk summary
Install readiness
Permission surface
shell or command execution, filesystem or document access
Agent outcomes
No agent outcome data yet
Docs
Strong README/SKILL.md context
Risk summary
Install readiness