Agent skill

Flash Fiction

by jwynia in jwynia/agent-skills

Diagnose and fix problems in flash fiction and micro fiction.

MITAuto-check passedWriting & Content

Install Flash Fiction

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

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

GitHub CLI
$ gh skill install jwynia/agent-skills flash-fiction --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/application/flash-fiction .claude/skills/flash-fiction && 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
flash-fiction
GitHub stars
170
Token cost
~3.4k tokens
SKILL.md length
1,337 words
Files
1
Skills in repo
111
Repo updated
First seen
Licence
MIT

At a glance

Diagnose and fix problems in flash fiction and micro fiction.

  • Works in 5 steps: Does the first sentence create immediate… → Is there a clear turning point? → Does each paragraph advance multiple… → …
  • Flash fiction feels weak
  • SKILL.md covers Purpose, Quick Reference, Diagnostic States and Evaluation Checklist, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Flash Fiction is an agent skill from jwynia/agent-skills. 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.

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

It sits in Writing & Content, covering Creative writing and fiction. The licence is MIT.

When your agent uses it

  • Flash fiction feels weak
  • Writing stories under 1500 words
  • Working with micro fiction
  • Compressed narrative forms

Example prompts

  • “/flash-fiction”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  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?

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

Flash Fiction loads about 3.4k tokens when it runs. Until then it costs about 57 tokens; SKILL.md has 1,337 words of instructions outside code blocks.

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

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). 1,337 words, ~3,448 tokens.

Download SKILL.mdSave it as .claude/skills/flash-fiction/SKILL.md (or your agent's skills folder).
name
flash-fiction
description
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.
license
MIT
metadata.author
jwynia
metadata.version
1.0
metadata.type
diagnostic
metadata.mode
evaluative
metadata.domain
fiction

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
  • Show theme through specific circumstances, then let readers generalize
  • Include multiple viewpoints on the thematic question
  • Replace "character realized that..." with demonstrating action
  • Preserve complexity in the conclusion

Transformation Pattern:

STATED: "Carl realized that trust was essential for relationships."
EMBODIED: "Carl handed her the combination to the safe where he kept
his mother's letters, then turned away so he wouldn't see her expression."

Show full SKILL.md (514 more words)Show less
FF8: Language Precision & Rhythm Issues

Symptoms:

  • Weak verbs (walked, went, was)
  • Vague nouns (thing, stuff, area)
  • Unnecessary modifiers
  • Sentence monotony
  • No musicality

Diagnostic Questions:

  1. Does each verb precisely capture the specific action?
  2. Are nouns concrete and specific?
  3. Does each modifier meaningfully sharpen understanding?
  4. Are sentence lengths and structures varied?
  5. Do sound patterns enhance (alliteration, rhythm, cadence)?

Interventions:

  • Replace weak verbs with precise, energetic alternatives
  • Substitute general nouns with specific, sensory-rich ones
  • Eliminate redundant or decorative modifiers
  • Vary sentence structure for rhythm and emphasis
  • Develop sound patterns that match meaning

Transformation Pattern:

WEAK: "She went across the field quickly."
PRECISE: "She slashed through the wheat, scattering husks."

MONOTONOUS: "He opened the door. He looked inside. He saw nothing. He closed the door."
VARIED: "He opened the door and looked inside. Nothing. The door clicked shut as he turned."

FF9: Logical Consistency Breach

Symptoms:

  • Something feels "off" even if hard to identify
  • Physical impossibilities
  • Timeline contradictions
  • Characters know things they shouldn't
  • Rules established then broken

Diagnostic Questions:

  1. Do objects function consistently?
  2. Does the timeline allow events as described?
  3. Do characters know only what they could realistically know?
  4. Are physical limitations respected?
  5. If rules are bent, is it consistent?

Interventions:

  • Map physical movement and verify possibility
  • Chart events chronologically with durations
  • Check character knowledge boundaries
  • Verify cause-effect proportionality
  • Document world rules and check consistent application

Transformation Pattern:

IMPOSSIBLE: "She finished her shift at midnight, drove 30 miles home,
cooked dinner, and was in bed by 12:15."
POSSIBLE: "She finished at midnight. The apartment she'd rented
closer to the hospital meant she could be cooking within minutes."

Evaluation Checklist

For any flash fiction piece:

Structure (FF1)

  • First sentence hooks
  • Each paragraph serves multiple purposes
  • Clear arc despite compression
  • Scope matches word count

Character (FF2)

  • Characters introduced through revealing action
  • History inferred, not explained
  • Change shown through action

Frame (FF3)

  • Opening/closing images relate
  • Ending fulfills or transforms promise
  • Emotional journey complete

Subtext (FF4)

  • More implied than stated
  • Strategic gaps for reader participation
  • Iceberg effect achieved

Imagery (FF5)

  • Fresh figurative language
  • Imagery patterns develop
  • Symbols naturally integrated

Setting (FF6)

  • Specific time/place established quickly
  • Multiple senses engaged
  • Setting serves theme

Theme (FF7)

  • Theme emerges, not stated
  • Multiple perspectives present
  • Complexity preserved

Language (FF8)

  • Precise verbs
  • Concrete nouns
  • Sentence variety
  • Musicality present

Consistency (FF9)

  • Physics work
  • Timeline possible
  • Knowledge boundaries respected

Anti-Patterns

The Miniature Novel

Trying to compress a novel-length story into flash length. Flash fiction is not a summary—it's a complete experience in miniature. Choose a scope that fits.

The Twist Dependency

Relying entirely on a surprise ending. If the story only works with the twist, the preceding content isn't pulling weight. The journey should matter.

The Vignette Trap

Beautiful prose without narrative movement. Flash fiction still needs change—something must be different by the end, even if subtle.


Integration Points

Inbound:

  • From story-sense: After identifying story state
  • From drafting: During first draft creation
  • From revision: For line-level polish

Outbound:

  • To prose-style: For deeper language work
  • To dialogue: For conversation problems
  • To endings: For closure issues

Complementary:

  • scene-sequencing: Single-scene pacing
  • character-arc: Compressed transformation
  • cliche-transcendence: Fresh imagery generation

Word Count Guidance

LengthNameFocus Priority
<100DrabbleSingle image, single moment, maximum compression
100-500Micro fictionOne scene, one shift, implication over statement
500-1000Flash fictionSmall arc, 1-2 scenes, full iceberg effect
1000-1500Sudden fictionMultiple scenes possible, more character room
1500-2500Short shortApproaching short story territory

Sources

Frameworks synthesized from flash fiction craft analysis, incorporating principles from:

  • Hemingway's iceberg theory
  • John Gardner on the "vivid and continuous dream"
  • Compression techniques from poetry applied to prose

© 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/application/flash-fiction of jwynia/agent-skills.

Open the folder on GitHubat commit e02ec7e

Compare with similar skills

Flash Fiction 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.

Flash Fiction compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Flash Fiction this skilljwynia/agent-skills170—~3.4kAutomated safety check: PassMIT
Story Multi-Perspective Reviewzenstory-ai/oh-story-claudecode7.4k3 repos~3kAutomated safety check: PassMIT
Short Web Fiction Trend Scanzenstory-ai/oh-story-claudecode7.4k2 repos~1.2kAutomated safety check: PassMIT
InkOS Creative HarnessNarcooo/inkos10k1 repos~1.1kAutomated safety check: PassAGPL-3.0
Novel Arteternityspring/shuohao-skills4.3k—~1.1kAutomated safety check: NotesApache-2.0
SepiaNanako0129/sepia3.1k—~3.6kAutomated safety check: PassMIT

Similar skills

  • Story Multi-Perspective Review

    zenstory-ai/oh-story-claudecode

    Reviews Chinese web-novel text with several reviewer agents in parallel, falling back to a single-agent pass, and reports structure, character, prose and setting problems with fixes.

    7.4k GitHub starsUsed in 3 repos~3k tokens
    Writing & ContentAuto-check passed
  • Short Web Fiction Trend Scan

    zenstory-ai/oh-story-claudecode

    Scans popular short web-fiction rankings on Chinese platforms such as Dianzhong and Heiyan to surface trending emotional hooks, themes and topic candidates with an expiry warning.

    7.4k GitHub starsUsed in 2 repos~1.2k tokens
    Writing & ContentAuto-check passed
  • Drives long-form fiction, scripts, storyboards, interactive films and long-document translation through InkOS, with every change made by a typed action.

    10k GitHub starsUsed in 1 repo~1.1k tokens
    Writing & ContentAuto-check passed
  • Novel Art

    eternityspring/shuohao-skills

    给 AI 短剧出美术设定集(场景 + 叙事道具):场景的设计意图、一致性锚点、光照时段变体、 空景提示词;道具的戏剧功能、状态变体、尺度参照、白底无手提示词。

    4.3k GitHub stars~1.1k tokensUpdated 3 days ago
    Writing & ContentAuto-check: notes
  • Sepia

    Nanako0129/sepia

    Make AI-generated writing read as human-written, in fiction and in professional prose.

    3.1k GitHub stars~3.6k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Story Toolbox Router

    zenstory-ai/oh-story-claudecode

    Routes a Chinese web-novel writing request to the matching tool in a 13-skill toolbox, covers author habit memory, and can launch a local dashboard for browsing a project.

    7.4k GitHub stars~1.7k tokensUpdated yesterday
    Writing & ContentAuto-check passed

More from jwynia/agent-skills

All 111 skills in this repo
  • Devcontainer

    jwynia/agent-skills

    Diagnose devcontainer configuration problems and guide development environment setup.

    170 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.

    170 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.

    170 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.

    170 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.

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

    jwynia/agent-skills

    Create and manipulate PowerPoint PPTX files programmatically.

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

Questions about Flash Fiction

What does Flash Fiction do?

Diagnose and fix problems in flash fiction and micro fiction. Flash Fiction is an agent skill from jwynia/agent-skills. Diagnose and fix problems in flash fiction and micro fiction.

When should I use Flash Fiction?

Flash Fiction fits situations like: flash fiction feels weak; writing stories under 1500 words; working with micro fiction; compressed narrative forms.

How do I install Flash Fiction in Claude Code?

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

How do I install Flash Fiction in Codex?

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

Can I use Flash Fiction 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 flash-fiction -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/flash-fiction, .gemini/skills/flash-fiction, .github/skills/flash-fiction and .opencode/skills/flash-fiction in your project.

What does Flash Fiction need to run?

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

Does Flash Fiction 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 Flash Fiction 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 Flash Fiction use?

Flash Fiction 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 Flash Fiction use?

About 3.4k tokens (SKILL.md is roughly 14k 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 Flash Fiction?

Skills that share tags, products or a category with Flash Fiction: Story Multi-Perspective Review (zenstory-ai/oh-story-claudecode, 7.4k stars), Short Web Fiction Trend Scan (zenstory-ai/oh-story-claudecode, 7.4k stars), InkOS Creative Harness (Narcooo/inkos, 10k stars) and Novel Art (eternityspring/shuohao-skills, 4.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Flash Fiction?

jwynia (a GitHub user) maintains it in jwynia/agent-skills, which has 170 GitHub stars. The repository holds 111 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.