CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-coder

Agent skill for coder - invoke with $agent-coder

56

1.12x
Quality

39%

Does it follow best practices?

Impact

79%

1.12x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/agent-coder/SKILL.md

The canonical home for this skill is agent-coder in ruvnet/claude-flow

SKILL.md
Quality
Evals
Security

Quality

Content

50%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 a thorough but generic coding-best-practices document with solid executable TypeScript examples and MCP integration snippets. Its weaknesses are verbosity from restating well-known principles, an implementation workflow without explicit validation checkpoints, and a monolithic single-file structure with no progressive disclosure.

Suggestions

Trim the SOLID/DRY/KISS/YAGNI and generic best-practice prose that Claude already knows; keep only skill-specific guidance.

Add an explicit validation loop to the implementation workflow, e.g. 'Run tests/lint; if they fail, fix and re-run before handing off'.

Move the detailed MCP tool-integration blocks and extended code-style examples into separate reference files linked from the body.

DimensionReasoningScore

Conciseness

The ~265-line body extensively explains concepts Claude already knows (SOLID, DRY, KISS, YAGNI, dependency injection, memoization, generic error-handling patterns), fitting 'Noticeably verbose; several unnecessary explanations or padded sections'; it is not a 3 because the generic best-practice padding is substantial, and not a 1 because it is not a single rambling primer.

2 / 5

Actionability

Concrete TypeScript snippets (error handling, memoization, TDD example, ServiceError class, processItems) and MCP tool-call blocks provide mostly executable guidance, matching 'Mostly executable guidance; concrete code or commands with minor gaps'; it is not a 5 because some examples carry '// Implementation' placeholders and are illustrative rather than copy-paste task code, and not a 3 because most snippets are real and runnable.

4 / 5

Workflow Clarity

An 'Implementation Process' gives a rough sequence (Understand Requirements -> Design First -> TDD -> Incremental Implementation) but has no explicit validation checkpoints or fix-and-retry loops, matching 'Steps listed but validation gaps; sequence present but checkpoints missing or implicit'; not a 4 because no checkpoints are stated, not a 2 because a coherent sequence exists.

3 / 5

Progressive Disclosure

All content is inlined in one ~265-line file with no bundle files or external references, and bulk material (MCP integration details, extended code-style guidance) that could live in separate files is inline, matching 'Some structure but could be better organized; references present but not clearly signaled; content that should be separate is inline'; not a 4 because nothing is split out, not a 2 because section headers provide reasonable structure.

3 / 5

Total

12

/

20

Passed

Description

28%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 minimal and meta: it identifies the skill as a 'coder' agent and gives an invocation hint, but states no concrete capabilities or usage triggers. It reads as a routing label rather than a description that would help Claude decide when to invoke it.

Suggestions

Replace the invocation hint with concrete actions, e.g. 'Writes, refactors, and optimizes code; designs APIs and implements error handling'.

Add an explicit 'Use when...' trigger clause such as 'Use when the user asks to implement a feature, refactor code, or fix a bug'.

Drop the 'invoke with $agent-coder' meta-instruction from the description; it is not a trigger term a user would say.

DimensionReasoningScore

Specificity

The description 'Agent skill for coder - invoke with $agent-coder' names the domain (coder) but lists no concrete actions, matching the anchor 'Names the domain but actions are minimal or generic'; it is not a 1 because a domain is named, and not a 3 because no specific capabilities are stated.

2 / 5

Completeness

It offers only a vague 'what' ('Agent skill for coder') with no 'when' / 'Use when...' clause, matching 'Has a vague what and no when'; the missing trigger guidance caps it below 3, and it is not a 1 because a (vague) what is present.

2 / 5

Trigger Term Quality

'coder' is a single generic keyword and 'invoke with $agent-coder' is invocation syntax rather than a phrase a user would naturally say, fitting 'One or two generic keywords; missing the natural phrases users say'; it is not a 1 because 'coder' is at least domain-relevant, and not a 3 because no natural synonyms or variations appear.

2 / 5

Distinctiveness Conflict Risk

'coder' is somewhat specific to a coding niche but the description is broad enough to overlap with other code-generation or development skills, matching 'Somewhat specific but could still overlap with similar skills'; not a 4 because no distinct triggers narrow it, not a 2 because it is not as generic as 'helps with files'.

3 / 5

Total

9

/

20

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
ruvnet/ruflo
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.