CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

moai-workflow-jit-docs

Enhanced Just-In-Time document loading system that discovers, loads, and caches relevant documentation based on user intent and project context. Use when users need specific documentation on demand.

Quality

53%

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 ./.moai/archive/skills/v3.0/moai-workflow-jit-docs/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

31%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 long conceptual description of a JIT documentation system rather than an actionable skill: it explains intent detection, prioritization, caching, and quality weighting that Claude largely already knows, without a single executable tool call or query example. Worse, the bundle's two reference files (reference.md, examples.md) are never referenced, so the inlined bulk is not offloaded to them.

Suggestions

Cut the body to a concise Quick Reference (triggers, source priority, and one end-to-end example) and move the intent-analysis/quality-assessment detail into the existing references, linking them explicitly, e.g. "**API details**: See [reference.md](references/reference.md); **worked examples**: See [examples.md](references/examples.md)".

Replace abstract instructions with one or two concrete tool invocations, e.g. an actual WebSearch query string for a FastAPI/JWT question or the exact Context7 call sequence, so the workflow is executable rather than descriptive.

Convert the Practical Workflows into numbered steps with an explicit validation checkpoint (e.g. 'confirm the retrieved doc covers the named technology before answering; if zero results, refine the query once') and fold the rationalizations/red-flags tables into the verification reference rather than the main body.

DimensionReasoningScore

Conciseness

The ~260-line body spends most of its tokens describing behavior Claude already knows — source prioritization, search refinement, caching, relevance weighting ("Weight authority (30%), recency (25%)") — plus meta sections like a rationalizations table. This matches 'noticeably verbose; several unnecessary explanations or padded sections'; not a 1 because the bullet style is dense rather than tutorial-padded prose.

2 / 5

Actionability

The body names real tools (WebSearch, WebFetch, Context7 MCP) and paths (.moai/docs/, docs/) but never shows an executable command, tool call, or query example — e.g. "Load FastAPI security documentation via WebFetch" with no URL pattern, query, or invocation. This matches 'minimal concrete guidance; high-level hints but missing the specific steps'; not a 1 because specific tools and search locations are named.

2 / 5

Workflow Clarity

The three Practical Workflows list ordered steps (detect technologies → identify domains → load docs → search → provide guidance) and the Error Handling section adds fallbacks, but no step is verifiable — no command to run, no check that a load succeeded, and the Verification checklist is post-hoc rather than a checkpoint. Fits 'steps listed but validation gaps; checkpoints missing or implicit'; not a 4 because no executable checkpoint exists at any step.

3 / 5

Progressive Disclosure

The bundle contains references/reference.md (an API reference) and references/examples.md, but neither file is linked or mentioned anywhere in the body — the references are fully orphaned. Meanwhile ~260 lines of API-style and conceptual detail are inlined, matching 'minimal structure; content that clearly belongs in separate files is inlined; or references are buried'; not a 3 because existing bundle files receive no navigation signal at all.

2 / 5

Total

9

/

20

Passed

Description

56%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 answers both what and when with a clear action trio (discover, load, cache), but the trigger clause is generic and unlikely to match how users actually phrase documentation requests. It is serviceable but leaves trigger matching and distinctiveness from sibling docs skills under-specified.

Suggestions

Rewrite the 'Use when' clause with natural user phrasings, e.g. "Use when the user asks a specific technical question ('how do I implement X?', 'what's the current best practice for Y'), or mentions a framework, library, or tool whose API you don't already know."

Sharpen the what with concrete scope: name the source types covered (local .moai/docs and docs/, official docs via WebFetch/Context7, community results via WebSearch) so the description distinguishes this skill from sibling documentation-generation skills.

Add 2-3 example trigger phrasings or keywords (e.g. 'docs for', 'API reference', 'getting started') to make the description distinguishable from other moai documentation skills.

DimensionReasoningScore

Specificity

"discovers, loads, and caches relevant documentation" names the domain and three concrete actions, matching the 'several specific actions; minor gaps in coverage' anchor. It stops short of a 5 because the actions are coarse-grained — no source types, retrieval steps, or output behavior are enumerated.

4 / 5

Completeness

Both are present: what = "discovers, loads, and caches relevant documentation based on user intent and project context", when = "Use when users need specific documentation on demand". This fits the 'both what and when; when could be more explicit' anchor; it is not a 5 because the 'when' clause lacks concrete trigger situations or question forms.

4 / 5

Trigger Term Quality

The only trigger phrase is "Use when users need specific documentation on demand", which is one generic keyword ('documentation') with unnatural phrasing — users would say 'look up the docs for X' or 'what's the best practice for Y', not 'need specific documentation on demand'. Matches the 'one or two generic keywords; missing the natural phrases users say' anchor; not a 3 because no common synonyms or question-form triggers appear.

2 / 5

Distinctiveness Conflict Risk

The 'Just-In-Time document loading' framing carves out a niche versus doc-generation skills, but the trigger ('users need specific documentation') overlaps broadly with the sibling documentation skills this bundle itself lists (moai-docs-generation, workflow-docs, moai-workflow-docs). Fits 'somewhat specific but could still overlap with similar skills'; not a 4 given that live overlap risk with closely related skills.

3 / 5

Total

13

/

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

.moai/archive/skills/v3.0/moai-workflow-jit-docs/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.