CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

papercuts

Log genuine, recurring repository friction to .agents/PAPERCUTS.md — confusing setup, a flaky repo command or script, a misleading in-repo error, stale generated files, or a non-obvious gotcha that will cost the next contributor time. Also use to review, deduplicate, and resolve existing entries. Gate hard before logging: only friction the repository itself can fix counts. Never log the agent's own sandbox/permission errors, shell-scripting mistakes, transient flakiness, or third-party tool quirks the repo can't change.

Quality

89%

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

SKILL.md
Quality
Evals
Security

Quality

Content

92%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 tightly written, actionable instruction skill: concrete entry formats, explicit gating logic, and two clearly sequenced workflows with built-in validation and dedup checkpoints. Its only trimmable redundancy is the thrice-stated repo-vs-environment gate.

Suggestions

Consolidate the repo-vs-environment gate to a single statement (the two-question test) and drop the restated closing line in 'Do NOT log' to save a few tokens.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence with no padding or explanation of known concepts, but the repo-vs-environment gate is restated three times (the intro bar, the two-question test, and the closing 'is this the repo, or is this me/my environment?' line). That minor repetition matches anchor 4 ('minor instances that could be trimmed') rather than anchor 5's 'every token earns its place.'

4 / 5

Actionability

Fully actionable for an instruction-only skill: a copy-paste-ready entry template with exact syntax and UTC timestamp/agent-label rules, exact file path (.agents/PAPERCUTS.md), named sections (## Open, ## Resolved), and concrete decision rules for logging, review, and cleanup. Specific guidance covers the common cases, matching anchor 5.

5 / 5

Workflow Clarity

Both workflows are numbered with explicit validation checkpoints: the two-question test gates every log entry, a dedup search precedes appending, and the review workflow re-runs the test, verifies reproduction, and distinguishes reproduced failures from unverifiable historical reports. This checklist-with-feedback-loop profile matches anchor 5.

5 / 5

Progressive Disclosure

A compact (~84 line) single-file skill with no bundle files; every section is short, clearly headed, and nothing warrants splitting to a reference file. Content is appropriately placed for the skill's size and organization makes navigation trivial, satisfying the well-organized single-file case.

5 / 5

Total

19

/

20

Passed

Description

83%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 highly specific, well-bounded description that clearly states what the skill does and draws sharp inclusion/exclusion boundaries. Its only weakness is the absence of an explicit 'Use when...' trigger phrase for the primary logging function, leaving the main trigger implied rather than concrete.

Suggestions

Add an explicit trigger clause for the primary function, e.g., 'Use when you hit recurring repo friction during a task or when the user mentions papercuts or asks to review the friction log.'

Include one or two additional natural synonyms such as 'annoyance' or 'rough edges' to broaden trigger coverage.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions ('Log genuine, recurring repository friction to .agents/PAPERCUTS.md', 'review, deduplicate, and resolve existing entries') and comprehensively catalogs both qualifying friction (confusing setup, flaky repo command, misleading error, stale generated files, non-obvious gotcha) and exclusions, leaving no real coverage gaps. Anchor 4 requires 'minor gaps in coverage,' which this exceeds.

5 / 5

Completeness

It answers 'what' explicitly (log/review/dedupe/resolve entries in a named file) and gives a 'when' for the secondary function ('Also use to review, deduplicate, and resolve existing entries'), but the primary logging trigger is only implied by gate language ('Gate hard before logging') rather than an explicit 'Use when...' trigger phrase. This matches anchor 4 ('both present; when could be more explicit or specific') rather than anchor 3, since some explicit when-guidance exists.

4 / 5

Trigger Term Quality

Good natural keyword coverage: 'friction', 'flaky', 'stale files', 'gotcha', 'deduplicate', 'resolve' are phrases a user would plausibly say. A few natural terms are missing (e.g., 'annoyance', 'papercut' itself, 'rough edges'), so it does not reach anchor 5's comprehensive synonym and extension coverage, but sits clearly above anchor 3's 'missing common variations.'

4 / 5

Distinctiveness Conflict Risk

A clearly demarcated niche — logging repository friction to one specific file with explicit inclusion criteria and exclusion boundaries ('Never log the agent's own sandbox/permission errors...'). Distinct triggers and minimal overlap risk with other skills, matching anchor 5.

5 / 5

Total

18

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

every-app/open-seo

Path

.agents/skills/papercuts/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.