CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

first-task

Guide the user's first Paperclip task when its description invokes /first-task. Interpret the opening answer, clarify their goal, propose a plan or a single task, and wait for approval before hiring agents or executing approved work.

Quality

94%

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

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.

Highly actionable content with concrete APIs, named operations, explicit validation checkpoints, and error-recovery loops organized into a clear ordered workflow. Its only weakness is minor redundancy in the proposal-mode rules that a light edit could tighten.

DimensionReasoningScore

Conciseness

The body is dense and instruction-only with no concept-padding, but there is minor redundancy in step 2 where the plan-form rules and the Single-task proposal mode rules restate overlapping requirements that could be trimmed, matching the efficient-with-minor-trimming anchor.

4 / 5

Actionability

Guidance is copy-paste ready: a concrete API call (POST /api/issues/{issueId}/interactions/{interactionId}/resolve-from-comment with a JSON body), named cards (request_human_input, request_checkbox_confirmation, request_confirmation), named tools (call_api, set_dependencies, paperclip_block, register_deliverable), and specific counts (3–4 interview questions, 2–3 clarification questions) covering the common cases.

5 / 5

Workflow Clarity

A clear 4-step sequence with explicit checkpoints (persist acceptance before hiring, check for an existing child before creating one, verify the child document and file before replying) and explicit feedback loops (retry an interrupted write with the same message and decision, inspect conflicting results, revise the proposal and wait again), matching the top anchor.

5 / 5

Progressive Disclosure

This is a single-file skill under 50 lines with no bundle files and no need for external references; the body is well-organized as a short intro plus four ordered steps, so the simple-skill guideline applies and the structure fully earns the top score.

5 / 5

Total

19

/

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: third-person, specific, and complete, with an explicit trigger tied to the /first-task invocation. The only gap is slightly thinner synonym coverage for trigger terms, which keeps it just short of full marks on one dimension.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions covering the workflow — "Interpret the opening answer, clarify their goal, propose a plan or a single task, and wait for approval before hiring agents or executing approved work" — which matches the comprehensive-coverage anchor rather than the minor-gaps anchor one level below.

5 / 5

Completeness

It explicitly answers both what (interpret, clarify, propose, wait for approval) and when ("when its description invokes /first-task") with a concrete trigger phrase, matching the top anchor rather than the weaker-'when' anchor at 4.

5 / 5

Trigger Term Quality

Natural phrases users would say are present ("first Paperclip task", "/first-task", "plan", "task"), but a few natural synonyms like "onboarding" or "getting started" are missing, matching the good-coverage anchor rather than the comprehensive-synonym anchor.

4 / 5

Distinctiveness Conflict Risk

The scope is tightly bounded to the first Paperclip task invoked via /first-task, giving it a clear niche with an explicit trigger and minimal risk of firing for unrelated skills.

5 / 5

Total

19

/

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

paperclipai/paperclip

Path

server/src/onboarding-assets/first-task/skills/first-task/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.