CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

reproduce-bug

This skill should be used when reproducing and investigating a bug using logs, console inspection, and browser screenshots.

60

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/03-plan/reproduce-bug/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 content is a well-structured, actionable playbook: concrete MCP browser commands, explicit server verification, console-error checks, and a documentation checklist. Its weaknesses are minor — some loose filler in Phase 1, an orphaned test-writing instruction that never reappears in the phases, and subagent invocation syntax that is not literally executable.

DimensionReasoningScore

Conciseness

The body is efficient with no explanations of concepts Claude already knows — direct commands and MCP tool calls dominate. Minor trimmable filler exists ("Think about the places it could go wrong looking at the codebase" and the redundant re-run instructions in Phase 1), matching the 'efficient; minor instances of over-explanation' anchor rather than the lean level-5 example.

4 / 5

Actionability

Guidance is mostly executable with concrete, near copy-paste MCP calls (e.g. `mcp__plugin_compound-engineering_pw__browser_navigate({ url: "http://localhost:3000" })` and screenshot filenames with error-level console filtering). It stops short of fully executable because `Task rails-console-explorer(issue_description)` is pseudo-syntax rather than a real invocation, and `[affected_route]`/`[issue]` placeholders require per-issue filling.

4 / 5

Workflow Clarity

A clear Phase 1-4 sequence is present with several explicit checkpoints: verify the server is running before proceeding, check console errors during the flow, capture the bug state when reproduced, and a Phase 3 documentation checklist. It falls short of 5 because the opening instruction to "start by writing a test that reproduces the bug" is never integrated into any phase, and Phase 1's iterative loop ("Keep running these agents until you have a good idea") lacks a defined stopping condition.

4 / 5

Progressive Disclosure

The skill is a single self-contained file (~95 lines) with no bundle files, well-organized under phase and step headers with code blocks, and nothing that clearly belongs in a separate file. Because it exceeds the under-50-lines threshold where well-organized sections alone justify a 5, it fits level 4 ('good structure; most content appropriately placed') with only minor organization gaps.

4 / 5

Total

16

/

20

Passed

Description

66%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 communicates a usable trigger and a moderately specific capability set built around bug reproduction with logs, console inspection, and browser screenshots. Its main weaknesses are the merged what/when phrasing, missing common trigger synonyms (debug, error, stack trace), and lack of the GitHub-issue context that would distinguish it from generic debugging skills.

Suggestions

Split the description into a what clause and a when clause with concrete triggers, e.g. "Reproduce and investigate reported bugs via logs, console errors, and browser screenshots, then document findings with a reproduction test. Use when triaging or debugging a reported bug, error, or stack trace."

Add natural trigger synonyms such as "debug", "debugging", "error", "stack trace", and "bug report" so users phrasing the need differently still match.

Mention the GitHub issue workflow (e.g. "given a GitHub issue number") to sharpen the niche and reduce conflict risk with general debugging skills.

DimensionReasoningScore

Specificity

The description explicitly names only two actions ("reproducing and investigating a bug") plus three methods ("logs, console inspection, and browser screenshots"), matching the anchor for naming the domain with 1-2 concrete actions; the skill's other capabilities (test writing, GitHub issue reporting) are absent, so it falls short of the 'several specific actions, minor gaps' anchor at 4.

3 / 5

Completeness

Both parts are present since "This skill should be used when reproducing and investigating a bug" provides an explicit 'Use when...' equivalent trigger, and the same clause conveys the 'what'; however 'what' and 'when' are merged into a single sentence with no concrete trigger-phrase expansion, matching the level-4 anchor ('when' could be more explicit) rather than the crisp two-part level-5 structure.

4 / 5

Trigger Term Quality

Natural trigger terms are present — "reproducing", "investigating", "bug", "logs", "console", "screenshots" — giving good keyword coverage comparable to the level-4 example, but common variations a user would say like "debug", "error", or "stack trace" are missing, so it does not reach comprehensive coverage at 5.

4 / 5

Distinctiveness Conflict Risk

"Investigating a bug" is broad and overlaps with generic debugging/triage skills; the tool mentions (logs, console inspection, screenshots) add some specificity but the description omits the GitHub-issue-driven workflow that would establish a clear niche, placing it at 'somewhat specific but could still overlap with similar skills' rather than 'mostly distinct'.

3 / 5

Total

14

/

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

marchatton/agent-skills

Path

.agents/skills/03-plan/reproduce-bug/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.