CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

create-issue-interaction-ui

Add a new Paperclip issue-thread interaction kind end-to-end. Use when repo work introduces or extends interaction cards like request_confirmation, checkbox confirmations, ask_user_questions, or suggest_tasks.

69

Quality

87%

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

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

An exceptionally actionable, repo-grounded skill: it sequences a five-layer rollout with explicit validation commands, an error-recovery tip, a pre-merge checklist, and hard invariants distilled from a real PR review. Its only flaws are minor repetition of the production-install warning and a monolithic single-file structure where per-layer detail could be offloaded to reference files.

DimensionReasoningScore

Conciseness

Nearly every token is repo-specific (exact file paths, litigated invariants, mirrored constants, canonical PR reference), so it is well above anchor 3's unnecessary-explanation profile. However, the 'Do NOT install this on production Paperclip agents' warning is stated three times (lines 11, 19, and the intro paragraph) and a few framing sentences re-explain the audience, which is minor over-explanation that could be trimmed — precisely anchor 4.

4 / 5

Actionability

The guidance is fully executable: exact file paths with line-anchored locations ('the response-shape branch around line 6096'), a copy-paste-ready git command ('git show --stat 4d5322c82'), a complete vitest invocation, a concrete constant to mirror ('REQUEST_CHECKBOX_CONFIRMATION_OPTION_LIMIT = 200'), and a canonical worked diff to copy plumbing from. This matches anchor 5's copy-paste-ready, common-case coverage.

5 / 5

Workflow Clarity

The five-step order of operations is clearly sequenced with rationale ('Do the shared contract first. It is the smallest correct change...'), an explicit validation step with the exact test set to run, an error-recovery loop ('If UI vitest fails with "act is not a function"... Re-run with NODE_ENV=test'), and a pre-merge checklist. This matches anchor 5 exactly: sequence, explicit validation, feedback loop, and checklist.

5 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), so all content lives in a single ~276-line SKILL.md. Section headers ('When to use', 'Mental model', ordered layer sections, 'Tests to run', 'Pre-merge checklist') make it well-navigable — good structure per anchor 4 — but the per-layer file-by-file touch lists could be split into one-level-deep reference files, and at over 50 lines it does not qualify for the simple-skill exception that would let it score 5 without references.

4 / 5

Total

18

/

20

Passed

Description

82%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: it explicitly answers both what and when, uses concrete domain trigger terms a maintainer would actually say, and occupies a clearly distinct niche. The only weakness is that the 'what' compresses the work into a single end-to-end action without naming the constituent steps (contract, server, UI, helpers, docs).

Suggestions

List one or two of the concrete sub-actions the end-to-end work covers, e.g. 'Add a new issue-thread interaction kind end-to-end: shared contract, server routes, UI card, and CLI/MCP helpers.'

Include a natural-phrase variation users might say, such as 'issue-thread interaction' or 'interaction card', to broaden trigger coverage beyond the four kind identifiers.

DimensionReasoningScore

Specificity

The description names the domain ("Paperclip issue-thread interaction kind") and one concrete action ("Add ... end-to-end"), with four named existing kinds as examples, but it lists only a single action rather than the several specific actions anchor 4 requires. The named kinds are example targets, not distinct capabilities, so it sits clearly above anchor 2's generic domain-naming and below anchor 4.

3 / 5

Completeness

"Add a new Paperclip issue-thread interaction kind end-to-end" explicitly answers what, and "Use when repo work introduces or extends interaction cards like..." explicitly answers when with concrete trigger phrases. This matches anchor 5 exactly; anchor 4 would require the 'when' clause to be less explicit or specific.

5 / 5

Trigger Term Quality

Terms like "interaction cards", "request_confirmation", "checkbox confirmations", "ask_user_questions", and "suggest_tasks" are exactly what a maintainer would say when needing this skill, giving good keyword coverage. It misses a few natural variations (e.g., "issue-thread interaction", "approval card"), keeping it below anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The niche (Paperclip issue-thread interaction kinds, with four named kinds) is highly specific with distinct triggers, so overlap with other skills is minimal. It clearly matches anchor 5's clear-niche profile and not anchor 4's minor-overlap profile.

5 / 5

Total

17

/

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

relative_links

Relative link issues: 1 suspicious

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

14

/

16

Passed

Repository

paperclipai/paperclip

Path

.agents/skills/create-issue-interaction-ui/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.