CtrlK
BlogDocsLog inGet started
Tessl Logo

moyu

Anti-over-engineering guardrail that activates when an AI coding agent expands scope, adds abstractions, or changes files the user did not request.

48

Quality

53%

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 ./plugins/AI-Agents-Safe-Coding-Skills/skills/moyu/SKILL.md

The canonical home for this skill is moyu in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

52%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill has a clear and valuable purpose — preventing AI over-engineering — and provides highly actionable guidance through well-structured tables, a checklist, and escalation levels. However, it is significantly over-long for its core message, with multiple sections restating the same principles in different formats, which ironically violates its own philosophy of minimalism. The content would benefit from aggressive trimming and splitting into multiple files.

Suggestions

Reduce redundancy by consolidating the 'Three Iron Rules,' 'Grinding vs Moyu' tables, and 'Anti-Grinding Table' — these all convey the same core principles and could be merged into a single concise section with the best examples from each.

Split the extensive comparison tables into a separate reference file (e.g., EXAMPLES.md) and keep only 2-3 representative examples inline in SKILL.md.

Remove explanations of concepts Claude already knows (YAGNI, DRY tradeoffs, optional chaining vs lodash) and instead state the behavioral rule directly without justification.

Add a link or path reference for the mentioned 'PUA' skill in the Compatibility section.

DimensionReasoningScore

Conciseness

While the content is well-written and the tables are a good format, the skill is extremely verbose (~200+ lines) for what amounts to a behavioral guardrail. Many sections are redundant — the 'Three Iron Rules,' 'Grinding vs Moyu' tables, 'Anti-Grinding Table,' and 'Over-Engineering Detection Levels' all repeat the same core message (don't change what wasn't asked) in different formats. Claude already understands concepts like YAGNI, DRY tradeoffs, and scope control; this over-explains extensively.

2 / 5

Actionability

The skill provides concrete, actionable guidance through the checklist, the detection levels with specific triggers and actions, and the detailed comparison tables with specific examples (e.g., 'json.load(f)' vs config class + validator + builder). However, it lacks executable code examples since it's a behavioral skill, which is appropriate. Minor gap: the detection levels could benefit from more concrete examples of how to identify line counts or scope violations programmatically.

4 / 5

Workflow Clarity

The Over-Engineering Detection Levels (L1-L4) provide a clear escalation workflow with specific triggers and actions at each level. The Moyu Checklist provides a clear pre-delivery validation step. Minor gap: there's no explicit feedback loop between the checklist and the detection levels — e.g., what happens if the checklist reveals issues after L2 correction? The 'one change at a time, verify before continuing' guidance is good but could be more explicitly sequenced.

4 / 5

Progressive Disclosure

All content is inlined in a single monolithic file with no references to supporting files. Given the length (~200+ lines) and the multiple distinct sections (rules, comparison tables, detection levels, checklist), this content would benefit significantly from being split — e.g., the extensive comparison tables could be in a separate EXAMPLES.md, and the detection levels could be in a DETECTION.md. The 'Compatibility with PUA' section references an external skill but doesn't link to it.

2 / 5

Total

12

/

20

Passed

Description

53%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 identifies a clear and distinctive purpose — preventing AI coding agents from over-engineering — but falls short on explaining what concrete actions the skill performs when triggered. The trigger conditions are partially specified but lack natural user language and synonyms. Adding explicit 'what it does' actions and a formal 'Use when...' clause would significantly improve selection accuracy.

Suggestions

Add concrete actions the skill performs, e.g., 'Flags unnecessary abstractions, warns about unrequested file changes, and suggests reverting scope creep'.

Include a 'Use when...' clause with natural trigger terms like 'too complex', 'unnecessary refactoring', 'keep it simple', 'YAGNI', 'scope creep', or 'don't add extra files'.

Clarify the mechanism — does it warn, block, revert, or prompt the user? This helps distinguish it from general code review skills.

DimensionReasoningScore

Specificity

Names the domain (anti-over-engineering guardrail) and describes a few concrete triggers (expands scope, adds abstractions, changes files not requested), but doesn't describe what concrete actions the skill takes when activated.

3 / 5

Completeness

The 'when' is reasonably clear (activates when agent expands scope, adds abstractions, or changes unrequested files), but the 'what' is vague — it says it's a 'guardrail' but doesn't explain what it actually does (e.g., warns the user, blocks changes, reverts modifications). There's no explicit 'Use when...' clause.

3 / 5

Trigger Term Quality

Includes some relevant terms like 'over-engineering', 'abstractions', 'scope', and 'files the user did not request', but misses natural user phrases like 'too complex', 'unnecessary changes', 'keep it simple', 'YAGNI', or 'don't refactor'.

3 / 5

Distinctiveness Conflict Risk

The concept of an anti-over-engineering guardrail is fairly distinctive and unlikely to conflict with most other skills. Minor overlap risk with general code review or scope management skills, but the specific focus on preventing AI agent over-engineering is a clear niche.

4 / 5

Total

13

/

20

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-Skills
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.