Creator · modu-ai
Last updated · Sep 2, 2026
README 4-file synchronization procedure for the oss-docs harness: Korean README.ko.md as primary source, en/ja/zh derivation, the shared language-switcher header contract, section-order parity checklist, and the manual verification recipe (no linter exists for READMEs). Loaded by
Creator · modu-ai
Last updated · Sep 2, 2026
README 4-file synchronization procedure for the oss-docs harness: Korean README.ko.md as primary source, en/ja/zh derivation, the shared language-switcher header contract, section-order parity checklist, and the manual verification recipe (no linter exists for READMEs). Loaded by
Creator · modu-ai
Last updated · Sep 2, 2026
README 4-file synchronization procedure for the oss-docs harness: Korean README.ko.md as primary source, en/ja/zh derivation, the shared language-switcher header contract, section-order parity checklist, and the manual verification recipe (no linter exists for READMEs). Loaded by
Creator · modu-ai
Last updated · Sep 2, 2026
README 4-file synchronization procedure for the oss-docs harness: Korean README.ko.md as primary source, en/ja/zh derivation, the shared language-switcher header contract, section-order parity checklist, and the manual verification recipe (no linter exists for READMEs). Loaded by
Review then install
Install targets
Codex install prompt
Install the "hns-oss-docs-readme-sync" agent skill from https://github.com/modu-ai/moai-adk/tree/main/.claude/skills/hns-oss-docs-readme-sync. 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: README 4-file synchronization procedure for the oss-docs harness: Korean README.ko.md as primary source, en/ja/zh derivation, the shared language-switcher header contract, section-order parity checklist, and the manual verification recipe (no linter exists for READMEs). Loaded by the content-author and locale-translator specialists for any README work. 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-readme-sync","task":"Install hns-oss-docs-readme-sync","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-readme-sync
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-readme-sync
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-readme-syncDo 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-readme-sync%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Resolve text
/api/agent/resolve?task=Use%20hns-oss-docs-readme-sync%20for%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text
Install handoff
/api/skills/modu-ai-hns-oss-docs-readme-sync/install
Agent should check
Copy prompt
Task: Use hns-oss-docs-readme-sync in this workspace.
Resolve first: https://www.openagentskill.com/api/agent/resolve?task=Use%20hns-oss-docs-readme-sync%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Review install handoff: https://www.openagentskill.com/api/skills/modu-ai-hns-oss-docs-readme-sync/install
Install command: npx skills add modu-ai/moai-adk --skill hns-oss-docs-readme-sync
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-readme-sync/install
LLM text format
/api/skills/modu-ai-hns-oss-docs-readme-sync/install?format=text
Find alternatives
/api/skills/search?q=hns-oss-docs-readme-sync&limit=3
Agent prompt
Use hns-oss-docs-readme-sync for this task. Review https://www.openagentskill.com/api/skills/modu-ai-hns-oss-docs-readme-sync/install, then install with: npx skills add modu-ai/moai-adk --skill hns-oss-docs-readme-syncRegistry 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-readme-sync
LLM text
/api/registry/manifest/modu-ai-hns-oss-docs-readme-sync?format=text
Install alias
/api/registry/install/modu-ai-hns-oss-docs-readme-sync
Recommend
/api/registry/recommend?task=Use%20hns-oss-docs-readme-sync%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.
Manage repositories
I need my agent to triage GitHub issues, review pull requests, and summarize repository changes.
Build and ship code
I need a coding agent that can understand a repository, edit code, and review pull requests.
Workflow fit
Find, compare, and synthesize
A workflow for agents that gather sources, compare claims, summarize long material, and draft useful research briefs.
Inspect, patch, and verify code
A workflow for software agents that inspect repositories, review pull requests, generate tests, and turn findings into shippable patches.
Turn skills into distribution
A workflow for turning newly indexed skills into SEO briefs, social drafts, comparison pages, and reusable publishing workflows.
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-readme-sync description: > README 4-file synchronization procedure for the oss-docs harness: Korean README.ko.md as primary source, en/ja/zh derivation, the shared language-switcher header contract, section-order parity checklist, and the manual verification recipe (no linter exists for READMEs). Loaded by the content-author and locale-translator specialists for any README work. allowed-tools: Read, Grep, Glob, Bash user-invocable: false metadata: version: "2.0.0" category: "harness" status: "active" updated: "2026-08-17" tags: "oss-docs,readme,4-locale,translation,parity" ---
# README 4-File Sync Procedure
The GitHub-facing README set is 4 files at the repo root:
| File | Locale | Role | |------|--------|------| | `README.ko.md` | ko | **canonical / primary** — author here first | | `README.md` | en | derived | | `README.ja.md` | ja | derived | | `README.zh.md` | zh | derived |
> **Chain history**: the canonical locale was English until 2026-08-17, when > card t47 promoted the ko new-skeleton (feature-oriented section structure) > to canonical per the operator decision — aligning the README chain with the > docs-site chain, which was already ko-canonical. The former en-skeleton > redesign reference (`.moai/reports/readme-docs-redesign-20260713.md`) is > superseded by the ko skeleton and kept as history only.
## Procedure
1. **Author** the change in `README.ko.md` (Korean) only. Respect the canonical ko section skeleton; keep the file length in the range of the current set. 2. **Derive** en, ja, zh — same PR, one derived file per translator worker. Translate the changed sections minimally; do not rewrite untouched prose. 3. **Preserve verbatim** across all 4 files: code blocks, command names, badges, version strings, file paths, tables' structure, Mermaid direction, and the switcher header (below). 4. **Verify parity** (checklist below) before returning.
## Language-switcher header contract [HARD]
All 4 files share the same switcher header near the top, linking the sibling files with the label set exactly:
``` English · 한국어 · 日本語 · 中文 ```
- The current file's own label renders as plain text; the other 3 are links to the sibling README files. - Never reorder, drop, or re-label the 4 entries.
## Section-order parity checklist
- [ ] `grep -c '^## ' README.md README.ko.md README.ja.md README.zh.md` — identical H2 counts across the 4 files. - [ ] H2 section ORDER matches ko (compare `grep '^## '` output order). - [ ] H3 counts per section match for sections you touched. - [ ] Table row counts match in touched sections. - [ ] Code-block count matches (` ```` grep -c '^```' ```` ` is even and equal). - [ ] Switcher header present and correct in all 4. - [ ] URL blacklist clean: `grep -n 'docs\.moai-ai\.dev\|adk\.moai\.com\|adk\.moai\.kr' README*.md` → no matches.
## Manual verification recipe
No linter exists for the README set — verification is the manual recipe above plus rendering sanity: preview the markdown (GitHub-flavored) for the touched sections and confirm Mermaid blocks declare `TD`/`TB` only. The runnable docs-site checks live in Skill("hns-oss-docs-verify"); the README-specific checks are the greps above.
## Anti-patterns
| Anti-pattern | Correct approach | |--------------|------------------| | Editing `README.md` first "because GitHub is English-facing" | README canonical is ko — author `README.ko.md`, then derive | | Re-authoring an entire derived file for a 3-line canonical change | Minimal-diff derivation of the changed sections | | "Improving" facts/figures during translation | Report the discrepancy; amend canonical first | | Dropping the switcher header in a redesign | The 4-entry header is a HARD shared contract |
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-readme-sync, ready for a manual X post.
hns-oss-docs-readme-sync: README 4-file synchronization procedure for the oss-docs harness: Korean README.ko.md as prim... 1.2K stars https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-readme-sync?ref=x
Listing + install path for hns-oss-docs-readme-sync: https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-readme-sync?ref=x Install: npx skills add modu-ai/moai-adk --skill hns-oss-docs-readme-sync
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-readme-sync?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-readme-sync?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-readme-sync/audit)
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-readme-sync?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-readme-sync" agent skill from https://github.com/modu-ai/moai-adk/tree/main/.claude/skills/hns-oss-docs-readme-sync. 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: README 4-file synchronization procedure for the oss-docs harness: Korean README.ko.md as primary source, en/ja/zh derivation, the shared language-switcher header contract, section-order parity checklist, and the manual verification recipe (no linter exists for READMEs). Loaded by the content-author and locale-translator specialists for any README work. 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-readme-sync","task":"Install hns-oss-docs-readme-sync","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-readme-sync
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-readme-sync
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-readme-syncDo 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-readme-sync%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Resolve text
/api/agent/resolve?task=Use%20hns-oss-docs-readme-sync%20for%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text
Install handoff
/api/skills/modu-ai-hns-oss-docs-readme-sync/install
Agent should check
Copy prompt
Task: Use hns-oss-docs-readme-sync in this workspace.
Resolve first: https://www.openagentskill.com/api/agent/resolve?task=Use%20hns-oss-docs-readme-sync%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Review install handoff: https://www.openagentskill.com/api/skills/modu-ai-hns-oss-docs-readme-sync/install
Install command: npx skills add modu-ai/moai-adk --skill hns-oss-docs-readme-sync
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-readme-sync/install
LLM text format
/api/skills/modu-ai-hns-oss-docs-readme-sync/install?format=text
Find alternatives
/api/skills/search?q=hns-oss-docs-readme-sync&limit=3
Agent prompt
Use hns-oss-docs-readme-sync for this task. Review https://www.openagentskill.com/api/skills/modu-ai-hns-oss-docs-readme-sync/install, then install with: npx skills add modu-ai/moai-adk --skill hns-oss-docs-readme-syncRegistry 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-readme-sync
LLM text
/api/registry/manifest/modu-ai-hns-oss-docs-readme-sync?format=text
Install alias
/api/registry/install/modu-ai-hns-oss-docs-readme-sync
Recommend
/api/registry/recommend?task=Use%20hns-oss-docs-readme-sync%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.
Manage repositories
I need my agent to triage GitHub issues, review pull requests, and summarize repository changes.
Build and ship code
I need a coding agent that can understand a repository, edit code, and review pull requests.
Workflow fit
Find, compare, and synthesize
A workflow for agents that gather sources, compare claims, summarize long material, and draft useful research briefs.
Inspect, patch, and verify code
A workflow for software agents that inspect repositories, review pull requests, generate tests, and turn findings into shippable patches.
Turn skills into distribution
A workflow for turning newly indexed skills into SEO briefs, social drafts, comparison pages, and reusable publishing workflows.
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-readme-sync description: > README 4-file synchronization procedure for the oss-docs harness: Korean README.ko.md as primary source, en/ja/zh derivation, the shared language-switcher header contract, section-order parity checklist, and the manual verification recipe (no linter exists for READMEs). Loaded by the content-author and locale-translator specialists for any README work. allowed-tools: Read, Grep, Glob, Bash user-invocable: false metadata: version: "2.0.0" category: "harness" status: "active" updated: "2026-08-17" tags: "oss-docs,readme,4-locale,translation,parity" ---
# README 4-File Sync Procedure
The GitHub-facing README set is 4 files at the repo root:
| File | Locale | Role | |------|--------|------| | `README.ko.md` | ko | **canonical / primary** — author here first | | `README.md` | en | derived | | `README.ja.md` | ja | derived | | `README.zh.md` | zh | derived |
> **Chain history**: the canonical locale was English until 2026-08-17, when > card t47 promoted the ko new-skeleton (feature-oriented section structure) > to canonical per the operator decision — aligning the README chain with the > docs-site chain, which was already ko-canonical. The former en-skeleton > redesign reference (`.moai/reports/readme-docs-redesign-20260713.md`) is > superseded by the ko skeleton and kept as history only.
## Procedure
1. **Author** the change in `README.ko.md` (Korean) only. Respect the canonical ko section skeleton; keep the file length in the range of the current set. 2. **Derive** en, ja, zh — same PR, one derived file per translator worker. Translate the changed sections minimally; do not rewrite untouched prose. 3. **Preserve verbatim** across all 4 files: code blocks, command names, badges, version strings, file paths, tables' structure, Mermaid direction, and the switcher header (below). 4. **Verify parity** (checklist below) before returning.
## Language-switcher header contract [HARD]
All 4 files share the same switcher header near the top, linking the sibling files with the label set exactly:
``` English · 한국어 · 日本語 · 中文 ```
- The current file's own label renders as plain text; the other 3 are links to the sibling README files. - Never reorder, drop, or re-label the 4 entries.
## Section-order parity checklist
- [ ] `grep -c '^## ' README.md README.ko.md README.ja.md README.zh.md` — identical H2 counts across the 4 files. - [ ] H2 section ORDER matches ko (compare `grep '^## '` output order). - [ ] H3 counts per section match for sections you touched. - [ ] Table row counts match in touched sections. - [ ] Code-block count matches (` ```` grep -c '^```' ```` ` is even and equal). - [ ] Switcher header present and correct in all 4. - [ ] URL blacklist clean: `grep -n 'docs\.moai-ai\.dev\|adk\.moai\.com\|adk\.moai\.kr' README*.md` → no matches.
## Manual verification recipe
No linter exists for the README set — verification is the manual recipe above plus rendering sanity: preview the markdown (GitHub-flavored) for the touched sections and confirm Mermaid blocks declare `TD`/`TB` only. The runnable docs-site checks live in Skill("hns-oss-docs-verify"); the README-specific checks are the greps above.
## Anti-patterns
| Anti-pattern | Correct approach | |--------------|------------------| | Editing `README.md` first "because GitHub is English-facing" | README canonical is ko — author `README.ko.md`, then derive | | Re-authoring an entire derived file for a 3-line canonical change | Minimal-diff derivation of the changed sections | | "Improving" facts/figures during translation | Report the discrepancy; amend canonical first | | Dropping the switcher header in a redesign | The 4-entry header is a HARD shared contract |
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-readme-sync, ready for a manual X post.
hns-oss-docs-readme-sync: README 4-file synchronization procedure for the oss-docs harness: Korean README.ko.md as prim... 1.2K stars https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-readme-sync?ref=x
Listing + install path for hns-oss-docs-readme-sync: https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-readme-sync?ref=x Install: npx skills add modu-ai/moai-adk --skill hns-oss-docs-readme-sync
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-readme-sync?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-readme-sync?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-readme-sync/audit)
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-readme-sync?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-readme-sync" agent skill from https://github.com/modu-ai/moai-adk/tree/main/.claude/skills/hns-oss-docs-readme-sync. 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: README 4-file synchronization procedure for the oss-docs harness: Korean README.ko.md as primary source, en/ja/zh derivation, the shared language-switcher header contract, section-order parity checklist, and the manual verification recipe (no linter exists for READMEs). Loaded by the content-author and locale-translator specialists for any README work. 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-readme-sync","task":"Install hns-oss-docs-readme-sync","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-readme-sync
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-readme-sync
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-readme-syncDo 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-readme-sync%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Resolve text
/api/agent/resolve?task=Use%20hns-oss-docs-readme-sync%20for%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text
Install handoff
/api/skills/modu-ai-hns-oss-docs-readme-sync/install
Agent should check
Copy prompt
Task: Use hns-oss-docs-readme-sync in this workspace.
Resolve first: https://www.openagentskill.com/api/agent/resolve?task=Use%20hns-oss-docs-readme-sync%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Review install handoff: https://www.openagentskill.com/api/skills/modu-ai-hns-oss-docs-readme-sync/install
Install command: npx skills add modu-ai/moai-adk --skill hns-oss-docs-readme-sync
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-readme-sync/install
LLM text format
/api/skills/modu-ai-hns-oss-docs-readme-sync/install?format=text
Find alternatives
/api/skills/search?q=hns-oss-docs-readme-sync&limit=3
Agent prompt
Use hns-oss-docs-readme-sync for this task. Review https://www.openagentskill.com/api/skills/modu-ai-hns-oss-docs-readme-sync/install, then install with: npx skills add modu-ai/moai-adk --skill hns-oss-docs-readme-syncRegistry 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-readme-sync
LLM text
/api/registry/manifest/modu-ai-hns-oss-docs-readme-sync?format=text
Install alias
/api/registry/install/modu-ai-hns-oss-docs-readme-sync
Recommend
/api/registry/recommend?task=Use%20hns-oss-docs-readme-sync%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.
Manage repositories
I need my agent to triage GitHub issues, review pull requests, and summarize repository changes.
Build and ship code
I need a coding agent that can understand a repository, edit code, and review pull requests.
Workflow fit
Find, compare, and synthesize
A workflow for agents that gather sources, compare claims, summarize long material, and draft useful research briefs.
Inspect, patch, and verify code
A workflow for software agents that inspect repositories, review pull requests, generate tests, and turn findings into shippable patches.
Turn skills into distribution
A workflow for turning newly indexed skills into SEO briefs, social drafts, comparison pages, and reusable publishing workflows.
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-readme-sync description: > README 4-file synchronization procedure for the oss-docs harness: Korean README.ko.md as primary source, en/ja/zh derivation, the shared language-switcher header contract, section-order parity checklist, and the manual verification recipe (no linter exists for READMEs). Loaded by the content-author and locale-translator specialists for any README work. allowed-tools: Read, Grep, Glob, Bash user-invocable: false metadata: version: "2.0.0" category: "harness" status: "active" updated: "2026-08-17" tags: "oss-docs,readme,4-locale,translation,parity" ---
# README 4-File Sync Procedure
The GitHub-facing README set is 4 files at the repo root:
| File | Locale | Role | |------|--------|------| | `README.ko.md` | ko | **canonical / primary** — author here first | | `README.md` | en | derived | | `README.ja.md` | ja | derived | | `README.zh.md` | zh | derived |
> **Chain history**: the canonical locale was English until 2026-08-17, when > card t47 promoted the ko new-skeleton (feature-oriented section structure) > to canonical per the operator decision — aligning the README chain with the > docs-site chain, which was already ko-canonical. The former en-skeleton > redesign reference (`.moai/reports/readme-docs-redesign-20260713.md`) is > superseded by the ko skeleton and kept as history only.
## Procedure
1. **Author** the change in `README.ko.md` (Korean) only. Respect the canonical ko section skeleton; keep the file length in the range of the current set. 2. **Derive** en, ja, zh — same PR, one derived file per translator worker. Translate the changed sections minimally; do not rewrite untouched prose. 3. **Preserve verbatim** across all 4 files: code blocks, command names, badges, version strings, file paths, tables' structure, Mermaid direction, and the switcher header (below). 4. **Verify parity** (checklist below) before returning.
## Language-switcher header contract [HARD]
All 4 files share the same switcher header near the top, linking the sibling files with the label set exactly:
``` English · 한국어 · 日本語 · 中文 ```
- The current file's own label renders as plain text; the other 3 are links to the sibling README files. - Never reorder, drop, or re-label the 4 entries.
## Section-order parity checklist
- [ ] `grep -c '^## ' README.md README.ko.md README.ja.md README.zh.md` — identical H2 counts across the 4 files. - [ ] H2 section ORDER matches ko (compare `grep '^## '` output order). - [ ] H3 counts per section match for sections you touched. - [ ] Table row counts match in touched sections. - [ ] Code-block count matches (` ```` grep -c '^```' ```` ` is even and equal). - [ ] Switcher header present and correct in all 4. - [ ] URL blacklist clean: `grep -n 'docs\.moai-ai\.dev\|adk\.moai\.com\|adk\.moai\.kr' README*.md` → no matches.
## Manual verification recipe
No linter exists for the README set — verification is the manual recipe above plus rendering sanity: preview the markdown (GitHub-flavored) for the touched sections and confirm Mermaid blocks declare `TD`/`TB` only. The runnable docs-site checks live in Skill("hns-oss-docs-verify"); the README-specific checks are the greps above.
## Anti-patterns
| Anti-pattern | Correct approach | |--------------|------------------| | Editing `README.md` first "because GitHub is English-facing" | README canonical is ko — author `README.ko.md`, then derive | | Re-authoring an entire derived file for a 3-line canonical change | Minimal-diff derivation of the changed sections | | "Improving" facts/figures during translation | Report the discrepancy; amend canonical first | | Dropping the switcher header in a redesign | The 4-entry header is a HARD shared contract |
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-readme-sync, ready for a manual X post.
hns-oss-docs-readme-sync: README 4-file synchronization procedure for the oss-docs harness: Korean README.ko.md as prim... 1.2K stars https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-readme-sync?ref=x
Listing + install path for hns-oss-docs-readme-sync: https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-readme-sync?ref=x Install: npx skills add modu-ai/moai-adk --skill hns-oss-docs-readme-sync
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-readme-sync?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-readme-sync?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-readme-sync/audit)
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-readme-sync?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-readme-sync" agent skill from https://github.com/modu-ai/moai-adk/tree/main/.claude/skills/hns-oss-docs-readme-sync. 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: README 4-file synchronization procedure for the oss-docs harness: Korean README.ko.md as primary source, en/ja/zh derivation, the shared language-switcher header contract, section-order parity checklist, and the manual verification recipe (no linter exists for READMEs). Loaded by the content-author and locale-translator specialists for any README work. 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-readme-sync","task":"Install hns-oss-docs-readme-sync","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-readme-sync
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-readme-sync
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-readme-syncDo 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-readme-sync%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Resolve text
/api/agent/resolve?task=Use%20hns-oss-docs-readme-sync%20for%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text
Install handoff
/api/skills/modu-ai-hns-oss-docs-readme-sync/install
Agent should check
Copy prompt
Task: Use hns-oss-docs-readme-sync in this workspace.
Resolve first: https://www.openagentskill.com/api/agent/resolve?task=Use%20hns-oss-docs-readme-sync%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Review install handoff: https://www.openagentskill.com/api/skills/modu-ai-hns-oss-docs-readme-sync/install
Install command: npx skills add modu-ai/moai-adk --skill hns-oss-docs-readme-sync
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-readme-sync/install
LLM text format
/api/skills/modu-ai-hns-oss-docs-readme-sync/install?format=text
Find alternatives
/api/skills/search?q=hns-oss-docs-readme-sync&limit=3
Agent prompt
Use hns-oss-docs-readme-sync for this task. Review https://www.openagentskill.com/api/skills/modu-ai-hns-oss-docs-readme-sync/install, then install with: npx skills add modu-ai/moai-adk --skill hns-oss-docs-readme-syncRegistry 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-readme-sync
LLM text
/api/registry/manifest/modu-ai-hns-oss-docs-readme-sync?format=text
Install alias
/api/registry/install/modu-ai-hns-oss-docs-readme-sync
Recommend
/api/registry/recommend?task=Use%20hns-oss-docs-readme-sync%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.
Manage repositories
I need my agent to triage GitHub issues, review pull requests, and summarize repository changes.
Build and ship code
I need a coding agent that can understand a repository, edit code, and review pull requests.
Workflow fit
Find, compare, and synthesize
A workflow for agents that gather sources, compare claims, summarize long material, and draft useful research briefs.
Inspect, patch, and verify code
A workflow for software agents that inspect repositories, review pull requests, generate tests, and turn findings into shippable patches.
Turn skills into distribution
A workflow for turning newly indexed skills into SEO briefs, social drafts, comparison pages, and reusable publishing workflows.
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-readme-sync description: > README 4-file synchronization procedure for the oss-docs harness: Korean README.ko.md as primary source, en/ja/zh derivation, the shared language-switcher header contract, section-order parity checklist, and the manual verification recipe (no linter exists for READMEs). Loaded by the content-author and locale-translator specialists for any README work. allowed-tools: Read, Grep, Glob, Bash user-invocable: false metadata: version: "2.0.0" category: "harness" status: "active" updated: "2026-08-17" tags: "oss-docs,readme,4-locale,translation,parity" ---
# README 4-File Sync Procedure
The GitHub-facing README set is 4 files at the repo root:
| File | Locale | Role | |------|--------|------| | `README.ko.md` | ko | **canonical / primary** — author here first | | `README.md` | en | derived | | `README.ja.md` | ja | derived | | `README.zh.md` | zh | derived |
> **Chain history**: the canonical locale was English until 2026-08-17, when > card t47 promoted the ko new-skeleton (feature-oriented section structure) > to canonical per the operator decision — aligning the README chain with the > docs-site chain, which was already ko-canonical. The former en-skeleton > redesign reference (`.moai/reports/readme-docs-redesign-20260713.md`) is > superseded by the ko skeleton and kept as history only.
## Procedure
1. **Author** the change in `README.ko.md` (Korean) only. Respect the canonical ko section skeleton; keep the file length in the range of the current set. 2. **Derive** en, ja, zh — same PR, one derived file per translator worker. Translate the changed sections minimally; do not rewrite untouched prose. 3. **Preserve verbatim** across all 4 files: code blocks, command names, badges, version strings, file paths, tables' structure, Mermaid direction, and the switcher header (below). 4. **Verify parity** (checklist below) before returning.
## Language-switcher header contract [HARD]
All 4 files share the same switcher header near the top, linking the sibling files with the label set exactly:
``` English · 한국어 · 日本語 · 中文 ```
- The current file's own label renders as plain text; the other 3 are links to the sibling README files. - Never reorder, drop, or re-label the 4 entries.
## Section-order parity checklist
- [ ] `grep -c '^## ' README.md README.ko.md README.ja.md README.zh.md` — identical H2 counts across the 4 files. - [ ] H2 section ORDER matches ko (compare `grep '^## '` output order). - [ ] H3 counts per section match for sections you touched. - [ ] Table row counts match in touched sections. - [ ] Code-block count matches (` ```` grep -c '^```' ```` ` is even and equal). - [ ] Switcher header present and correct in all 4. - [ ] URL blacklist clean: `grep -n 'docs\.moai-ai\.dev\|adk\.moai\.com\|adk\.moai\.kr' README*.md` → no matches.
## Manual verification recipe
No linter exists for the README set — verification is the manual recipe above plus rendering sanity: preview the markdown (GitHub-flavored) for the touched sections and confirm Mermaid blocks declare `TD`/`TB` only. The runnable docs-site checks live in Skill("hns-oss-docs-verify"); the README-specific checks are the greps above.
## Anti-patterns
| Anti-pattern | Correct approach | |--------------|------------------| | Editing `README.md` first "because GitHub is English-facing" | README canonical is ko — author `README.ko.md`, then derive | | Re-authoring an entire derived file for a 3-line canonical change | Minimal-diff derivation of the changed sections | | "Improving" facts/figures during translation | Report the discrepancy; amend canonical first | | Dropping the switcher header in a redesign | The 4-entry header is a HARD shared contract |
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-readme-sync, ready for a manual X post.
hns-oss-docs-readme-sync: README 4-file synchronization procedure for the oss-docs harness: Korean README.ko.md as prim... 1.2K stars https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-readme-sync?ref=x
Listing + install path for hns-oss-docs-readme-sync: https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-readme-sync?ref=x Install: npx skills add modu-ai/moai-adk --skill hns-oss-docs-readme-sync
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-readme-sync?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-readme-sync?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-readme-sync/audit)
[](https://www.openagentskill.com/skills/modu-ai-hns-oss-docs-readme-sync?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