intro-drafter

Drafts the Introduction prose for a technical paper, guided internally by a six-paragraph flowchart: background and running example, existing limitations, problem essence and goal, key challenges, solution overview, contributions. Positions the paper as Technique or New Problem/Setting, aligns contributions with challenges, and weaves verified citations. Outputs flowing prose by default, or an outline on request. Use when the user asks to draft, outline, or restructure an Introduction.

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

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.

A well-structured, actionable instruction skill with a clear validated workflow and clean progressive disclosure into real reference files. Minor conciseness tightening is the only leverage point.

Dimension	Reasoning	Score
Conciseness	The body is dense with task-specific discipline (six-paragraph purposes, word counts, citation ranges, tense/tone rules) and avoids explaining concepts Claude already knows, though a few procedural sections could be tightened slightly.	4 / 5
Actionability	Concrete executable guidance throughout — paragraph purposes, '100-250 words', '15-25 references' with per-paragraph distribution, numeric '[1] [2]' citation format, explicit alignment checks — fully actionable for an instruction-only prose skill.	5 / 5
Workflow Clarity	A clear six-step sequence (Steps 1-6) with an explicit validation checkpoint in Step 4 ('A failed check is fixed in the plan before any prose is written') plus a tone pass and a citation-verification ladder as feedback loops.	5 / 5
Progressive Disclosure	Well-signaled one-level-deep references (e.g. 'See: references/flowchart.md', 'references/paper-types.md'), all verified to exist, with the body acting as an overview and detailed material split appropriately across seven reference files.	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 specific, complete, third-person description with explicit trigger guidance and a clear niche. The only minor gap is slightly narrow trigger-term coverage, missing a few common synonyms.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'Drafts the Introduction prose', 'guided internally by a six-paragraph flowchart', 'Positions the paper as Technique or New Problem/Setting', 'aligns contributions with challenges', 'weaves verified citations', 'Outputs flowing prose by default, or an outline on request' — giving comprehensive coverage of capabilities.	5 / 5
Completeness	Explicitly answers both what (drafts Introduction prose via a six-paragraph scaffold, positions paper type, weaves citations) and when ('Use when the user asks to draft, outline, or restructure an Introduction') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Includes natural trigger phrases ('Use when the user asks to draft, outline, or restructure an Introduction') that users would say, but misses common synonyms like 'Intro' or 'write the Introduction', leaving a few natural terms uncovered.	4 / 5
Distinctiveness Conflict Risk	Occupies a clear niche — Introduction drafting for technical/STEM papers — with triggers distinct from sibling skills like paper-writer or paper-polish, minimizing wrong-skill conflict risk.	5 / 5
	Total	19 / 20 Passed

Validation

100%

Warnings & errors only

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: HKUSTDial/Supervisor-Skills
Path: skills/intro-drafter/SKILL.md
Commit: 207bc6f

Reviewed: 9 days ago

Table of Contents

Discovery Implementation Validation

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.