CtrlK
BlogDocsLog inGet started
Tessl Logo

moai-foundation-context

Manages context window optimization, session state persistence, and token budget allocation for multi-agent workflows. Use for token budget management, context limits, or session handoff across agents.

55

Quality

63%

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

Fix and improve this skill with Tessl

tessl review fix ./.moai/archive/skills/v3.0/moai-foundation-context/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%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 well-structured with concrete thresholds, clear workflow sequences, and validation checkpoints, but it suffers from structural redundancy (duplicated "When to Use" and "Core Patterns" sections), underspecified execution mechanics that delegate to missing module files, and a broken progressive-disclosure structure where referenced paths do not exist and real reference files are orphaned.

Suggestions

Fix the reference structure: either add the six modules/*.md files to the bundle or repoint the "Advanced Documentation" section to the existing references/examples.md and references/reference.md, and link them from the body.

De-duplicate the body by merging the two "When to Use" sections and collapsing the "Core Patterns" overview into the "Core Patterns Detail" section.

Add the missing execution mechanics (how to measure token usage, how to perform compression) inline or in a real referenced file so the guidance is executable rather than delegated to non-existent modules.

DimensionReasoningScore

Conciseness

It assumes Claude's intelligence and avoids explaining known concepts, but structural redundancy pads the body — "When to Use" appears twice (lines 56-63 and 89-95), "Core Patterns" is summarized (lines 97-109) then re-expanded as "Core Patterns Detail" (lines 111-157), and the Key Principles / Best Practices / Required Practices lists overlap — so it is mostly efficient but clearly could be tightened, landing at 3 rather than 2 (no condescending over-explanation) or 4 (the duplication is non-trivial).

3 / 5

Actionability

It gives some concrete, executable directives — specific thresholds (150K/180K/85%/75%/60%), the /clear command, and the handoff-package field list — but the implementation mechanics (how to actually measure tokens, how compression is performed) are underspecified and delegated to module files that do not exist, leaving the guidance incomplete; this fits anchor 3 rather than 4 where guidance would be mostly executable.

3 / 5

Workflow Clarity

Multi-step processes are clearly sequenced (the SPEC-First workflow as plan→/clear→run→handoff→sync→persist, and the Context Checkpointing monitor→preserve→clear→reload→resume sequence) with validation checkpoints present (handoff validation with a 30K buffer, pre-/clear session persistence, and a Verification checklist); it is not a 5 because some validation remains vague ("Execute state validation checks") rather than an explicit validate→fix→retry loop.

4 / 5

Progressive Disclosure

There is clear section structure and a dedicated, clearly signaled "Advanced Documentation" reference list, but the six referenced modules/*.md files do not exist in the bundle, the actual bundle files (references/examples.md, references/reference.md) are orphaned and never linked from the body, and the six full pattern write-ups are inlined rather than split into the referenced modules — so navigation is only partially functional, fitting anchor 3 rather than 4.

3 / 5

Total

13

/

20

Passed

Description

70%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 third-person, answers both what and when with an explicit "Use for" trigger clause, and carries good natural keyword coverage. Its main limitation is that the capabilities are framed as abstract domains rather than crisp concrete actions, and the "when" is scenario-based rather than user-utterance-based.

Suggestions

Replace abstract capability labels with concrete actions, e.g. "Tracks token usage against a 200K budget, persists session state across /clear, and packages handoff context between agents."

Add user-utterance triggers to the "when" clause, e.g. "Use when the user mentions token limits, context window pressure, or session handoff between agents."

Include a few more natural synonyms in the description itself (e.g. "token limit", "context management") rather than only in the triggers block.

DimensionReasoningScore

Specificity

Names the domain (multi-agent context management) and three action-named capabilities — "context window optimization, session state persistence, and token budget allocation" — but these are higher-level capability labels rather than the granular concrete actions (e.g. "Extracts text, fills forms") that anchor 4 requires, so it sits at 3 and not 4.

3 / 5

Completeness

Explicitly answers both: "Manages context window optimization, session state persistence, and token budget allocation..." (what) and "Use for token budget management, context limits, or session handoff across agents" (when), with an explicit "Use for" clause and three concrete trigger phrases; it is not a 5 because the "when" is scenario-focused rather than user-utterance-focused (no "when the user mentions..." phrasing).

4 / 5

Trigger Term Quality

Good coverage of natural terms a user would say — "token budget management", "context limits", "session handoff", "context window", "multi-agent" — with some synonyms; it falls short of anchor 5 only because a few natural variations (e.g. "token limit", "memory", "context management") that appear in the triggers block are absent from the description itself.

4 / 5

Distinctiveness Conflict Risk

The "multi-agent workflows" and "session handoff across agents" framing carves a fairly specific niche with distinct triggers (token budget, session handoff), with only minor overlap risk against closely related memory/session skills; it is not a 5 because terms like "context" and "session" still overlap with sibling skills (moai-cc-memory, moai-core-workflow).

4 / 5

Total

15

/

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.

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.