CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

kaizen

Use when Code implementation and refactoring, architecturing or designing systems, process and workflow improvements, error handling and validation. Provide tehniquest to avoid over-engineering and apply iterative improvements.

Quality

66%

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 ./antigravity/skills/kaizen/SKILL.md

The canonical home for this skill is kaizen in NeoLabHQ/context-engineering-kit

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 and rich with concrete Good/Bad code examples, but it is a monolithic ~730-line document that largely re-teaches standard software-engineering practices Claude already knows (YAGNI, fail-fast validation, guards, rule of three). Its real value — the kaizen four-pillar framing and the command integration — is diluted by redundancy and the absence of any progressive disclosure into reference files.

Suggestions

Trim or cut the explanations of practices Claude already knows (YAGNI, premature optimization, fail-fast config, early-return guards, Result types, rule of three) — keep only the pillar framing and how it changes behavior; this is the biggest conciseness win.

Split each pillar (Continuous Improvement, Poka-Yoke, Standardized Work, JIT) into a references/<pillar>.md file and keep SKILL.md as a lean overview with one-level-deep, clearly signaled references.

Reduce to one strongest Good/Bad example pair per pillar; three-example runs (e.g., the calculateTotal triple) repeat the same point at token cost.

DimensionReasoningScore

Conciseness

Across ~730 lines the body extensively restates programming knowledge Claude already has: YAGNI, premature optimization ("Profile first, optimize second"), fail-fast config validation, early-return guards, Result types, the rule of three, and premature abstraction — all standard best practices. The only genuinely novel content is the four-pillar framing and the command integration section. It is above 1 because the material is structured and concrete rather than pure filler, but several sections are unnecessary explanations of known concepts.

2 / 5

Actionability

Guidance is mostly executable: Good/Bad TypeScript examples are concrete and largely complete (discriminated unions for order status, branded PositiveNumber type validated at the boundary, guard-clause processUser, required-config loadConfig), and "In Practice" sections give specific step lists ("Start with simplest version that works... Test and verify"). Not a 5 because a few snippets are fragmentary ("return validItems.reduce(...)" in the Bad example) and some advice is abstract ("Return Result<T, E> instead of throwing").

4 / 5

Workflow Clarity

The "In Practice" sections provide clear sequences with explicit verification checkpoints ("Verify each change before next", "Test and verify", "Keep tests passing throughout", "Commit after each improvement"), and the iterative refinement loop (make it work → make it clear → make it efficient) is well sequenced. Not a 5 because the guidance is dispersed across four pillars rather than forming one coherent workflow with feedback loops.

4 / 5

Progressive Disclosure

Section structure is good — clear headers, consistent Principles / Good-Bad examples / In Practice subsections per pillar — making navigation easy. However, no bundle files exist (no references/, scripts/, or assets/ directories) and the entire ~730-line body is inlined in SKILL.md; each pillar's detailed examples clearly belong in separate reference files with SKILL.md as a lean overview.

3 / 5

Total

13

/

20

Passed

Description

62%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 has an explicit 'Use when' trigger clause and reasonably natural trigger terms, but the capability statement is vague, typo-ridden, and grammatically broken, and the trigger scope is so broad it would fire on nearly any coding task. It reads as a rough draft of a good description.

Suggestions

Fix the grammar and typos ("tehniquest" → "techniques", "architecturing" → "designing architecture", "Use when Code implementation" → "Use when doing code implementation") and state the what in third person with concrete verbs (e.g., "Applies kaizen principles: incremental improvement, error-proofing (poka-yoke), standardized work, and just-in-time build decisions").

Narrow the trigger scope to where the skill genuinely adds value (e.g., "Use when deciding how much to build, refactoring iteratively, or designing error-proof interfaces") to reduce conflict with code-review/simplification skills.

Add natural trigger synonyms users actually say, such as "code review", "simplify", "avoid over-engineering", and "YAGNI".

DimensionReasoningScore

Specificity

The description names several domains ("Code implementation and refactoring", "error handling and validation", "process and workflow improvements") but the actions stated are generic — "Provide tehniquest to avoid over-engineering and apply iterative improvements" names no concrete technique and contains typos ("tehniquest", "architecturing", "Use when Code implementation"). It is above a 2 because multiple domains and two semi-concrete actions are named, but below a 4 because no specific capabilities or practices are enumerated.

3 / 5

Completeness

Both parts exist: an explicit trigger clause ("Use when Code implementation and refactoring...") and a what-statement ("Provide tehniquest to avoid over-engineering and apply iterative improvements"). Not a 5 because the 'what' is vague and grammatically broken, so it does not clearly and explicitly state what the skill does.

4 / 5

Trigger Term Quality

Natural phrases users would say are present: "refactoring", "error handling and validation", "over-engineering", "designing systems", "workflow improvements". Not a 5 because common variations users actually say — "code review", "simplify", "clean code", "tech debt" — are missing.

4 / 5

Distinctiveness Conflict Risk

The triggers span essentially all software development work ("Code implementation and refactoring", "architecturing or designing systems", "process and workflow improvements", "error handling and validation"), giving high overlap risk with many existing skills (code review, simplification, refactoring). It is above 1 only because the kaizen/improvement framing gives it a slight identity.

2 / 5

Total

13

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (734 lines); consider splitting into references/ and linking

Warning

Total

15

/

16

Passed

Repository

NeoLabHQ/context-engineering-kit

Path

antigravity/skills/kaizen/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.