CtrlK
BlogDocsLog inGet started
Tessl Logo

moai-workflow-docs-claim-check

Read-only check of whether the claims a public-facing document makes (README, release notes, install and usage guides) are supported by user-supplied evidence. Runs Preflight, Claim Triage, and Validation, splits composite claims into atomic ones, and labels each. Runs no commands and writes no fixes.

68

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

100%

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

The content is lean, highly actionable, and well-structured: a clear three-phase workflow with validation checkpoints and a checklist, supported by well-signaled one-level-deep reference files that were verified to exist.

DimensionReasoningScore

Conciseness

The body is dense procedural guidance with no padding and no explanations of concepts Claude already knows; every section (boundaries, phases, output contract, rationalizations, red flags, verification) earns its place.

3 / 3

Actionability

For an instruction-only skill the guidance is highly actionable — an exact four-value label set, three unsupported reasons, an ordered decision tree, an exact three-section output table, and anchoring rules telling Claude precisely what to produce.

3 / 3

Workflow Clarity

Phase 1/2/3 are clearly sequenced with explicit validation checkpoints ('Complete all three steps before triaging ... If a step cannot be completed, report that and stop'), an ordered gate walk with 'stop at the first gate', and a closing verification checklist.

3 / 3

Progressive Disclosure

The body is a concise overview that offloads full gate criteria and worked examples to two real, one-level-deep, clearly signaled reference files, summarized in a 'Bundled references' table — textbook progressive disclosure.

3 / 3

Total

12

/

12

Passed

Description

67%

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, distinctive, and written in correct third person, but it omits an explicit 'Use when...' trigger clause from the description field and relies on the separate when_to_use field for natural trigger phrasing.

Suggestions

Fold a concise 'Use when...' trigger clause into the description field itself (e.g. 'Use when auditing a README or release note for claims backed by evidence') so the description alone signals when to invoke.

Add more natural user-voice trigger terms to the description — 'audit a README', 'verify release-note claims', 'find unsupported or outdated statements' — instead of leaning on internal phase names (Preflight, Claim Triage, Validation).

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'Runs Preflight, Claim Triage, and Validation, splits composite claims into atomic ones, and labels each' — matching the anchor for multiple specific concrete actions.

3 / 3

Completeness

The 'what' is clearly answered, but there is no explicit 'Use when...' clause in the description field itself — the trigger guidance is split off into when_to_use, which caps completeness at 2 per the rubric guideline.

2 / 3

Trigger Term Quality

It names 'README, release notes, install and usage guides' and 'claims ... supported by ... evidence', but the natural user-voice triggers ('audit a README', 'find unsupported statements') live in when_to_use rather than the description, so common variations are missing.

2 / 3

Distinctiveness Conflict Risk

The read-only documentation claim-check niche with explicit 'Runs no commands and writes no fixes' boundaries is highly specific and unlikely to trigger for the wrong skill.

3 / 3

Total

10

/

12

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.

Validation14 / 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
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.