CtrlK
BlogDocsLog inGet started
Tessl Logo

hns-oss-docs-structure-map

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.

74

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is lean, actionable, and well-structured, with executable commands, concrete schema examples, and explicit validation checkpoints for the icon-coupling and build flows. It is a strong reference/structure-map skill with no notable weaknesses.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — it never explains what Hugo, geekdoc, or YAML are, and every line carries a specific fact (paths, schemas, FROZEN CSS, divergence). It is not level 2 because there is no unnecessary explanation or padding to tighten.

3 / 3

Actionability

It provides concrete executable commands ('grep -n '"<icon-value>"' docs-site/layouts/partials/menu.html', 'cd docs-site && hugo --minify --gc') plus copy-paste-ready YAML menu and vercel.json redirect examples. It is not level 2 because the guidance is complete and executable rather than pseudocode with missing details.

3 / 3

Workflow Clarity

Workflows carry explicit validation checkpoints: the icon-edit flow ('grep ... If absent, add the SVG path case') and the build check ('hugo --minify --gc must complete warning-free') with a feedback loop noting malformed _meta.yaml/menu entries surface there. It is not level 2 because validation is explicit rather than implicit or missing.

3 / 3

Progressive Disclosure

The body is well-organized into clear sections (path map, entry schema, icon coupling, redirect pattern, divergence, tooling) with one-level-deep, clearly signaled external references (Skill("hns-oss-docs-verify"), the report path) and no nested reference chains. It is not level 2 because references are clearly signaled and appropriately split rather than inline or poorly organized.

3 / 3

Total

12

/

12

Passed

Description

85%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific, comprehensive, and clearly occupies a distinct niche with explicit trigger guidance for when to load it. Its main weakness is that trigger terms lean on internal harness jargon rather than natural user phrasing.

Suggestions

Add a plain-language 'Use when ...' clause with natural terms (e.g., 'Use when editing the docs-site menu, redirects, locale content, or Hugo config') so the trigger reads as something a user would actually say.

Reduce reliance on internal jargon like 'structure-curator' and 'icon-to-SVG-case coupling' in favor of common variations (menu, sidebar, redirects, i18n content).

DimensionReasoningScore

Specificity

The description enumerates many concrete objects — 'exact paths and schemas for hugo.toml, per-locale content/<locale>/_meta.yaml, data/menu/main.yaml ... layouts/partials/menu.html, shortcodes, the FROZEN moai-brand.css, vercel.json redirect examples' — listing multiple specific concrete surfaces rather than vague language. It is not level 2 because coverage is comprehensive across named files rather than naming only a domain and a few actions.

3 / 3

Completeness

It answers 'what' ('docs-site structure map ... exact paths and schemas') and 'when' with an explicit equivalent trigger clause ('Loaded by the structure-curator before any navigation or config edit'). The explicit trigger guidance prevents the level-2 cap; it is not level 2 because both what and when are present and explicit.

3 / 3

Trigger Term Quality

Terms like 'oss-docs harness structure-curator', 'icon-to-SVG-case coupling', and 'design-vs-guides divergence' are internal jargon a user would rarely say naturally, though 'paths and schemas', 'navigation', and 'config edit' are somewhat relevant. It is not level 3 because it lacks common natural variations users would actually say, and not level 1 because it does include some concrete relevant keywords.

2 / 3

Distinctiveness Conflict Risk

The niche is highly specific — this particular Hugo geekdoc docs-site harness with FROZEN moai-brand.css and vercel.json redirects — making it unlikely to trigger for the wrong skill. It is not level 2 because the triggers are distinct rather than merely 'somewhat specific'.

3 / 3

Total

11

/

12

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

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

Warning

Total

15

/

16

Passed

Repository
modu-ai/moai-adk
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.