CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

moai-foundation-thinking

Unified thinking toolkit: Creative frameworks (Critical Evaluation, Diverge-Converge, Deep Questioning), First Principles reasoning (absorbed from moai-foundation-philosopher), and Adaptive Thinking via the `ultrathink` keyword. Use for ideation, strategic analysis, architecture decisions, and deep reasoning on complex problems.

Quality

75%

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 ./.claude/skills/moai-foundation-thinking/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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 delivers clearly sequenced, actionable thinking frameworks with defined outputs and a verification checklist, but it is padded with concepts Claude already knows, fabricated-sounding impact statistics, and model-version chatter. Its biggest structural defect is that most 'module' deep-dive links point to files that do not exist in the bundle, breaking progressive disclosure for the very content it claims to offload.

Suggestions

Fix the progressive-disclosure structure: either add the referenced modules/ files (critical-evaluation.md, diverge-converge.md, deep-questioning.md, first-principles.md, assumption-matrix.md, trade-off-analysis.md, cognitive-bias.md) or remove the dead links and keep the methodology inline — currently the links fail and the content is duplicated in the body.

Trim known-concept explanations and unverifiable claims: delete the fallacy/cognitive-bias glossaries and the 'IMPACT' statistics (60-80% catch rate, 3x solutions, 40-60% fewer requirement changes) that add tokens without actionable guidance.

Move the model-version discussion ('Opus 4.7+ built-in, including Opus 5.5 and 4.8', the 'GLM Compatible?' table column) into the existing Backward Compatibility/deprecated section, keeping only the operational rule: 'ultrathink → Claude native extended reasoning at xhigh effort'.

DimensionReasoningScore

Conciseness

The framework steps themselves are tightly written, but there is unnecessary explanation Claude doesn't need: glossaries of fallacies and cognitive biases it already knows, unverifiable IMPACT statistics ('catches 60-80% of flawed recommendations', 'finds 3x more viable solutions', 'reduces requirement changes by 40-60%'), and a time-sensitive model-version discussion ('Opus 4.7+ built-in, including Opus 5.5 and 4.8', 'GLM Compatible?') sitting outside any deprecated/old-patterns section. Not 4 because these padded sections are numerous enough to notice; not 2 because the bulk is efficient, structured instruction.

3 / 5

Actionability

Concrete, executable guidance for an instruction-only skill: specific quantities ('20-50 raw ideas', 'Group into 4-8 Themes', 'Select top 3-5'), generation prompts ('What if we...', 'How might we...'), weighted 1-10 scoring, defined output formats, a decision-complexity guide, and an explicit rule ('ultrathink → ALWAYS use Claude native extended reasoning with xhigh effort'). Not 5 because the body contains no worked example of applying any framework — those live in references/philosopher-examples.md — so common cases aren't covered inline.

4 / 5

Workflow Clarity

All three frameworks are clearly sequenced (7 steps, 5 phases, 6 layers), with a combined workflow (Question → Generate → Evaluate) and a decision-complexity guide mapping task types to frameworks. An explicit Verification checklist and Red Flags section exist. Not 5 because those checkpoints are separate end-sections rather than wired into the workflows as explicit 'verify before proceeding' steps, leaving minor validation gaps.

4 / 5

Progressive Disclosure

Section structure is good and the three existing references/ files are clearly signaled one level deep, but scored against the actual bundle, 7 of the 10 referenced paths point to a nonexistent modules/ directory (modules/critical-evaluation.md, modules/first-principles.md, modules/assumption-matrix.md, modules/trade-off-analysis.md, modules/cognitive-bias.md, etc.), so 'Full methodology in modules' navigation fails while the same methodology is inlined in the body. Not 4 because broken referenced paths and this duplication are more than minor organization gaps; not 2 because the SKILL.md itself is well structured and existing references are properly signaled.

3 / 5

Total

14

/

20

Passed

Description

80%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: it names the skill's components concretely, includes an explicit 'Use for...' clause with multiple concrete trigger phrases, and mentions the distinctive ultrathink keyword. Weaknesses are missing natural synonyms like 'brainstorming' and 'critical thinking', and a broad deep-reasoning trigger that risks overlap with related thinking skills.

DimensionReasoningScore

Specificity

Lists several specific named capabilities — 'Creative frameworks (Critical Evaluation, Diverge-Converge, Deep Questioning)', 'First Principles reasoning', and 'Adaptive Thinking via the `ultrathink` keyword' — with only minor gaps. Not 5 because it names components rather than concrete actions; it never states what each framework actually does (e.g., assess proposals, brainstorm 20-50 ideas).

4 / 5

Completeness

Explicitly answers both what ('Unified thinking toolkit: Creative frameworks..., First Principles reasoning..., and Adaptive Thinking via the `ultrathink` keyword') and when ('Use for ideation, strategic analysis, architecture decisions, and deep reasoning on complex problems') with concrete trigger phrases. Anchor 4 would require the 'when' to be less explicit than it is.

5 / 5

Trigger Term Quality

Good keyword coverage: 'ideation', 'strategic analysis', 'architecture decisions', 'deep reasoning', and the 'ultrathink' keyword are natural trigger phrases. Not 5 because common synonyms users would actually say — 'brainstorming', 'critical thinking', 'trade-offs' — are absent despite being the core of two frameworks.

4 / 5

Distinctiveness Conflict Risk

The named frameworks (Diverge-Converge, Deep Questioning, ultrathink) are distinctive, but 'deep reasoning on complex problems' is broad enough to trigger on nearly any hard task, and the skill explicitly absorbs and overlaps with the closely related 'moai-foundation-philosopher' — fits 'somewhat specific but could still overlap with similar skills'.

3 / 5

Total

16

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 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

relative_links

Relative link issues: 10 missing

Warning

Total

13

/

16

Passed

Repository

modu-ai/moai-adk

Path

.claude/skills/moai-foundation-thinking/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.