CtrlK
BlogDocsLog inGet started
Tessl Logo

grug-brained-dev

Use when reviewing PRs, simplifying over-engineered code, judging architecture, or renaming unclear concepts — inline fake helpers, delete meatless ceremony, rename lying names, merge over-split files, reject premature abstraction, say no to speculative config/modes/layers, then end with the smallest safe next change. Triggers when code is too fancy, too abstract, too clever, too many files/helpers/layers, or too well-factored but painful to change. Embody Grug brain: complexity very bad, small words, no consultant speak, no hard pivot to opposite dogma.

72

1.65x
Quality

63%

Does it follow best practices?

Impact

81%

1.65x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./grug-brained-dev/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

27%

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

The skill has a strong creative voice and genuinely useful review heuristics — the question checklists, output template, and 'no hard pivot' guidance are valuable. However, it is severely over-long for a skill file, spending hundreds of tokens on philosophical framing and general software engineering advice that Claude already knows. The content would benefit enormously from being condensed to its core actionable elements (voice rules, question checklist, output format, bonk planning) with detailed sections moved to separate reference files.

Suggestions

Cut the content by 60-70%: remove sections that restate general software engineering wisdom (APIs, Tests, Tools/logs/types, Demon doors, Expressions) and keep only the Grug-specific heuristics and review process.

Split into SKILL.md (voice rules, core questions, output format, ~50-80 lines) plus reference files like GRUG-ENEMIES.md and GRUG-EXAMPLES.md for the detailed catalogs.

Add concrete before/after code examples showing a real refactoring (e.g., a fake helper being inlined, a lying name being renamed) to make the guidance more executable.

Add explicit validation steps to the 'Plan as bonks' section — e.g., 'after each bonk, run tests, check no new cave created, verify meat still reachable.'

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~400+ lines. While the Grug voice is intentional, vast amounts of content explain concepts Claude already knows (what complexity is, what tests are, what APIs are, what refactoring is). The philosophical framing and extensive metaphors consume enormous token budget. Many sections (APIs, Tests, Tools/logs/types, Demon doors) rehash general software engineering wisdom in Grug voice without adding novel actionable content.

1 / 3

Actionability

The skill provides concrete output format templates and specific questions to ask during review, which is genuinely actionable. However, there are no executable code examples — the code blocks contain only illustrative text snippets. The 'What Grug hunts' section gives good checklists but many sections (Expressions, APIs, Tests, Fence) remain abstract advice rather than concrete instructions with specific commands or code patterns.

2 / 3

Workflow Clarity

The skill has a discernible workflow: adopt voice → ask questions → find meat → judge each thing → report using template → end with smallest bonk. The output format section provides clear structure. However, the workflow is scattered across many sections rather than presented as a clear sequence, and there are no explicit validation checkpoints for destructive operations like inlining helpers or merging files.

2 / 3

Progressive Disclosure

The entire skill is a monolithic wall of text with no references to external files and no clear separation of overview vs. detailed content. The extensive philosophical sections, enemy catalog, and detailed subsections (Expressions, APIs, Tests, Fence, Tools, Demon doors) could easily be split into referenced files. Everything is inline in one massive document with no navigation aids.

1 / 3

Total

6

/

12

Passed

Description

100%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a strong, well-crafted skill description that excels across all dimensions. It provides highly specific concrete actions, natural trigger terms that match how developers talk about over-engineered code, explicit 'Use when' and 'Triggers when' clauses, and a distinctive philosophical niche (Grug-brain simplicity) that clearly separates it from generic code review skills. The description is vivid and memorable without being verbose.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'inline fake helpers, delete meatless ceremony, rename lying names, merge over-split files, reject premature abstraction, say no to speculative config/modes/layers, then end with the smallest safe next change.' These are highly specific, actionable operations.

3 / 3

Completeness

Clearly answers both 'what' (inline fake helpers, delete ceremony, rename lying names, merge over-split files, reject premature abstraction, etc.) and 'when' with explicit triggers ('Use when reviewing PRs, simplifying over-engineered code... Triggers when code is too fancy, too abstract, too clever...'). Has both a 'Use when' and a 'Triggers when' clause.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would say: 'reviewing PRs', 'simplifying over-engineered code', 'architecture', 'renaming', 'too fancy', 'too abstract', 'too clever', 'too many files/helpers/layers', 'too well-factored but painful to change'. These match how developers naturally describe code quality concerns.

3 / 3

Distinctiveness Conflict Risk

Occupies a very clear niche — anti-complexity/anti-over-engineering code review with a distinctive 'Grug brain' philosophy. The specific triggers (too fancy, too abstract, premature abstraction, over-split files) are unlikely to conflict with general code review or refactoring skills, as this targets a specific opinionated simplification approach.

3 / 3

Total

12

/

12

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

skill_md_line_count

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

Warning

Total

10

/

11

Passed

Repository
joshuadavidthomas/agent-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.