CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

hns-moaiadk-dev-reference

moai-adk-go local dev reference — version management/release process (sec 5), shell-script hook development (sec 7), build & dev commands (sec 10). Load only when performing these specific tasks.

Quality

84%

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

82%Weight 40%Scale 1-5

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

A lean, highly actionable reference skill: concrete commands, code, and config snippets throughout, with two clearly sequenced workflows. The main weaknesses are the missing validation step in the release process and a flat single-file structure where a small reference split (e.g., platform differences or hook config) could reduce inline bulk.

DimensionReasoningScore

Conciseness

The body is dominated by lean commands, file lists, and config snippets with almost no filler. Not 5: a few tokens could be trimmed ("Why Shell Scripts" rationale bullets, the parenthetical about the platform-default 10-minute timeout); not 3: there is no genuine over-explanation of concepts Claude already knows.

4 / 5

Actionability

Everything is copy-paste ready: the ldflags build command, the hook wrapper bash script, the settings.json hook config, platform-specific command strings for macOS/Linux/Windows, make targets, and numbered release/dev workflows. This matches the anchor-5 pattern of executable commands covering the common cases.

5 / 5

Workflow Clarity

Both multi-step workflows are clearly sequenced, and the dev workflow embeds checkpoints (regenerate, run tests, test locally before commit). Not 5: the release process (changelog → tag → push → build) has no validation/verify step such as running tests before tagging; the destructive/batch cap is not triggered since neither workflow is a batch or destructive manipulation.

4 / 5

Progressive Disclosure

Three cleanly delineated sections with clear headers and consistent [HARD]-rule flagging, no buried or nested references. Not 5: at ~165 lines with no bundle files it exceeds the simple-skill exception, and all detail is inlined flatly rather than split into a one-level-deep reference structure; not 3: nothing that clearly belongs in a separate file is inlined and navigation is easy.

4 / 5

Total

17

/

20

Passed

Description

78%Weight 40%Scale 1-5

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

A specific, distinctive description that names its domain and three concrete task areas with an explicit load condition. Its main gap is that the trigger clause is generic ("these specific tasks") rather than restating the concrete "Use when..." phrases, and the CLAUDE.local.md section numbers add internal jargon.

DimensionReasoningScore

Specificity

Names the domain ("moai-adk-go local dev reference") and three concrete task areas ("version management/release process", "shell-script hook development", "build & dev commands"). Anchor 5 requires enumerated concrete actions with comprehensive coverage, which a topical listing does not reach.

4 / 5

Completeness

Has a clear "what" plus an explicit trigger clause ("Load only when performing these specific tasks"), so it is not capped at 3. Not 5: the "when" clause points back generically instead of restating concrete trigger phrases like the anchor-5 example.

4 / 5

Trigger Term Quality

Good natural keyword coverage ("version management", "release process", "hook development", "build & dev commands") that a repo developer would actually say. Not 5: "sec 5/7/10" references are internal jargon and some common synonyms are missing; not 3 since coverage is solid rather than partial.

4 / 5

Distinctiveness Conflict Risk

Firmly niche — scoped to the moai-adk-go repository's dev tasks with no overlap risk against generic skills. Clearly matches the anchor-5 example's clear-niche pattern.

5 / 5

Total

17

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

modu-ai/moai-adk

Path

.claude/skills/hns-moaiadk-dev-reference/SKILL.md

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.