Agent skill

Hns Oss Docs Structure Map

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

docs-site structure map for the oss-docs harness structure-curator: exact paths and schemas for hugo.toml, per-locale content/<locale/meta.yaml, data/menu/main.yaml (4-locale name maps + icon…

Apache-2.0Auto-check: notesFrontend & Design

Install Hns Oss Docs Structure Map

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

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

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

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

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

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

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

Facts

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

At a glance

docs-site structure map for the oss-docs harness structure-curator: exact paths and schemas for hugo.toml, per-locale content/<locale/meta.yaml, data/menu/main.yaml (4-locale name maps + icon…

  • Tasks that involve Static sites and blogs
  • SKILL.md covers Path map, main.yaml entry schema, icon ↔ menu.html SVG-case… and vercel.json redirect pattern, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Hns Oss Docs Structure Map is an agent skill from modu-ai/moai-adk. docs-site structure map for the oss-docs harness structure-curator: exact paths and schemas for hugo.toml, per-locale content/<locale/meta.yaml, data/menu/main.yaml (4-locale name maps + icon values), the icon-to-SVG-case coupling in layouts/partials/menu.html, shortcodes, the FROZEN moai-brand.css, vercel.json redirect examples, and the known design-vs-guides divergence. Loaded by the structure-curator before any navigation or config edit.

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

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

When your agent uses it

  • Tasks that involve Static sites and blogs

Example prompts

  • “/hns-oss-docs-structure-map”

Requirements

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

What it can do on your machine

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

  • Tool permissions

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

    • Read
    • Grep
    • Glob
    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are yaml, bash and json).

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

  • Network

    No URLs in SKILL.md.

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Hns Oss Docs Structure Map loads about 866 tokens when it runs. Until then it costs about 118 tokens; SKILL.md has 272 words of instructions outside code blocks.

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

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

Safety

Auto-check: notes

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

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

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

SKILL.md

The full file from modu-ai/moai-adk at commit a2a184a, republished under its Apache-2.0 licence (© modu-ai). 272 words, ~866 tokens.

Download SKILL.mdSave it as .claude/skills/hns-oss-docs-structure-map/SKILL.md (or your agent's skills folder).
name
hns-oss-docs-structure-map
description
docs-site structure map for the oss-docs harness structure-curator: exact paths and schemas for hugo.toml, per-locale content/<locale>/_meta.yaml, data/menu/main.yaml (4-locale name maps + icon values), the icon-to-SVG-case coupling in layouts/partials/menu.html, shortcodes, the FROZEN moai-brand.css, vercel.json redirect examples, and the known design-vs-guides divergence. Loaded by the structure-curator before any navigation or config edit.
allowed-tools
Read, Grep, Glob, Bash
user-invocable
false
metadata.version
1.0.0
metadata.category
harness
metadata.status
active
metadata.updated
2026-07-13
metadata.tags
oss-docs,docs-site,hugo,geekdoc,menu,redirects,structure

docs-site Structure Map

Hugo geekdoc site at docs-site/, deployed to adk.mo.ai.kr via Vercel (auto-deploy on push). All paths below are relative to docs-site/.

Path map

SurfacePathNotes
Site confighugo.tomlNOT hugo.yaml. defaultContentLanguage = "ko"; version SSOT params.version / params.releaseDate
Contentcontent/{ko,en,ja,zh}/ko canonical; 4 locale trees mirror each other
Section ordercontent/<locale>/_meta.yamlper-locale; a section change lands in ALL FOUR files
Sidebar menudata/menu/main.yaml4-locale name maps + icon: per entry
Menu iconslayouts/partials/menu.htmlSVG switch/case per icon: value — coupling below
Shortcodeslayouts/shortcodes/icon.html (variants ok/warn/danger/primary/muted), etc.
CSSstatic/moai-brand.css (FROZEN — never edit), static/moai-design.cssClaude Warm Editorial, light-only theme
Redirectsvercel.jsonredirects array — the only Vercel surface this harness touches

main.yaml entry schema

Each sidebar entry carries a 4-locale name map and an icon:

yaml
- name:
    ko: 시작하기
    en: Getting Started
    ja: はじめに
    zh: 快速开始
  ref: /getting-started
  icon: rocket

icon ↔ menu.html SVG-case coupling [HARD]

Every icon: value in main.yaml MUST have a matching case in the SVG switch inside layouts/partials/menu.html. An unmatched value renders an empty <svg> — a silent visual defect (no build warning). After any icon edit:

bash
grep -n '"<icon-value>"' docs-site/layouts/partials/menu.html

If absent, add the SVG path case in the same change.

vercel.json redirect pattern

Moved/renamed pages require BOTH entries:

json
{
  "redirects": [
    { "source": "/:locale(ko|en|ja|zh)/old-path", "destination": "/:locale/new-path" },
    { "source": "/old-path", "destination": "/ko/new-path" }
  ]
}

The Vercel project binding itself is immutable — this harness edits only the redirects array.

Known divergence to reconcile

content/<locale>/_meta.yaml carries a design section while data/menu/main.yaml carries guides. When touching either file, reconcile toward the SSOT design report's 12→11 section restructure (.moai/reports/readme-docs-redesign-20260713.md) and record the resolution direction in your report.

Tooling reality

  • gen_menu.py (referenced by the legacy i18n rules doc) DOES NOT exist — menu edits are manual; use the coupling grep above.
  • Build check: cd docs-site && hugo --minify --gc must complete warning-free (a malformed _meta.yaml or menu entry surfaces here). Full recipe: Skill("hns-oss-docs-verify").

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

Files

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

Open the folder on GitHubat commit a2a184a

Compare with similar skills

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

Hns Oss Docs Structure Map compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hns Oss Docs Structure Map this skillmodu-ai/moai-adk1.2k—~866Automated safety check: NotesApache-2.0
Tabler Menus and Redirectstabler/tabler42k—~1.2kAutomated safety check: PassMIT
Frontend Design UltimateaAAaqwq/AGI-Super-Team1052 repos~2.7kAutomated safety check: PassMIT
Small Business Website Spechewi333/Mom-n-Pop-Skills122—~3.2kAutomated safety check: PassMIT
Ecosystem Usageevloghq/evlog1.9k—~1.2kAutomated safety check: PassMIT
Vercel React Best Practicessanity-io/sanity6.4k130 repos~1.6kAutomated safety check: PassMIT

Similar skills

  • Keeps Tabler pages reachable by updating the preview menu, docs menu and redirect table whenever a page is added, renamed, moved or removed.

    42k GitHub stars~1.2k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Frontend Design Ultimate

    aAAaqwq/AGI-Super-Team

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

    105 GitHub starsUsed in 2 repos~2.7k tokens
    Frontend & DesignAuto-check passed
  • Small Business Website Spec

    hewi333/Mom-n-Pop-Skills

    Planning reference for rebuilding a small business website: page structure, copy voice, estimator widget, SEO requirements, form handling, DNS migration, and the no-code vs static-framework decision…

    122 GitHub stars~3.2k tokensUpdated 27 days ago
    Frontend & DesignAuto-check passed
  • Ecosystem Usage

    evloghq/evlog

    Measure agent-facing traffic to the evlog docs site (MCP transport, raw Markdown, discovery paths) with Vercel Observability, and read it without inflating it.

    1.9k GitHub stars~1.2k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Official

    React and Next.js performance optimization guidelines from Vercel Engineering.

    6.4k GitHub starsUsed in 130 repos~1.6k tokens
    Frontend & DesignAuto-check passed
  • Starts the right Tabler dev server, keeps it from clashing with builds and verifies changes in the browser before a page or component is handed back.

    42k GitHub stars~1.2k tokensUpdated yesterday
    Frontend & DesignAuto-check passed

More from modu-ai/moai-adk

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

    1.2k GitHub stars~5.2k tokensUpdated today
    Auto-check: notes
  • MoAI Foundation Core

    modu-ai/moai-adk

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

    1.2k GitHub stars~5k tokensUpdated today
    Auto-check passed
  • MoAI SPEC Workflow

    modu-ai/moai-adk

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

    1.2k GitHub stars~5.1k tokensUpdated today
    Auto-check passed
  • MoAI TDD Workflow

    modu-ai/moai-adk

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

    1.2k GitHub stars~3.1k tokensUpdated today
    Auto-check passed
  • MoAI Worktree Management

    modu-ai/moai-adk

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

    1.2k GitHub stars~3.9k tokensUpdated today
    Auto-check passed
  • Watches a pull request's CI checks after creation, separates required from auxiliary failures, applies limited safe fixes and escalates anything semantic to you.

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

Works with

Questions about Hns Oss Docs Structure Map

What does Hns Oss Docs Structure Map do?

docs-site structure map for the oss-docs harness structure-curator: exact paths and schemas for hugo.toml, per-locale content/<locale/meta.yaml, data/menu/main.yaml (4-locale name maps + icon…. Hns Oss Docs Structure Map is an agent skill from modu-ai/moai-adk.json redirect examples, and the known design-vs-guides divergence.

When should I use Hns Oss Docs Structure Map?

Hns Oss Docs Structure Map fits situations like: tasks that involve Static sites and blogs.

How do I install Hns Oss Docs Structure Map in Claude Code?

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

How do I install Hns Oss Docs Structure Map in Codex?

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

Can I use Hns Oss Docs Structure Map in Cursor, Gemini CLI or GitHub Copilot?

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

What does Hns Oss Docs Structure Map need to run?

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

Does Hns Oss Docs Structure Map access the network?

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

Is Hns Oss Docs Structure Map safe to install?

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

What licence does Hns Oss Docs Structure Map use?

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

How many tokens does Hns Oss Docs Structure Map use?

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

What are the alternatives to Hns Oss Docs Structure Map?

Skills that share tags, products or a category with Hns Oss Docs Structure Map: Tabler Menus and Redirects (tabler/tabler, 42k stars), Frontend Design Ultimate (aAAaqwq/AGI-Super-Team, 105 stars), Small Business Website Spec (hewi333/Mom-n-Pop-Skills, 122 stars) and Ecosystem Usage (evloghq/evlog, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hns Oss Docs Structure Map?

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

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