Files
magnus919_agent-skills/writers-helper/references/pitfalls-and-solutions.md
Magnus HedemarkGitHubfactory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
6fe5aed86e feat(skill): rename writing skill to writers-helper (#302)
Rename the skill directory to writers-helper and update the name field,
eval manifest skill_name, skill README title and example paths, root
README catalog entry, and the skill-triggers index. Regenerate llms.txt,
.claude-plugin/marketplace.json, .codex-plugin/plugin.json, and
.agents/plugins/marketplace.json from their generators. Content is
unchanged.

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
2026-08-08 13:06:46 -04:00

8.4 KiB
Raw Permalink Blame History

Pitfalls and Solutions

The failure modes that kill drafts, careers, and manuscripts — collected across the writing library, organized by stage, each with the fix. Use this when something is going wrong and you need the fastest honest diagnosis. When in doubt, diagnose before prescribing: name the actual failure, then apply the matched fix.

In planning and premise

Pitfall Fix
Premise has no conflict It's a topic, not a story. Add a protagonist with a goal, an obstacle, and stakes; run the four-test screen in workflow-and-planning.md
Scope is wrong Card-outline the project; if it can't finish at the intended length, narrow the premise
"Everyone" is the audience There's no such thing as too narrow a market if you can show purchase intent. Name the specific reader
Planning forever, writing never The plan is a form of procrastination. Stake five load-bearing scenes and start the draft; outline after the draft if you must
No deadline Run the goal math (deadline → comparable books → daily target) and schedule in pen

In drafting

Pitfall Fix
Editing while drafting Split the modes completely; a no-edit-while-drafting regime. First drafts are raw material
Perfectionism / can't start It's fear wearing a costume. Tiny timed next action; slop-on-the-page draft; permission to write badly
Going back to the beginning Restart syndrome. The end reveals what the beginning needed — push forward
Sagging middle The middle is half the book and gets twice as many scenes; the masks fall, bad things happen, challenges escalate. Check the energy map: is anything happening above the line?
Protecting characters Writers in love with their characters refuse to hurt them. The middle is where the protagonist is subjected to progressively tougher challenges
Stopping at chapter ends Momentum dies. Stop mid-scene or mid-sentence; recopy the last 2030 words at the next start
Research rabbit holes Research is a seducer. Write first, keep a gaps list, verify after
Slow writing Below ~1,200 words/hour the inner critic is interfering. Re-relax, change tools, pace in timed blocks
Multi-year drafting Several versions of the voice get into one book. Write fast; two drafts are enough

In structure and story

Pitfall Fix
Episodic scenes Scenes must chain by cause and effect; draw the links; unlinked scenes read as episode, not plot
No character change Plot is character change. Identify who changes most; that's the spine. Check the four markers
Missing flaw Find it at the crisis: whatever the protagonist can't do when it counts is the flaw — thread it backward
Crisis with no energy Often it's really the recommitment scene. Promote a bigger scene into the crisis position, or add a second higher peak
Backstory dumped up front Withhold until the reader cares; the sanctioned full reveal is at the threshold after the crisis
Info dumps Express beliefs and world facts through characters' actions and dialogue; give only what the scene needs
All-summary telling Convert pivotal moments to moment-by-moment scenes; render emotion as behavior
Subplot sprawl A subplot survives only if removing it changes the main outcome or emotional impact. Cut the rest
Never-repeat-deepen violations Every reappearance escalates: wider consequences, deeper glimpse
Overlong introductions Nobody cares about characters until they do something interesting. Cut the intro to essentials
Point-of-view slips One narrator per scene; no leaks of unobserved thoughts; make switches unmistakable from the first line

In prose and mechanics

Pitfall Fix
Passive-voice drag Convert to active unless the object or unknown agent is the point
Adverb and adjective reliance Prefer precise verbs and strong nouns; split the sentences that leaned on them
Clichés and dead metaphors The completion test: if you can finish the phrase, it's a cliché. Kill them; never mix metaphors
Monotone sentences Vary length and type; short for urgency, long for calm; measure the distribution
Muddy prose Unclear pronouns, subject-verb separation, run-ons — run the macro-then-micro checklists in editing-and-revision.md
Correct spelling, wrong word Confusables pass with mnemonic explanations; a spell-checker can't catch their/there/they're
Flowery or bookish diction Express, don't impress; prefer the true word over the impressive one
Logic errors Faulty comparisons, qualified absolutes, non sequiturs, sweeping generalizations — an editing pass checks reasoning, not just grammar

In dialogue

Pitfall Fix
On-the-nose lines Subtext: write about one thing, mean another
Interchangeable voices The blind test: identify the speaker from the block alone; write from inside each character's perception
Transcript dialogue Edit real speech down to its essence; mix fragments and hesitations
Tag clutter "Said" is invisible; use none once speakers are established
Exposition disguised as dialogue Convert exposition into questions the audience wants answered, then pay them off

In revision and editing

Pitfall Fix
Line editing before structure Polish can't fix a broken story. Gate the sequence: structure → prose → mechanics
No rest period You can't edit what you're still composing. Set the draft aside a week to ten days minimum
No trusted readers 25 advance readers; ask big-picture questions first
Fixing the wrong problem If queries fail, fix the query; if partials fail, fix the manuscript. Match the fix to the failure
Revision without end Set a "good enough for submission" deadline and mean it
Polishing dead scenes Cut or merge scenes that fail several of the seven elements before polishing them

In the business of writing

Pitfall Fix
Submitting too early You get one first impression; a bad first read can persist. Wait a week, reread, then send
"Dear Agent" or misspelled names Research the exact person; agents move — verify current employment
Gimmicks in queries One page, plain paper, hook first, no humor gimmicks
Fee-charging "agents" Reading fees, mandatory paid edits, padded expenses — run. Legitimate agents earn commission only
Vanity presses Pay-to-publish with poor distribution and no editorial selection. If they charge you and take rights, run
Waiting for discovery You are your own number-one client; generate your own work, follow up, ask for the referral
Ignoring the money math A nominal six-figure deal nets far less after commission and taxes. Decide with eyes open
Over-contacting an agent Check in every 34 weeks and keep it; the squeaky wheel gets replaced
No platform The author is the marketer; build the audience before you need it
Stopping after one book Careers build over several titles; start the next project the day the last one ships
Rejection as verdict Rejection is arithmetic about fit; boomerang the submission and keep going

In the writing life

Pitfall Fix
All-or-nothing scheduling Frequency and smallness beat heroic volume; a one-minute practice beats a biweekly marathon
Burnout Recharge is a habit: sleep, exercise, rest days, time off between books
Lifestyle creep Low overhead preserves the freedom to choose projects by passion
Isolation Community is the lifeline; a small serious writing group outranks a support group
"Not good enough" identity Identity is claimed, not conferred. Say "I am a writer" and collect counter-evidence
Comparing yourself to others Jealousy is energy; channel it into practice and remember criticism targets the work
Storing anger Wait three days, then decide — rejection and critique are process, not injury

The universal ones

  • Fear of failure and fear of success are the two great writers' fears; both dissolve into small timed next actions and finished small pieces.
  • Never stop the boomerang: a piece that isn't circulating is a piece that isn't trying.
  • Voice sovereignty: the author is the final judge of their own work; a helper who flattens the writer's voice is a liability.
  • Copyright hygiene: never reproduce published text; paraphrase, synthesize, and write original examples — in this skill and in everything the writer ships.