CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

moai-foundation-quality

TRUST 5 quality principles and how MoAI enforces them through agents, the 3-level harness, /moai gate, and sync-auditor scoring. Use for code review, quality gate checks, coverage targets, or TRUST 5 compliance.

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/moai-foundation-quality/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

60%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.

The body is a well-organized, actionable knowledge skill with useful tables, thresholds, and a verification checklist, weakened by duplicated Quick Reference content and by a progressive-disclosure layer whose module links mostly point at files missing from the bundle. Fixing the bundle would materially raise both structure scores.

Suggestions

Add the four missing files under modules/ (trust5-validation.md, proactive-analysis.md, best-practices.md, integration-patterns.md) or remove/inline those links — the body currently promises on-demand content that cannot be loaded.

Deduplicate the Quick Reference section: it restates /moai gate, the harness levels, cycle_type, and sync-auditor scoring that each have dedicated sections below; keep it to a one-line pointer per mechanism.

Correct the broken anchor 'references/reference.md#language-aware-toolkchains' to '#language-aware-toolkchains' → '#language-aware-toolchains' and remove the repeated 'MoAI does not ship a quality library' statement (appears in both the intro and 'The MoAI Quality Model').

DimensionReasoningScore

Conciseness

The body is dense and table-driven, but the 'Quick Reference' section restates /moai gate, the 3-level harness, cycle_type, and sync-auditor scoring that each reappear verbatim in dedicated sections, and 'MoAI does NOT ship a quality-validation library' is stated twice (intro and 'The MoAI Quality Model'). This is more than minor trimming, so it sits at 'mostly efficient but could be tightened' rather than anchor 4.

3 / 5

Actionability

Concrete, specific guidance throughout: quantified thresholds (85% coverage, ≤10 warnings, zero errors, <30s gate), a per-phase owner table, a language-to-toolchain table, and per-principle assessment questions like 'Are credentials kept out of version control?'. Minor gaps — e.g. no example command invocations or gate output — hold it below the fully executable anchor 5.

4 / 5

Workflow Clarity

The plan/run/sync/audit phase table sequences quality checks with named owners, the harness-level table gives selection criteria, and the Verification checklist demands shown evidence ('show the command output', 'show assessment for each'). It is not anchor 5 because error-recovery/triage loops are delegated to module files that are absent, leaving some checkpoints implicit.

4 / 5

Progressive Disclosure

The reference architecture is well designed (overview plus clearly signaled, load-conditioned modules), but scored against the actual bundle: four of the six referenced files — modules/trust5-validation.md, modules/proactive-analysis.md, modules/best-practices.md, and modules/integration-patterns.md — do not exist, and the anchor link 'references/reference.md#language-aware-toolkchains' is misspelled. A majority of navigation paths dead-end, which is a broken structure rather than a mere organization gap.

2 / 5

Total

13

/

20

Passed

Description

83%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 in third-person voice with an explicit 'Use for...' trigger clause, concrete mechanism names, and a distinctive MoAI-specific vocabulary. Its only weaknesses are a few missing natural trigger variations and the broad 'code review' phrase that could collide with generic review skills.

DimensionReasoningScore

Specificity

The description names four concrete enforcement mechanisms — 'agents, the 3-level harness, /moai gate, and sync-auditor scoring' — plus the TRUST 5 principle set, giving several specific capabilities with minor gaps. It falls short of anchor 5 because it describes mechanisms rather than a comprehensive list of concrete actions (cf. 'extract text, fill forms, merge documents, convert pages'), and is well above anchor 3's '1-2 concrete actions'.

4 / 5

Completeness

It explicitly answers both questions: what ('TRUST 5 quality principles and how MoAI enforces them through agents, the 3-level harness, /moai gate, and sync-auditor scoring') and when ('Use for code review, quality gate checks, coverage targets, or TRUST 5 compliance') with concrete trigger phrases — a direct match to the anchor-5 example pattern.

5 / 5

Trigger Term Quality

'Use for code review, quality gate checks, coverage targets, or TRUST 5 compliance' supplies natural phrases a user would actually say. It misses common variations such as 'lint', 'code quality', 'testing', or 'best practices', which keeps it at 'good keyword coverage; a few natural terms missing' rather than comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

MoAI-specific terms (TRUST 5, /moai gate, sync-auditor, 3-level harness) form a clear niche with minimal conflict risk, but the generic 'code review' trigger overlaps broadly with general code-review and security-review skills. This is 'mostly distinct; minor overlap risk', short of anchor 5's fully conflict-free triggers.

4 / 5

Total

17

/

20

Passed

Validation

81%

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

Validation — 13 / 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

relative_links

Relative link issues: 5 missing

Warning

Total

13

/

16

Passed

Repository

modu-ai/moai-adk

Path

.claude/skills/moai-foundation-quality/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.