jwynia/agent-skillsMIT1 file

Flash Fiction

Diagnose and fix problems in flash fiction and micro fiction. Use when flash fiction feels weak, when writing stories under 1500 words, when working with micro fiction, sudden fiction, or compressed narrative forms.

Specification
Skill ID
jwynia/agent-skills/flash-fiction
Publisher
jwynia
Repository
agent-skills
Installs
0
Files
1
License
MIT
Synced
Sep 23, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

jwynia/agent-skills/flash-fictionInstalls these files
  • SKILL.md

What this skill tells the agent

Flash Fiction Diagnostic

Purpose

Diagnose and fix problems in flash fiction and micro fiction (typically under 1500 words). Flash fiction demands exceptional craft efficiency—every word must serve multiple purposes. This skill identifies which dimension needs attention when a piece isn't working.

Quick Reference

StateSignalCore Issue
FF1Opening doesn't hookStructure/Pacing problem
FF2Characters feel thinCharacter compression failure
FF3Beginning/ending disconnectFrame weakness
FF4Everything on surfaceSubtext missing
FF5Prose feels flatImagery/figurative language weak
FF6Setting genericSensory detail lacking
FF7Theme absent or preachyThematic development off
FF8Words don't singLanguage precision/rhythm issues
FF9Something feels "off"Logical consistency breach

Diagnostic States

FF1: Structure & Pacing Failure

Symptoms:

  • Opening doesn't grab
  • Middle sags or rushes
  • Ending feels abrupt or dragged
  • Word count not distributed well
  • Arc feels incomplete

Diagnostic Questions:

  1. Does the first sentence create immediate engagement?
  2. Is there a clear turning point?
  3. Does each paragraph advance multiple purposes (plot + character + theme)?
  4. Is the scope appropriate for the word count?
  5. Is information released at optimal moments?

Interventions:

  • Map the arc: beginning → rising action → climax → resolution
  • Calculate word distribution across sections
  • Strengthen opening hook (in medias res, mystery, declaration)
  • Ensure ending provides closure while leaving resonance
  • Cut any paragraph that only does one thing

Transformation Pattern:

WEAK: "Sarah had been working at the firm for three years when she found the file."
STRONG: "The file had no label—just a smudge of what looked like dried blood along its edge."

FF2: Character Compression Failure

Symptoms:

  • Characters feel generic or interchangeable
  • Too much backstory exposition
  • Character change feels unearned
  • Relationships explained rather than shown
  • No sense of life beyond the page

Diagnostic Questions:

  1. Is each character introduced through revealing action?
  2. Can history be inferred without explicit backstory?
  3. Do defining objects/mannerisms reveal essence?
  4. Is the character arc shown through parallel actions?
  5. Do relationships emerge through interaction, not explanation?

Interventions:

  • Replace generic description with character-specific detail
  • Convert backstory exposition to implications
  • Ensure first action reveals personality
  • Show change through decision pattern shifts
  • Establish relationships through what's unspoken

Transformation Pattern:

WEAK: "James had PTSD from the war. He moved to escape memories."
STRONG: "James flinched at the turkey platter's clatter, hand reaching for the phantom sidearm.
He'd chosen this town for its population sign: 827 souls—small enough to hear rumors
of strangers before meeting them."

FF3: Beginning/Ending Frame Weakness

Symptoms:

  • Opening and closing feel disconnected
  • No sense of journey despite brevity
  • Ending doesn't fulfill opening's promise
  • First/last images don't resonate
  • Structure feels arbitrary

Diagnostic Questions:

  1. What does the opening promise the reader?
  2. Does the ending fulfill or meaningfully subvert that promise?
  3. Is there a first/last image relationship (echo, transformation, contrast)?
  4. Does the ending feel both surprising and inevitable?
  5. What emotion persists after reading?

Interventions:

  • Identify the implicit contract the opening creates
  • Ensure closing image relates to opening image
  • Consider circular structure (return with transformation)
  • Strengthen final sentence for resonance
  • Check that emotional journey is complete

Transformation Pattern:

WEAK ENDING: "So they decided not to sell. They were happy. The end."
STRONG ENDING: "Daniel returned the FOR SALE sign to the garage, laid it beside the smaller
one from his childhood treehouse. Some prices, they'd decided, were too steep to calculate."

FF4: Subtext Missing

Symptoms:

  • Everything stated explicitly
  • No layers beneath surface
  • Readers don't participate in meaning-making
  • Backstory dumped, not implied
  • No iceberg effect

Diagnostic Questions:

  1. What is stated that could be implied?
  2. What is strategically left unsaid?
  3. Are there meaningful gaps for readers to fill?
  4. Does the visible portion suggest invisible depth?
  5. Is ambiguity purposeful or accidental?

Interventions:

  • Convert explicit statements to implications
  • Create strategic gaps (narrative ellipsis)
  • Withhold information for revelation impact
  • Apply iceberg theory: show tip, imply mass below
  • Ensure backstory emerges through objects/actions, not explanation

Transformation Pattern:

EXPLICIT: "John never recovered from his divorce. He felt bitter about Maria leaving him."
IMPLIED: "John twisted his wedding ring finger, a reflex unchanged by three years and
the absence of metal. The man at the next table laughed, and John recognized
the laugh before the face."

FF5: Imagery & Figurative Language Weak

Symptoms:

  • Prose feels flat or utilitarian
  • Metaphors cliched or absent
  • No pattern to imagery
  • Symbols heavy-handed or missing
  • Descriptions don't resonate

Diagnostic Questions:

  1. Are comparisons fresh and precise?
  2. Do metaphors/similes serve multiple purposes (character + theme + emotion)?
  3. Is there an imagery pattern that develops?
  4. Are symbolic objects naturally integrated?
  5. Is there balance between concrete and abstract?

Interventions:

  • Replace clichéd comparisons with original ones
  • Ensure figurative language reveals character perspective
  • Build related image patterns that develop
  • Select symbolic objects that can transform meaning
  • Ground abstract concepts in concrete imagery

Transformation Pattern:

FLAT: "The factory was abandoned and looked sad."
RICH: "Machinery hulked under dust shrouds, metal teeth gleaming in fractured light
between boarded windows. No one suggested splitting up."

FF6: Setting & Sensory Detail Lacking

Symptoms:

  • Location generic or absent
  • Only visual sense engaged
  • Setting doesn't serve character/theme
  • Atmosphere missing
  • Environment feels like backdrop, not participant

Diagnostic Questions:

  1. How quickly is the reader oriented in specific time/place?
  2. Are multiple senses engaged?
  3. Does setting reveal character without stating it?
  4. Does environment reinforce theme?
  5. Is atmospheric mood established through concrete detail?

Interventions:

  • Replace generic settings with specific, revealing locations
  • Incorporate non-visual senses (sound, smell, touch, taste)
  • Make setting details reveal character relationship to place
  • Align physical environment with thematic concerns
  • Embed mood in concrete details, not stated atmosphere

Transformation Pattern:

GENERIC: "The coffee shop was busy. People sat drinking coffee."
SPECIFIC: "The Fallout Shelter Café's concrete walls trapped steam from twenty
underemployed grad students' laptops, their whispered theories competing
with grinding beans and Ella Fitzgerald's crackled vinyl."

FF7: Thematic Development Off

Symptoms:

  • Theme absent or unclear
  • Theme stated, not embodied
  • Didactic/preachy tone
  • Single perspective dominates
  • Ending oversimplifies

Diagnostic Questions:

  1. Is the theme identifiable without being heavy-handed?
  2. Does theme emerge from character and situation (not imposed)?
  3. Are multiple perspectives on the theme represented?
  4. Is thematic content conveyed through concrete details?
  5. Does the conclusion deepen rather than simplify?

Interventions:

  • Embody theme in action and object, not statement

Use this skill in a project

Open any RiverX project, search the Skills panel for jwynia/agent-skills/flash-fiction, and install it in one click.

Use this skill