CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fix-failed-paperclip-run

Diagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks.

Quality

88%

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

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.

A high-quality process skill body: clear phase sequencing with unusually strong validation checkpoints and feedback loops, concrete incident-specific guidance, and a well-signaled one-level reference for failure patterns. The main gaps are recurring restatements of the same completion-discipline theme and a couple of fragile out-of-bundle reference paths.

Suggestions

Consolidate the repeated 'do not stop at intermediate results / success badges are not resolution' guidance (currently spread across the intro, sections 2, 5, and 6) into one statement near the top to trim tokens without losing the discipline.

Move the changed-boundary/safety-evidence table in section 4, or the detailed verification criteria in section 5, into a references file beside failure-patterns.md to reduce the main body's size and keep SKILL.md as an operational overview.

Replace the fragile relative path ../../../skills/paperclip/references/run-diagnostics.md with a stable skill-qualified reference (e.g., the paperclip skill's name and its reference path), so the link resolves regardless of where this skill is installed.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence — it never explains basic concepts (regressions, PRs, CI) and packs prescriptive detail per line. It sits at the 4 anchor rather than 5 because the 'do not stop at intermediate results / success badges are not resolution' theme recurs across sections 1, 2, 5, and 6 and could be consolidated, and a few elaborately hedged sentences could be tightened.

4 / 5

Actionability

Concrete, executable instruction for an instruction-only skill: "Run it against the unfixed code and capture the expected failure", "inspect required checks and review on the current head SHA", a changed-boundary/safety-evidence table, and named artifacts (`doc/execution-semantics.md`, `verify-paperclip`, `prepare-paperclip-pr`, `prcheckloop`). It is not the 5 anchor because nearly all guidance is prescriptive direction with few literal commands or copy-paste artifacts, and some steps ('use authorized diagnostic access') necessarily defer to environment specifics.

4 / 5

Workflow Clarity

Six clearly sequenced phases (establish incident → first causal failure → prove the bug → repair → verify real workflow → deliver PR) with explicit validation checkpoints throughout: red before the fix and green after, safety regressions turned into observable cases, re-running acceptance after changes that invalidate evidence, and distinguishing pending/skipped/passing checks. Feedback loops ('address review and CI failures', 'Investigate unexpected failures instead of weakening an assertion') and a final report checklist match the top anchor.

5 / 5

Progressive Disclosure

Good structure: the failure-pattern catalog is appropriately offloaded to a clearly signaled one-level reference ([failure patterns](references/failure-patterns.md), verified to exist and self-describing as selectively readable), and the body is well-sectioned. It falls short of the 5 anchor because the run-diagnostics reference points outside the bundle via a fragile three-level relative path (../../../skills/paperclip/references/run-diagnostics.md), and only one bundled reference serves a ~210-line body whose safety-evidence and verification detail might partially live in references.

4 / 5

Total

17

/

20

Passed

Description

92%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.

A strong description: concrete, third-person, and specific about both capability and trigger conditions, with the domain term providing clear distinctiveness. The only room for improvement is broader trigger synonym coverage (error, crash, hung, timeout) for users who describe failures in other words.

DimensionReasoningScore

Specificity

Names the domain ("failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs") and lists five concrete actions: "trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks". Coverage spans diagnosis through delivery with no obvious gap, matching the comprehensive anchor rather than the several-actions-with-minor-gaps anchor.

5 / 5

Completeness

Explicitly answers both questions: what ("Diagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs") and when ("Use with a task/run URL or failure report"), with the when clause carrying concrete trigger artifacts. The trigger is explicit and specific, so it is not the 4 anchor where the when 'could be more explicit'.

5 / 5

Trigger Term Quality

Good natural-term coverage — "failed", "stuck", "slow", "blocked", "failure report", "root cause", "task/run URL" — giving multiple synonyms a user would say. It falls short of the comprehensive anchor because common variations like "error", "crash", "hung", or "timeout" are absent, while it clearly exceeds the missing-synonyms anchor at 3.

4 / 5

Distinctiveness Conflict Risk

"Paperclip tasks and runs" carves out a clear niche with distinct triggers, and the failure-mode qualifiers (failed/stuck/slow/incorrectly blocked) further narrow it. Although generic terms like "root cause" and "PR" appear, the domain name minimizes conflict risk with other skills.

5 / 5

Total

19

/

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

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository

paperclipai/paperclip

Path

.agents/skills/fix-failed-paperclip-run/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.