Agent skill

Drafting

by jwynia in jwynia/agent-skills

Break through blocks and execute first drafts. An agent skill from jwynia/agent-skills.

MITAuto-check passed

Install Drafting

skills CLI
$ npx skills add jwynia/agent-skills --skill drafting -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jwynia/agent-skills drafting --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jwynia/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/creative/fiction/craft/drafting .claude/skills/drafting && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
drafting
GitHub stars
165
Token cost
~3.7k tokens
SKILL.md length
2,056 words
Files
1
Skills in repo
113
Repo updated
First seen
Licence
MIT

At a glance

Break through blocks and execute first drafts. An agent skill from jwynia/agent-skills.

  • Works in 4 steps: Identify the State → Check for Internal Editor → Check the Method → …
  • The outline is done but the draft isnt happening
  • SKILL.md covers Core Principle, The Fundamental Split, The Drafting States and The Internal Editor Problem, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Drafting is an agent skill from jwynia/agent-skills. Break through blocks and execute first drafts. Use when the outline is done but the draft isn't happening, when writer's block strikes, when the blank page remains blank, or when progress stalls.

Its SKILL.md is about 3.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The licence is MIT.

When your agent uses it

  • The outline is done but the draft isnt happening
  • Writers block strikes
  • The blank page remains blank
  • Progress stalls

Example prompts

  • “t happening, when writer”
  • “/drafting”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Identify the State
  2. Check for Internal Editor
  3. Check the Method
  4. Recommend Interventions

What it can do on your machine

Read from SKILL.md and the folder at commit e02ec7e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Drafting loads about 3.7k tokens when it runs. Until then it costs about 51 tokens; SKILL.md has 2,056 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~51
When it runs · the whole SKILL.md, loaded when a task matches
~3.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jwynia/agent-skills at commit e02ec7e, republished under its MIT licence (© jwynia). 2,056 words, ~3,743 tokens.

Download SKILL.mdSave it as .claude/skills/drafting/SKILL.md (or your agent's skills folder).
name
drafting
description
Break through blocks and execute first drafts. Use when the outline is done but the draft isn't happening, when writer's block strikes, when the blank page remains blank, or when progress stalls.
license
MIT
metadata.author
jwynia
metadata.version
1.0
metadata.type
diagnostic
metadata.mode
assistive
metadata.domain
fiction

Drafting: Diagnostic Skill

You diagnose drafting blocks and guide writers through first draft execution. Your role is to identify why the draft isn't progressing and help writers get words on the page.

Core Principle

Drafting is discovery, not transcription.

The draft is not meant to be perfect. It's meant to exist. The goal is to produce material to revise—not to produce final prose. All first drafts are supposed to be imperfect.

"All first drafts are shit." — Attributed to Hemingway


The Fundamental Split

DraftingEditing
GenerativeEvaluative
Forward momentumBackward revision
Quantity focusQuality focus
Internal editor OFFInternal editor ON
Discovery modeRefinement mode

Critical rule: Do not edit while drafting. Move forward. Fix it later.


The Drafting States

State D1: Can't Start

Symptoms: Outline exists but draft doesn't. Blank page paralysis. Days pass without words written. Infinite "preparation" without execution.

Key Questions:

  • Is the outline too vague to write from?
  • Are expectations too high for a first draft?
  • Is there fear of the blank page?
  • Are you waiting to feel "ready"?

Common Causes:

  • Perfectionism (standards too high for first draft)
  • Anxiety (fear of judgment or failure)
  • Over-preparation (planning forever, never starting)
  • Vague outline (don't know what to write)

Interventions:

  • Write a zero draft scene with no expectations
  • Start with dialogue only (easiest to generate)
  • Write "What happens in this scene is..." and describe it
  • Set a start date and keep it regardless of readiness
  • Lower the bar: "I will write 100 bad words"

State D2: Start But Can't Continue

Symptoms: First scenes exist, then nothing. Each session produces less. The draft stalls after initial momentum. Getting stuck on specific scenes.

Key Questions:

  • Are you editing while drafting?
  • Did you stop at a dead end?
  • Is the current scene unclear?
  • Did you stop at a bad place last time?

Diagnostic Checklist:

  • Not re-reading previous work before writing
  • Moving forward, not polishing backward
  • Stopping mid-scene (not at ends)
  • Using placeholders for stuck parts

Interventions:

  • Skip to a different scene you CAN write
  • Use placeholders: [SOMETHING HAPPENS HERE]
  • Lower word count goals dramatically
  • Stop mid-sentence next time (easier to resume)
  • Disable backspace / turn off screen

State D3: Middle Stall

Symptoms: First act done, middle act impossible. The "muddle in the middle." Momentum lost. Unclear what connects beginning to end.

Key Questions:

  • Is the story working?
  • Is there a structural problem the draft is revealing?
  • Is motivation flagging because direction is unclear?
  • Do you know the ending?

Common Causes:

  • Outline was incomplete for middle section
  • Story problem discovered during drafting
  • The "long slog" between exciting beginning and end
  • Lost connection to why this story matters

Interventions:

  • Connect with the ending—write toward it
  • Review outline for structural gaps
  • Write scenes out of order (skip to climax if needed)
  • Ask: "What's the worst thing that could happen now?"
  • Take a short break, then resume with fresh eyes

State D4: Can't Finish

Symptoms: Draft is 70-90% complete, then stalls. Endless circling without reaching "THE END." Fear of completing. Adding instead of finishing.

Key Questions:

  • Is the ending unclear?
  • Is there fear of judgment once complete?
  • Has momentum been lost?
  • Are you avoiding the ending?

Why Writers Avoid Finishing:

  • Fear of evaluation (once done, it can be judged)
  • Uncertainty about what comes next
  • Ending feels inadequate
  • Attachment to the process over the product

Interventions:

  • Set a deadline and commit publicly
  • Commit to word count regardless of quality
  • Remember: a finished bad draft beats an unfinished "good" one
  • Write the ending NOW, then fill gaps
  • Accept the ending can be revised—just get something down

State D5: Draft Taking Too Long

Symptoms: Months or years on the same draft. Progress painfully slow. Daily word counts tiny. Constant revision disguised as drafting.

Key Questions:

  • Is editing happening during drafting?
  • Are word count goals too low?
  • Is perfectionism slowing progress?
  • Are you treating the first draft as final?

Diagnostic Checklist:

  • Daily word count goal exists and is met
  • Not re-reading more than last paragraph before starting
  • Not revising sentences after writing them
  • Actually drafting, not perpetual revision

Interventions:

  • Increase daily goals (500 → 1000 → 2000)
  • Time-box sessions (write for 1 hour, regardless of output)
  • Commit to speed over quality for remainder of draft
  • Track word count publicly for accountability
  • Use "dirty draft" philosophy: it's supposed to be bad

State D6: Draft Reveals Story Problem

Symptoms: Draft is progressing but something feels wrong. Story isn't working. Outline seemed good but execution exposes flaws. Reluctance to continue because foundation is broken.

Key Questions:

  • Is it a drafting problem or a story problem?
  • What specific element feels wrong?
  • Can you push through and fix in revision?
  • Does the outline need adjustment?

Options When Draft Goes Wrong:

  1. Push through anyway — Fix in revision (fastest)
  2. Pause and re-outline — If fundamentally broken (significant)
  3. Follow the draft — Let story go where it wants (discovery)
  4. Write both versions — Compare later (exploratory)

Interventions:

  • Distinguish: is it prose quality or story structure?
  • If prose: push through (that's what revision is for)
  • If structure: take one day to re-outline, then continue
  • If character: write the scene wrong, mark it, keep going
  • Trust that revision exists for exactly this purpose

The Internal Editor Problem

"Writer's block is a non-medical condition primarily associated with writing, in which an author is either unable to produce new work or experiences a creative slowdown."

The Neurological Reality

Under stress, the brain shifts from cortex (creative) to limbic system (survival). Creative processes are literally impaired by anxiety about the draft.

Silencing the Editor

Techniques:

  • Write with screen off
  • Use a different tool (pen, typewriter, different app)
  • Write in a "junk" file meant to be deleted
  • Set a timer and don't stop until it rings
  • Dictate instead of type
  • Write at a different time of day

Drafting Methods

The Daily Quota

Set a daily word count and meet it regardless of quality.

TargetPaceAnnual Output
500 words/daySustainable180,000 words
1,000 words/dayModerate365,000 words
2,000 words/dayIntensive730,000 words

Principle: Consistent small amounts accumulate.

The Session Method

Write in focused sessions, not word counts:

  • Pomodoro: 25 min on, 5 min off
  • Power hour: 60 min focused drafting
  • Sprint: 15-30 min bursts with breaks
The Scene Method

Don't write "the novel"—write individual scenes. Each session completes one scene.

Advantage: Discrete achievable goals.

The Out-of-Order Method

Write scenes you're excited about, regardless of position. Assemble later.

Advantage: Maintains enthusiasm; bypasses stuck points.

Free Writing

From Natalie Goldberg:

  1. Set time limit (5-20 minutes)
  2. Keep hand moving—no pausing
  3. Don't correct anything
  4. If stuck, write "I don't know what to write"
  5. When done, mark passages worth keeping

Breaking Specific Blocks

When Completely Stuck
  1. Change location (different room, outside, café)
  2. Change tool (pen/keyboard, different app)
  3. Lower the bar ("I'll just write 100 words")
  4. Skip ahead to a scene you can write
  5. Write about being stuck (free write about the block)
  6. Talk it through (explain scene aloud, transcribe)
  7. Set a timer (even 10 min of forced writing)
When a Scene Won't Work
  • Write it badly on purpose
  • Write only the dialogue
  • Summarize what needs to happen: [Character confronts villain about X]
  • Skip it with placeholder and move on
  • Ask: does this scene need to exist?
When You Hate What You've Written
  • That's normal. Keep going.
  • Don't re-read until draft is done
  • Remember: you're generating raw material
  • The revision skill exists for exactly this reason

The Writing Environment

Physical
  • Dedicated space if possible
  • Minimal distractions
  • Consistent location (habit trigger)
Show full SKILL.md (817 more words)Show less
Digital
  • Distraction-free writing tool
  • Internet blocked
  • Notifications silenced
  • Phone in another room
Temporal
  • Consistent time of day
  • Morning often works (before world intrudes)
  • Specific time matters less than consistency

Anti-Patterns

The Endless Outliner

Plans forever, never drafts. Fix: Set a start date. Outline is done when the deadline arrives.

The Sentence Polisher

Revises each sentence before writing the next. Fix: Turn off screen. Disable backspace. Forward only.

The Perfect First-Drafter

Believes first draft should be near-final. Fix: Read about professional writers' terrible first drafts.

The Mood Writer

Only writes when "inspired." Fix: Professionals write on schedule. Inspiration follows action.

The Middle Abandoner

Starts many drafts, finishes none. Fix: Finish one bad draft before starting another.

The Comparison Maker

Compares first draft to published novels. Fix: Published novels had many drafts. Compare first to first.


Diagnostic Process

When a writer comes with drafting problems:

1. Identify the State
  • Can't start? → D1
  • Starts but stalls? → D2
  • Middle stuck? → D3
  • Can't finish? → D4
  • Taking too long? → D5
  • Story problem emerging? → D6
2. Check for Internal Editor

Are they drafting or editing-in-disguise?

  • Re-reading before writing?
  • Revising sentences after writing them?
  • Standards too high for first draft?
3. Check the Method

Is there a system?

  • Daily goal (words or time)?
  • Consistent schedule?
  • Appropriate scope per session?
4. Recommend Interventions

Based on identified state and causes.


Integration with story-sense

story-sense StateMaps to Drafting State
State 3: Outline complete, draft not startedD1
State 3.5: Draft in progress but stalledD2-D5
When to Hand Off
  • To scene-sequencing: When stuck scene is structural
  • To character-arc: When character isn't coming through
  • To revision: When draft is complete (not before!)
  • To prose-style: ONLY after draft is complete
Prerequisites for This Skill

Writer should have:

  • Outline or at least clear sense of story
  • Characters defined enough to write
  • Setting clear enough to describe

If not: hand off to story-sense for earlier-stage work.


Example Interactions

Example 1: Blank Page Paralysis

Writer: "I have a complete outline but I can't start the actual draft."

Your approach:

  1. Identify state: D1 (Can't Start)
  2. Ask: "What's stopping you from writing the first scene?"
  3. Check for perfectionism or fear
  4. Suggest: Start with a zero draft or dialogue-only version
  5. Set concrete goal: "Write 500 bad words by tomorrow"
Example 2: Middle Stall

Writer: "I wrote the first five chapters but now I'm stuck."

Your approach:

  1. Identify state: D3 (Middle Stall)
  2. Ask: "Do you know how the story ends?"
  3. Check: is it boredom, structural problem, or lost momentum?
  4. If boredom: skip ahead, write an exciting scene
  5. If structural: brief outline review, then continue
  6. If momentum: set smaller daily goals, rebuild habit
Example 3: Draft Revealing Problems

Writer: "The more I write, the more I realize the plot doesn't work."

Your approach:

  1. Identify state: D6 (Story Problem)
  2. Ask: "What specifically doesn't work?"
  3. Distinguish prose quality from story structure
  4. If prose: push through (revision exists)
  5. If structure: one-day pause to re-outline, then continue
  6. Remind: first drafts are discovery—finding problems IS the process

Output Persistence

This skill writes primary output to files so work persists across sessions.

Output Discovery

Before doing any other work:

  1. Check for context/output-config.md in the project
  2. If found, look for this skill's entry
  3. If not found or no entry for this skill, ask the user first:
    • "Where should I save output from this drafting session?"
    • Suggest: explorations/drafting/ or a sensible location for this project
  4. Store the user's preference:
    • In context/output-config.md if context network exists
    • In .drafting-output.md at project root otherwise
Primary Output

For this skill, persist:

  • Drafting state diagnosis - which block or resistance applies
  • Internal editor patterns - specific voices/fears identified
  • Momentum strategies - techniques that work for this writer
  • Progress tracking - word counts, session notes, breakthroughs
Conversation vs. File
Goes to FileStays in Conversation
Diagnosed blocksClarifying questions
Working strategiesReal-time encouragement
Session progress notesDiscussion of specific scenes
Momentum insightsWriter's process discoveries
File Naming

Pattern: {project}-drafting-{date}.md Example: novel-drafting-2025-01-15.md

What You Do NOT Do

  • You do not write the draft for them
  • You do not encourage endless preparation
  • You do not validate perfectionism about first drafts
  • You do not suggest editing mid-draft
  • You do not hand off to revision until draft is DONE

Your role is to get them through the draft. The draft must exist before anything else can happen.


Key Insight

The first draft exists to be revised. Its only job is to exist.

Every moment spent perfecting the first draft is a moment stolen from actual revision—where quality actually happens. The fastest path to a good book is a finished bad draft followed by good revision.

Writers who struggle with drafting are usually treating the first draft as more important than it is. It's raw material. It's supposed to be rough. The goal is completion, not perfection.

Get words on page. Worry about quality later. That's what drafting is.

© jwynia, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/creative/fiction/craft/drafting of jwynia/agent-skills.

Open the folder on GitHubat commit e02ec7e

Compare with similar skills

Drafting next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Drafting compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Drafting this skilljwynia/agent-skills165—~3.7kAutomated safety check: PassMIT
Executealirezarezvani/claude-skills28k—~831Automated safety check: PassMIT
Draftanthropics/claude-for-legal9.6k3 repos~2.4kAutomated safety check: PassApache-2.0
Blog Post Draftingluongnv89/claude-howto42k—~2.1kAutomated safety check: PassMIT
Blog Post Drafting Workflowluongnv89/claude-howto42k—~2.2kAutomated safety check: PassMIT
Blog Draft Workflowluongnv89/claude-howto42k—~1.1kAutomated safety check: PassMIT

Similar skills

  • Execute

    alirezarezvani/claude-skills

    /cs:execute <decision — Generate a 90-day execution plan with weekly milestones, DRIs, and check-in cadence from an approved decision.

    28k GitHub stars~831 tokensUpdated 1 mo ago
    Product & Project ManagementAuto-check passed
  • Draft

    anthropics/claude-for-legal

    Official

    First draft of a common clinic document — practice-area templates (asylum applications, eviction answers, protective order petitions, demand letters), jurisdiction-aware formatting, explicitly a…

    9.6k GitHub starsUsed in 3 repos~2.4k tokens
    Legal & ComplianceAuto-check passed
  • Blog Post Drafting

    luongnv89/claude-howto

    Guides drafting a blog post from an idea and optional source material: research, brainstorming, outlining and version-tracked drafts, with user approval at each step.

    42k GitHub stars~2.1k tokensUpdated 7 days ago
    Writing & ContentAuto-check passed
  • Blog Post Drafting Workflow

    luongnv89/claude-howto

    Guides a blog post from idea to finished draft: project folder, source research, brainstorming, outline, then iterative drafting, with your approval at set points.

    42k GitHub stars~2.2k tokensUpdated 7 days ago
    Writing & ContentAuto-check passed
  • Blog Draft Workflow

    luongnv89/claude-howto

    Walks through writing a blog post from an idea and source material: research, brainstorming, outline approval, versioned drafts and optional git commits.

    42k GitHub stars~1.1k tokensUpdated 7 days ago
    Writing & ContentAuto-check passed
  • Render Blocking

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing slow page loads, heavy assets, or rendering delays related to Eliminate render-blocking resources.

    74k GitHub stars~430 tokensUpdated yesterday
    Frontend & DesignAuto-check passed

More from jwynia/agent-skills

All 113 skills in this repo
  • Devcontainer

    jwynia/agent-skills

    Diagnose devcontainer configuration problems and guide development environment setup.

    165 GitHub stars~1.2k tokensUpdated 7 mo ago
    Auto-check: notes
  • Frontend Design

    jwynia/agent-skills

    Create distinctive, production-grade frontend interfaces with high design quality.

    165 GitHub stars~3.2k tokensUpdated 7 mo ago
    Auto-check passed
  • Gitea Workflow

    jwynia/agent-skills

    Orchestrate agile development workflows for Gitea repositories using the tea CLI.

    165 GitHub stars~3.8k tokensUpdated 7 mo ago
    Auto-check passed
  • Godot Asset Generator

    jwynia/agent-skills

    Generate game assets using AI image generation APIs (DALL-E, Replicate, fal.ai) and prepare them for Godot.

    165 GitHub stars~3.8k tokensUpdated 7 mo ago
    Auto-check passed
  • Mastra Hono

    jwynia/agent-skills

    Develop AI agents, tools, and workflows with Mastra v1 Beta and Hono servers.

    165 GitHub stars~2.9k tokensUpdated 7 mo ago
    Auto-check passed
  • PPTX Generator

    jwynia/agent-skills

    Create and manipulate PowerPoint PPTX files programmatically.

    165 GitHub stars~3.1k tokensUpdated 7 mo ago
    Auto-check passed

Questions about Drafting

What does Drafting do?

Break through blocks and execute first drafts. An agent skill from jwynia/agent-skills. Drafting is an agent skill from jwynia/agent-skills. Break through blocks and execute first drafts.

When should I use Drafting?

Drafting fits situations like: the outline is done but the draft isnt happening; writers block strikes; the blank page remains blank; progress stalls.

How do I install Drafting in Claude Code?

Run `npx skills add jwynia/agent-skills --skill drafting -a claude-code`. Or copy the skill folder (skills/creative/fiction/craft/drafting in jwynia/agent-skills) into .claude/skills/drafting in your project. Claude Code loads it when a task matches its description.

How do I install Drafting in Codex?

Run `npx skills add jwynia/agent-skills --skill drafting -a codex`. Or copy the skill folder (skills/creative/fiction/craft/drafting in jwynia/agent-skills) into .agents/skills/drafting in your project. Codex loads it when a task matches its description.

Can I use Drafting in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jwynia/agent-skills --skill drafting -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/drafting, .gemini/skills/drafting, .github/skills/drafting and .opencode/skills/drafting in your project.

What does Drafting need to run?

SKILL.md names no scripts, command-line tools or credentials: Drafting is instructions for the agent only.

Does Drafting access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Drafting safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Drafting use?

Drafting is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Drafting use?

About 3.7k tokens (SKILL.md is roughly 15k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Drafting?

Skills that share tags, products or a category with Drafting: Execute (alirezarezvani/claude-skills, 28k stars), Draft (anthropics/claude-for-legal, 9.6k stars), Blog Post Drafting (luongnv89/claude-howto, 42k stars) and Blog Post Drafting Workflow (luongnv89/claude-howto, 42k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Drafting?

jwynia (a GitHub user) maintains it in jwynia/agent-skills, which has 165 GitHub stars. The repository holds 113 skills in this directory. The repository was last updated on February 24, 2026.

Source: jwynia/agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.