CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

moai-factory-foreman

One unattended factory foreman iteration: watch the backlog queue, dispatch the next operator-picked card to an isolated worker, collect completion evidence on read (not on claims), and report. This is the body the project's loop.md driver invokes each iteration of a bare /loop; it can also be invoked directly to test one cycle by hand.

Quality

91%

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.

A highly actionable, well-sequenced unattended workflow with strong validation gates and failure handling — the executable monitor script and evidence-on-read collection model are exemplary. The body is efficient but carries some trimmable duplication, and watch mechanics that could live in a reference file are inlined in the monolithic body.

Suggestions

Remove the duplicated pointer to the factory-dispatch rule (stated in both the HARD gate and the opening paragraph) and compress the Monitor timeout_ms paragraph to the operative rules (required input, 1800000 max, re-arm at expiry), tightening the body's token cost.

Split the queue-watch mechanics — the monitor script rationale, WAL/checksum explanation, and the forbidden database-path list — into a references/ file (e.g., references/queue-watch.md) and keep the body to the script plus a one-line pointer, matching the progressive_disclosure flag already declared in the frontmatter.

DimensionReasoningScore

Conciseness

The body is dense and mostly load-bearing — boundaries, permission pre-approval, and WAL/checksum rationale are environment-specific knowledge Claude does not already have. Minor over-explanation could be trimmed: the factory-dispatch rule path is stated in both the HARD gate and the opening paragraph, and the Monitor timeout_ms paragraph (persistent-option history, the -p session cap note) runs longer than the operative rules require.

4 / 5

Actionability

Fully executable guidance throughout: a copy-paste-ready monitor script (moai paths --field todo-dir plus the cksum poll loop), concrete commands (moai gtd list --json, moai gtd done <t-id>, moai factory next --card <id>), a fixed-field dispatch address block, and explicit worker standing orders. The common cases (arm watch, read queue, dispatch, collect, report) are each covered with runnable specifics.

5 / 5

Workflow Clarity

A seven-step numbered iteration with explicit validation checkpoints: evidence-gated card advancement ('Absence of a failure signal is not a pass'), missing/stale evidence keeping the card picked, watch re-arm on expiry, and a failure-handling section distinguishing transient worker failure from loop failure. The feedback loops the rubric demands for batch/destructive work are present, so no cap applies.

5 / 5

Progressive Disclosure

Good structure: clearly headed sections (Boundaries, The iteration, Factory seam, Failure handling) and external rule-file references (factory-dispatch.md, cross-session-messaging.md) that are one level deep and prominently signaled by the HARD gate. It falls short of the top anchor because ~60 lines of watch mechanics and database-path rules are inlined in the single body file with no bundle split, despite the frontmatter declaring progressive disclosure enabled.

4 / 5

Total

18

/

20

Passed

Description

92%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: concrete actions, an explicit and specific statement of when it runs (loop driver or manual single pass), and a distinct niche with minimal conflict risk. The only weakness is trigger-term coverage, which is good but not exhaustive of the synonyms an operator might use.

DimensionReasoningScore

Specificity

The description lists four concrete, comprehensive actions for one iteration: 'watch the backlog queue, dispatch the next operator-picked card to an isolated worker, collect completion evidence on read (not on claims), and report' — no coverage gap for a single-iteration skill.

5 / 5

Completeness

Both 'what' (watch, dispatch, collect evidence, report) and 'when' are explicitly and concretely answered: 'the body the project's loop.md driver invokes each iteration of a bare /loop; it can also be invoked directly to test one cycle by hand' names the exact trigger conditions. Not 4 because the when is specific and concrete rather than merely present-but-vague.

5 / 5

Trigger Term Quality

Good keyword coverage of the niche's natural terms ('backlog queue', 'foreman', 'bare /loop', 'dispatch', 'unattended'), but a few natural variations users of this system might say (e.g., 'todo queue', 'run the factory', 'queue pass') are absent, falling short of the comprehensive synonym coverage of the top anchor.

4 / 5

Distinctiveness Conflict Risk

'Unattended factory foreman iteration' over 'the backlog queue' with 'bare /loop' as trigger is a clear niche with distinct triggers; virtually no other skill would fire on these terms.

5 / 5

Total

19

/

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-factory-foreman/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.