mirror of
https://github.com/magnus919/agent-skills.git
synced 2026-09-18 23:16:38 +03:00
6fe5aed86e
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>
8.4 KiB
8.4 KiB
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 20–30 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 | 2–5 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 3–4 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.