CtrlK
BlogDocsLog inGet started
Tessl Logo

agent-code-analyzer

Agent skill for code-analyzer - invoke with $agent-code-analyzer

49

2.05x
Quality

28%

Does it follow best practices?

Impact

80%

2.05x

Average score across 3 eval scenarios

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/agent-code-analyzer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

35%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 reads as an auto-generated agent manifest: a stray duplicate YAML header, generic capability and metric bullet lists, and placeholder swarm-orchestration commands that provide no real executable guidance for analyzing code. The phase structure is coherent, but there are no validation checkpoints and the bulk of the content restates knowledge Claude already has.

Suggestions

Delete the duplicate YAML frontmatter block at the top of the body and replace the generic capability/metric bullet lists with a short list of concrete analysis commands (e.g. actual linter, complexity, and security-scanner invocations) Claude can run.

Add validation checkpoints to the workflow (e.g. "confirm findings against the source line before reporting", "re-run the scanner after fixes") so the report phase is gated on verified results.

Move the example report, metrics catalog, and memory-key reference into a references/ file and link them from SKILL.md, keeping the main file to the workflow and core instructions.

DimensionReasoningScore

Conciseness

The body is ~210 lines of generic bullet lists ("Core Responsibilities", "Analysis Metrics", "Best Practices") that restate what Claude already knows about code review, plus a duplicated stray YAML frontmatter block that is pure padding. It matches anchor 2 (noticeably verbose, several padded sections) rather than anchor 3, because most sections add no information Claude does not already possess.

2 / 5

Actionability

The only "commands" are placeholder orchestration calls like `npx claude-flow@alpha hooks pre-search --query "code quality metrics"` with unresolved `${description}`/`${results}` variables, which instruct nothing about actual code analysis. Core directives are high-level hints ("Run linters and type checkers", "Identify performance bottlenecks") with no specific commands or thresholds, matching anchor 2 rather than anchor 3, whose concrete guidance is at least partly executable.

2 / 5

Workflow Clarity

A three-phase sequence (Initial Scan, Deep Analysis, Report Generation) is present and ordered, matching anchor 3 (steps listed, checkpoints missing). It is not anchor 4 because no validation or verification step exists — analysis results are stored and a notification fired with no check that findings are correct — and it is above anchor 2 because the phases and their sub-steps do form a coherent progression.

3 / 5

Progressive Disclosure

The document has reasonable section headers but is a single monolithic file with no reference files at all (no references/, scripts/, or assets/ exist), and content that would belong in separate files — the full capability manifest, metrics catalog, and example report — is inlined. This matches anchor 3 (some structure, could be better organized) rather than anchor 4, since nothing is split out or navigable via references.

3 / 5

Total

10

/

20

Passed

Description

21%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 effectively invocation metadata rather than a skill description: it states what command invokes the agent but not what the agent does or when to use it. It would rarely be selected by a user's natural request and is barely distinguishable from other code-quality skills.

Suggestions

Replace the description with concrete capabilities, e.g. "Performs code quality analysis: static analysis, complexity metrics, security vulnerability scanning, and dependency auditing. Use when reviewing code quality, hunting performance bottlenecks, or scanning for security vulnerabilities."

Add an explicit trigger clause ("Use when...") listing natural user phrases such as "analyze this code", "find security issues", or "check code quality".

Remove the "$agent-code-analyzer" invocation syntax from the description — it adds no user-facing trigger value and crowds out capability statements.

DimensionReasoningScore

Specificity

The description "Agent skill for code-analyzer - invoke with $agent-code-analyzer" names the domain (code analysis) but lists zero concrete actions — it is agent-invocation metadata, not a capability description. It sits above the entirely-vague anchor 1 only because it identifies the domain, but well below anchor 3 since no action verbs or capabilities appear.

2 / 5

Completeness

The "what" is only weakly implied (a code-analyzer agent) and the "when" is entirely absent, matching anchor 2 (vague 'what' and no 'when'). It is not anchor 3 because even a clear 'what' statement is missing, and the guideline caps completeness at 3 absent a 'Use when...' clause — this description does not even reach that baseline.

2 / 5

Trigger Term Quality

No natural trigger keywords appear; the only content is the technical jargon "invoke with $agent-code-analyzer", which no user would say when they need code analysis. This matches anchor 1 (only technical jargon or generic language) and is clearly below anchor 2, which at least expects one or two generic keywords like "code analysis".

1 / 5

Distinctiveness Conflict Risk

"code-analyzer" names a somewhat specific niche but the description gives no distinguishing triggers, so it would overlap with generic code-review, refactoring, and quality-analysis skills — matching anchor 3. It is above anchor 2 because the domain label does narrow the field somewhat, and below anchor 4 because nothing makes it distinguishable from closely related skills.

3 / 5

Total

8

/

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.

Validation — 16 / 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.