CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-review-response

Use when a reviewer, CI bot, or another AI leaves feedback to address

50

Quality

55%

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 ./skills/skill-review-response/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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 well-structured behavioral skill: a clear sequenced response pattern with verification checkpoints, a decision checklist, feedback loops, and concrete pushback templates make it highly actionable and workflow-clear. Weaknesses are moderate verbosity in the provider-stereotyping section and dangling references to files (codex-host-adapter.md, skill-verification-gate) that are not present in the bundle.

Suggestions

Trim the 'Multi-Provider Review Context' section — provider-behavior stereotypes are speculative padding; keep only the actionable rule ('the codebase's existing patterns win; if two providers flag the same issue, it's probably real').

Fix or remove the dangling references: 'skills/blocks/codex-host-adapter.md' and 'skill-verification-gate' do not exist in the bundle — either ship them or replace with self-contained guidance.

Make the 'Run verification' step executable by describing what verification means here (e.g., run the relevant tests or command) instead of pointing to an undefined gate.

DimensionReasoningScore

Conciseness

The core guidance (verify before agreeing, the READ-to-IMPLEMENT pattern, forbidden phrases, pushback template) is tight and skill-specific, but the 'Multi-Provider Review Context' section stereotypes provider behaviors ('tends toward enterprise patterns, may over-engineer') and the host-adapter blockquote adds padding Claude does not need. Matches 'mostly efficient but includes some unnecessary explanation or could be tightened'; not 4 because these sections are noticeably speculative rather than minor trims.

3 / 5

Actionability

Concrete, executable instruction guidance: a numbered 6-step response pattern, a decision table with explicit If YES/If NO branches, a worked pushback example with evidence format, and a forbidden-phrase list. Not 5 because steps like 'Run verification (skill-verification-gate)' reference a gate without showing how to execute it, leaving a minor gap.

4 / 5

Workflow Clarity

The response workflow is clearly sequenced (READ → RESTATE → VERIFY → EVALUATE → RESPOND → IMPLEMENT) with explicit validation checkpoints ('Run verification — prove the fix works'), an evaluation checklist table, a feedback-loop section with error recovery guidance ('each round should have FEWER issues', 'stop and re-read if the issue recurs'), and precedence rules for conflicts. This matches the anchor for clear sequence, validation steps, feedback loops, and checklists.

5 / 5

Progressive Disclosure

Sections are well-organized, but the body references 'skills/blocks/codex-host-adapter.md' and 'skill-verification-gate' which do not exist in any bundle — dangling references that are not clearly signaled. The file is also over 50 lines, so the simple-skill exception does not apply; matches 'some structure but could be better organized; references present but not clearly signaled'.

3 / 5

Total

15

/

20

Passed

Description

40%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 a clear, distinct 'Use when...' trigger but entirely omits the 'what' — it never states what the skill does (e.g., verify feedback against the codebase, respond with technical evaluation or reasoned pushback). It also lacks common trigger variations users would naturally say. It matches the completeness anchor for 'only when present without what'.

Suggestions

Add a what-clause before the when-clause, e.g., 'Evaluates code review feedback against the actual codebase before implementing — verifies the issue is real, responds with technical acknowledgment or evidence-based pushback. Use when a reviewer, CI bot, or another AI leaves code review comments to address.'

Include natural trigger synonyms such as 'code review comments', 'address review feedback', and 'PR review' to improve trigger term coverage.

State 2-3 concrete actions (verify, push back with evidence, implement one item at a time) to raise specificity beyond the generic 'to address'.

DimensionReasoningScore

Specificity

The description names the domain ('reviewer, CI bot, or another AI leaves feedback') but the only action is the generic 'to address' — no concrete capabilities like verify, evaluate, or push back are listed. Not 3 because it names no concrete actions at all; not 1 because the domain is clearly identified.

2 / 5

Completeness

Only the 'when' is present ('Use when a reviewer, CI bot, or another AI leaves feedback'); the 'what' — what the skill actually does — is at best weakly implied by 'to address'. Matches anchor 2 ('only when is present without what'); not 3 because no clear 'what' is stated.

2 / 5

Trigger Term Quality

'reviewer', 'CI bot', and 'feedback' are natural terms a user would say, but common variations are missing — 'code review comments', 'address review feedback', 'PR review', or 'incorporate feedback'. Matches 'Some relevant keywords but missing common variations or synonyms'; not 4 because several natural phrases users would actually use are absent.

3 / 5

Distinctiveness Conflict Risk

The trigger (feedback left by a reviewer, CI bot, or AI) is a distinct niche with clear trigger phrases, but 'another AI leaves feedback' leaves minor overlap risk with a generic feedback-handling skill. Not 5 because it could still fire for general AI-feedback situations beyond code review response.

4 / 5

Total

11

/

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
nyldn/claude-octopus
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.