CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

moai-lane-watchdog

One lane stall watchdog iteration: measure lane progress on three channels, classify the stall cause, apply the remedy or resolve the judgment through the decision ladder — instead of waiting on a reply — then record the outcome and report. Reads the unified --auto doctrine at .claude/rules/moai/workflow/auto-semantics.md for the ladder, the gate inventory, and the record formats.

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

88%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 an executable, well-sequenced procedure: concrete commands, enumerated outcomes, explicit validation checkpoints, feedback loops with retry ceilings, and hard boundary restatements. It is lean with only minor duplication, and its doctrine delegation to named one-level-deep files is sensible; the main improvement would be light trimming of repeated boundaries and slightly less dense §-cross-referencing.

DimensionReasoningScore

Conciseness

The body is dense procedural prose with zero explanations of concepts Claude already knows, but boundaries are stated twice ("Never prompt the operator; never answer an approval gate" in §0 and again in Boundaries; queue read-only in §6 and Boundaries) and "the moai MCP broker tools were removed in card t1908" is time-sensitive detail — minor trimming opportunities matching the efficient-with-minor-overreach anchor. Not 5: the duplication means not every token earns its place.

4 / 5

Actionability

Copy-paste-ready commands throughout — "moai factory renew <card-id> --json", "git rev-parse --short HEAD", "moai integration status", "moai decision read --scope card:<id>" — with enumerated outcomes ("renewed, refused-expired, refused-not-holder, or error"), explicit ceilings ("retry at most 3 times", "do not wait a third time"), and a literal decision-record line template; every classified cause has a concrete remedy. Not 4: the few unspecified artifacts (e.g. the "session-handoff resume message") are deliberately delegated to named doctrine files rather than left vague.

5 / 5

Workflow Clarity

The pass is explicitly ordered (§0a renew → §1 measure → §2 classify → §3 remedy → §5 record → §7 output) with validation checkpoints on every branch: the all-three-channels-unchanged-plus-N-minutes stall test, fail-open first observation, transient-vs-determinate adjudication with a retry ceiling, and the two-consecutive-wakes delegate escalation; "Every iteration ends in exactly one of" three terminal states. Not 4: checkpoints are explicit, not implicit; the destructive/batch cap does not apply since the skill is queue-readonly and writes only its own snapshot and records.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are all absent), so the full ~220-line procedure lives inline, delegating semantics to clearly-signaled one-level-deep external files (".claude/rules/moai/workflow/auto-semantics.md", factory-dispatch.md, cross-session-messaging.md) with each file's role stated — good structure with minor gaps, the 4 anchor. Not 5: navigation leans on dense §-cross-references into the doctrine (§6–7, §11, §14, §5.1) and no actual bundle reference files exist to carry the detail.

4 / 5

Total

18

/

20

Passed

Description

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

The description is highly specific and distinctive, enumerating the full watchdog pass lifecycle in concrete third-person terms with the right ecosystem vocabulary. Its weakness is separation of concerns: the "when to use" triggers live in a when_to_use field rather than the description itself, capping completeness, and natural trigger synonyms are missing.

Suggestions

Fold the trigger conditions from when_to_use into the description itself (e.g. append "Use when a lane session re-awakens on a loop tick, shows no progress across the watch window, or waits on an unanswered judgment") so the description field alone answers both what and when.

Add natural trigger synonyms — "stuck", "blocked", "hung", "unattended" — alongside "stall" and "no progress" to broaden keyword coverage for the 4→5 trigger_term_quality gap.

DimensionReasoningScore

Specificity

"measure lane progress on three channels, classify the stall cause, apply the remedy or resolve the judgment through the decision ladder — then record the outcome and report" enumerates five concrete actions covering the full pass lifecycle, matching the comprehensive-coverage anchor. Not 4: no coverage gaps — the whole measure→classify→remedy→record→report cycle is stated; third-person voice, so no voice penalty applies.

5 / 5

Completeness

The description field gives a clear "what" but contains no "Use when..." clause — only the weak implication "instead of waiting on a reply" — because the explicit trigger guidance was placed in the separate when_to_use field, capping completeness at 3 per the rubric guideline. Not 4: the "when" is absent from the description itself, not merely imprecise.

3 / 5

Trigger Term Quality

Terms like "lane", "stall", "watchdog", "judgment", and "waiting on a reply" are the natural vocabulary of this ecosystem's operators, but common variations ("stuck", "blocked", "hung", "unattended") are absent — the good-coverage-with-a-few-missing anchor. Not 5 (no synonyms/extensions listed) and not 3 (the phrases present are ones users would actually say).

4 / 5

Distinctiveness Conflict Risk

"One lane stall watchdog iteration" and "the unified --auto doctrine at .claude/rules/moai/workflow/auto-semantics.md" carve out a clear moai-factory niche with ecosystem-specific triggers, so it would virtually never fire for the wrong skill. Matches the clear-niche/minimal-conflict anchor.

5 / 5

Total

17

/

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/moai-lane-watchdog/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.