CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

hns-moaiadk-patterns

moai-adk-go domain-patterns reference for the 4 harness specialists (cli-template-specialist, quality-specialist, workflow-specialist, hook-ci-specialist). Covers the CLI/template/config/hook/spec subsystem architecture, key source paths, the Pipeline specialist delegation map, the Template-First build cycle, the namespace separation contract, and common add-a-template / add-a-hook / add-an-agent / add-a-SPEC workflows. Loaded by the specialists when working on moai-adk-go's own Go codebase and templates.

Quality

83%

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

75%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 well-structured domain reference: lean tables, concrete commands, and workflows with real validation gates. Every dimension sits at anchor 4 due to small, identifiable gaps — repeated facts, unspecified gate details, no explicit error-recovery loops, and advertised-but-absent optional reference files.

Suggestions

State the embed.go fact once (in the Key Source Paths table) and reference it from the Build Cycle, and drop the duplicated 'Never edit .claude/ or .moai/ directly' sentence since step 1 of the cycle already implies it — this would push conciseness to anchor 5.

Briefly enumerate the sync-auditor's four scoring dimensions (or link to where they are defined) so the gate in the Add-a-SPEC workflow is actionable without external context.

Add explicit error-recovery branches to the Template-First cycle (e.g. 'if the neutrality audit fails, fix the template and re-run make build + moai update'), or move the delegation map into a small reference file to back the frontmatter's level_3_optional claim.

DimensionReasoningScore

Conciseness

The body is dense and factual — tables, a path map, and terse numbered steps — with no explanations of concepts Claude already knows. It fits anchor 4 rather than 5 because of repeated facts: "//go:embed all:templates" appears three times (Architecture, Key Paths, Build Cycle) and the Template-First rule is stated twice in the same section.

4 / 5

Actionability

Mostly executable guidance with concrete commands: `make build`, `moai update`, `./moai init /tmp/test-project`, `go test ./internal/template/... -run TestTemplateNeutralityAudit`, and `/moai plan "<description>"`. Minor gaps remain, e.g. "sync-auditor 4-dimension gate" never states what the four dimensions are, and the delegation-map entries name agents without their prompts or paths.

4 / 5

Workflow Clarity

Each workflow is a clear numbered sequence with explicit validation checkpoints (`go test` neutrality audit, "Verify the local .claude/ .moai/ reflects the template", plan-auditor audit gate, human approval gate), so the destructive/batch cap does not apply. It stops short of anchor 5 because no error-recovery feedback loops (if-fails-then-fix-and-retry) are spelled out.

4 / 5

Progressive Disclosure

No bundle files (references/, scripts/, assets/) exist, and the single SKILL.md is well organized into clearly headed sections with a Cross-References section listing one-level-deep, clearly signaled project paths. Minor gaps: the frontmatter advertises level_3_optional with no optional reference files present, and dense inline material like the delegation map could live in a reference file.

4 / 5

Total

16

/

20

Passed

Description

87%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 strong description: it clearly and explicitly states what the reference covers, when it loads, and who its consumers are, in concise third-person voice. The only weakness is that some natural trigger synonyms live in the frontmatter triggers block rather than the description text itself.

DimensionReasoningScore

Specificity

The description explicitly names six specific coverage areas ("CLI/template/config/hook/spec subsystem architecture, key source paths, the Pipeline specialist delegation map, the Template-First build cycle, the namespace separation contract") plus concrete add-a-template / add-a-hook / add-an-agent / add-a-SPEC workflows. It matches anchor 4 (several specific items, minor gaps) rather than 5 because it describes coverage of a reference rather than comprehensive concrete actions, and leaves scope edges unstated.

4 / 5

Completeness

Both what and when are explicitly stated: the "what" is the detailed coverage list, and the "when" is "Loaded by the specialists when working on moai-adk-go's own Go codebase and templates" — an explicit trigger clause (so the missing-'Use when' cap does not apply). Voice is third person ("Covers", "Loaded by"), matching the top anchor.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "moai-adk-go", "Go codebase", "templates", the four specialist names, and "add-a-hook / add-a-SPEC" workflows. It falls short of anchor 5 because file extensions and additional synonyms (e.g. embed.go, make build, go:embed) appear only in the frontmatter triggers block, not in the description itself.

4 / 5

Distinctiveness Conflict Risk

A clear niche with distinct triggers: scoped to "moai-adk-go domain-patterns reference for the 4 harness specialists (cli-template-specialist, quality-specialist, workflow-specialist, hook-ci-specialist)" — the named agents and product-specific terms make triggering for the wrong skill very unlikely.

5 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

allowed_tools_field

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

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

modu-ai/moai-adk

Path

.claude/skills/hns-moaiadk-patterns/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.