CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

2-repro-issue

Reproduce #N, investigate #N, try #N locally, or verify the bug in #N.

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/2-repro-issue/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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 dense, highly operational workflow with executable commands, validation checkpoints at every step, and explicit error-recovery and stop rules — workflow clarity is exemplary. Its only weaknesses are minor: a never-instantiated tool/arguments template and the inlined MCP handshake boilerplate that could be trimmed or extracted. Overall a strong skill body.

DimensionReasoningScore

Conciseness

The body is terse and imperative throughout ("Map the tool to code", "Packet and source first") with no explanations of concepts Claude already knows, and the domain caveats ("Target content language is not the authenticated account's UI language") are non-obvious and earn their place. It is not 5 because a few guardrails are repeated ("Do not invent a LinkedIn result", "do not invent one to complete the live check", "Do not create fake success or failure files") and the ~40 lines of generic MCP HTTP handshake boilerplate could be tightened or extracted; it is clearly above 3, which expects noticeable padding.

4 / 5

Actionability

Nearly everything is copy-paste ready: the argument parser ("NUM=$(echo \"$ARGUMENTS\" | sed -E ...")"), "gh issue view $NUM --repo $REPO --comments", the port-picking and 30s startup-wait loop with failure tails, the curl initialize/initialized/tools/call sequence with session-id extraction, the jq meta-file capture, and the cleanup block. It is not 5 because the tool-call template ("TOOL=\"<TOOL>\"", "ARGS_JSON='{<ARGS>}'") is never instantiated with a worked example, leaving a minor gap in covering the common case.

4 / 5

Workflow Clarity

The four-step sequence (Read the issue → Packet and source → Optional live check → Report) is explicit with validation at every stage: input validation with exit 1, "This step is complete when the report names the issue, the code SHA...", "If the workspace is dirty, ask before continuing", server-death and never-bound checks with log tails, session-id and protocol-error checks, and a fixed report template with a "Next" decision field. Error recovery and stop rules ("A protocol or validation error is an execution limit. Do not retry around it.") give it the feedback loops and checklist structure of anchor 5.

5 / 5

Progressive Disclosure

No bundle files exist and the body is well-sectioned (## 1–4 plus "## Non-negotiables") so navigation is easy and nothing is buried. It does not reach 5: the skill exceeds the ~50-line simple-skill threshold and inlines content that could live one level deep, notably the generic MCP HTTP handshake boilerplate (initialize, session-id, notifications/initialized curl blocks) that is invariant across runs; it is well above 3, which expects inline content that clearly belongs elsewhere with weak signaling.

4 / 5

Total

17

/

20

Passed

Description

62%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 lists several concrete, naturally-phrased actions but omits any 'Use when...' trigger clause and never names the project or the word 'issue', relying entirely on the '#N' placeholder. This caps completeness and leaves real overlap risk with the sibling /3-verify-pr-fix skill. A small rewrite naming the repo and adding explicit trigger guidance would lift it substantially.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user reports a bug or issue in stickerdaniel/linkedin-mcp-server and asks to reproduce, investigate, or verify it."

Replace the bare "#N" placeholder phrasing with natural trigger terms such as "issue", "bug report", or "repro" so the description reads the way a user would ask for it.

Disambiguate from the sibling skill in the description itself, e.g. "verify a reported issue in source before any fix exists — not for checking out a PR fix," so "verify" requests route to the correct skill.

DimensionReasoningScore

Specificity

"Reproduce #N", "investigate #N", "try #N locally", and "verify the bug in #N" list several concrete, distinct actions. It falls short of 5 because the target of those actions is only the cryptic placeholder "#N" — the domain (GitHub issues in a specific repo) is never named, leaving a coverage gap; it is above 3, which expects only 1-2 concrete actions.

4 / 5

Completeness

The "what" is present ("Reproduce #N, investigate #N, try #N locally, or verify the bug in #N") but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps this dimension at 3 per the rubric guidelines. This matches anchor 3 (clear what, when missing) exactly — not 4, which requires both what and when.

3 / 5

Trigger Term Quality

"Reproduce", "investigate", "try ... locally", "verify the bug" are phrases a user would naturally say for this task. It sits below 5 because common synonyms and variations are missing — the words "issue", "bug report", "repro", or "triage" never appear, and "#N" is a placeholder convention rather than a natural term; it is above 3, which expects only minimal relevant keywords.

4 / 5

Distinctiveness Conflict Risk

"verify the bug in #N" overlaps with the sibling skill /3-verify-pr-fix (verifying a fix), and "Reproduce #N" is generic enough to fire for any repository's issues since no project is named. This is somewhat specific but could still overlap with a closely related skill, matching anchor 3; it is not 4 because the overlap risk with the sibling skill is unmitigated by any disambiguation in the description itself.

3 / 5

Total

14

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

stickerdaniel/linkedin-mcp-server

Path

.agents/skills/2-repro-issue/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.