visual-narrative

A visual narrative skill used by the dialogue-writer and comic-editor agents. Provides speech bubble systems, sound effect typography, Show-Don't-Tell principles, and visual metaphor techniques. Used for 'speech bubbles,' 'sound effects,' 'visual storytelling,' 'comic direction,' and related topics.

495 stars

Best use case

visual-narrative is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

A visual narrative skill used by the dialogue-writer and comic-editor agents. Provides speech bubble systems, sound effect typography, Show-Don't-Tell principles, and visual metaphor techniques. Used for 'speech bubbles,' 'sound effects,' 'visual storytelling,' 'comic direction,' and related topics.

Teams using visual-narrative should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/visual-narrative/SKILL.md --create-dirs "https://raw.githubusercontent.com/revfactory/harness-100/main/en/07-comic-creator/.claude/skills/visual-narrative/skill.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/visual-narrative/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How visual-narrative Compares

Feature / Agentvisual-narrativeStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

A visual narrative skill used by the dialogue-writer and comic-editor agents. Provides speech bubble systems, sound effect typography, Show-Don't-Tell principles, and visual metaphor techniques. Used for 'speech bubbles,' 'sound effects,' 'visual storytelling,' 'comic direction,' and related topics.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Visual Narrative — Visual Narrative Methodology

Expert knowledge used by the dialogue-writer and comic-editor agents when integrating dialogue and visual elements.

## Why Visual Narrative Matters

In comics, dialogue accounts for only about **30%** of the storytelling. The remaining 70% is conveyed through art, composition, expressions, sound effects, and white space. The less dialogue, the stronger the comic.

## Speech Bubble System

### Speech Bubble Types

| Type | Shape | Use | Prompt Instruction |
|------|-------|-----|-------------------|
| **Normal Dialogue** | Rounded ellipse | Regular conversation | "speech bubble" |
| **Thought** | Cloud shape | Inner monologue | "thought bubble, cloud shape" |
| **Shout/Emphasis** | Explosion/Jagged | Loud voice, anger | "burst speech bubble, jagged" |
| **Whisper** | Dashed ellipse | Low voice | "dashed speech bubble, whisper" |
| **Electronic Voice** | Rectangular border | Phone, broadcast, AI | "rectangular speech box" |
| **Narration** | Rectangular box (top) | Commentary, time markers | "narration box, caption" |
| **Emotion Symbol** | Symbol only | ?, !, ..., heart | Symbols without bubbles |

### Speech Bubble Placement Rules

1. **Reading order**: Top-to-bottom, left-to-right (for left-to-right languages)
2. **Tail direction**: The bubble tail points toward the speaker's mouth
3. **No obstruction**: Bubbles must not cover important visual elements
4. **Maximum 3**: No more than 3 speech bubbles per panel (split panel if exceeded)
5. **Use blank space**: Placing bubbles in the top third of the panel is most natural

## Sound Effect Typography

### Sound Effect Library

| Category | Examples | Context |
|----------|---------|---------|
| **Impact** | WHAM! CRASH! BAM! THUD! | Punches, collisions, explosions |
| **Movement** | WHOOSH~ SWISH! ZOOM | Running, flying, spinning |
| **Emotion** | Thump thump, Shiver, Tingle | Heartbeat, fear, excitement |
| **Environment** | RUMBLE, SPLASH, RUSTLE | Thunder, water, wind |
| **Daily Life** | CLICK, SCREECH, DRIP, SNAP | Doors, brakes, drops, cameras |
| **Silence** | ... (dead silence) | Tense quiet |

### Sound Effect Design Rules

- **Size = Volume**: Larger text = louder sound, smaller text = quieter
- **Tilt = Speed**: Tilted text = fast movement
- **Color = Nature**: Red = destruction, Blue = cold, Yellow = electricity
- **Position = Source**: Place near the source of the sound
- **Font**: Use a different font from body text; handwritten feel recommended

## Show-Don't-Tell Principle

### Show Through Art, Don't Tell Through Dialogue

| Bad Example (Tell) | Good Example (Show) |
|--------------------|---------------------|
| "I'm so angry!" | Clenched fist, gritted teeth in close-up |
| "This place is dangerous" | Cracked walls, bloodstained signs, warning lights |
| "A lot of time has passed" | Changing seasons, grown trees, rusted objects |
| "I started to like her" | Eyes drifting toward her, flushed cheeks |
| "This is a precious object" | Trembling hands carefully clutching it |

### Emotion Visual Codes

| Emotion | Visual Code |
|---------|------------|
| **Anger** | Forehead veins, shaking frame, red background, gritted teeth |
| **Sadness** | Rain/snow overlay, dark tones, slumped posture, tears |
| **Joy** | Bright tones, flower petals/light rays, wide smile |
| **Fear** | Wide eyes, darkness, long shadows, trembling hands |
| **Surprise** | White pupils, halo effect, startled posture, sweat drops |
| **Tension** | Narrow panels, consecutive close-ups, dark-light contrast |

## Page Transition Techniques

### Scene Transition Methods

| Technique | Description | Use Case |
|-----------|-------------|----------|
| **Cut** | Immediate scene change, no connection | Time/location change |
| **Dissolve** | Two scenes overlapping in one panel | Flashback, daydream |
| **Wipe** | Diagonal/horizontal scene split | Simultaneous events |
| **Match Cut** | Object in Scene A matches object in Scene B | Metaphorical connection |
| **Color Shift** | Color change indicates time/mood shift | Past (sepia) -> Present (full color) |

## Text-Image Density Balance

| Scene Type | Text Ratio | Image Ratio | Panel Count |
|-----------|-----------|-------------|-------------|
| Action/Combat | 10-20% | 80-90% | Many small panels |
| Daily Conversation | 40-50% | 50-60% | Medium uniform panels |
| Emotional Scene | 10-20% | 80-90% | Few large panels |
| Exposition/Flashback | 30-40% | 60-70% | Narration boxes |
| Comedy | 30-40% | 60-70% | Large panel for punchline |

Related Skills

scenario-narrative-engine

495
from revfactory/harness-100

A specialized skill for vividly constructing each scenario's narrative and designing timelines and early warning signals during scenario design. Used by the scenario-designer agent when narrativizing 2x2 matrix-based scenarios. Automatically applied in contexts such as 'scenario narrative', 'scenario story', 'timeline', 'early warning signals', 'early warning'. However, fictional novel writing or movie screenplay creation are outside the scope of this skill.

ir-narrative-builder

495
from revfactory/harness-100

A skill that professionally supports investor report narrative construction. Used by strategy-updater and ir-reviewer when designing the tone, structure, and storyline of investor communications. Automatically applied in contexts such as 'investor narrative', 'equity story', 'IR message', 'strategy update story'. However, drafting statutory disclosure text or writing brokerage reports are outside the scope of this skill.

visualization-chooser

495
from revfactory/harness-100

Visualization type selection matrix by data type and analysis purpose, matplotlib/seaborn/plotly implementation pattern guide. Use this skill for data visualization design involving 'visualization selection', 'chart type', 'graph types', 'matplotlib', 'seaborn', 'plotly', 'heatmap', 'scatter plot', 'box plot', 'dashboard layout', etc. Enhances the visualizer's visualization design capabilities. Note: statistical analysis and data cleaning are outside this skill's scope.

visual-storytelling

495
from revfactory/harness-100

Visual Storytellingof Story Design, Text writing, AI Image (Gemini), HTML Layout, Integration Editing an agent team collaborates to production to line. 'Visual Story ', 'in Planning', 'Image+ combination', 'Visual in', 'Story page production', ' Story', 'Visual Planning', 'Image in', ' Story', 'Visual Narrative' etc. Imageand Text Storytelling productionin . Text Image casein Layout Integration . , video Editing, DTP, (JS ) of .

narrative-structure-patterns

495
from revfactory/harness-100

Visual Storytellingof Narrative Structure Pattern Library. 3/5/hero's journey Structure, Emotion Curve Design, Scene before technique, Text-Image Balance Formula story-architect Extended Skill. 'Narrative Structure', 'Story arc', 'Emotion Curve', 'Scene before', ' Structure', 'Visual rhythm' etc. Story Design when . , Text writing Image of .

data-visualization-guide

495
from revfactory/harness-100

Visualization Chart Selection Guide, Information Hierarchy Design , number-Chart matrix info-architect Extended Skill. 'Chart Selection', ' Visualization', ' ', 'Information Design', 'Chart ', ' Storytelling' etc. Visualto expression . , Chart BI of .

narrative-structure

495
from revfactory/harness-100

A specialized skill for the story-architect and narrator agents covering documentary narrative structure. Provides 3-act structure, emotion curves, scene arrangement, and narrative patterns by documentary type. Use for 'treatment,' 'narrative structure,' '3-act,' 'emotion curve,' and similar topics.

game-narrative

495
from revfactory/harness-100

A full narrative pipeline where an agent team collaborates to design game story, quests, dialogue, and branching scenarios all at once. Use this skill for 'create a game scenario,' 'game story design,' 'quest design,' 'game dialogue writing,' 'branching scenarios,' 'world-building,' 'NPC dialogue,' 'game scenario branching,' 'interactive story,' and all other aspects of game narrative design. Also supports quest/dialogue/branch design when existing world-building or story is provided. Note: game programming, level design (terrain/maps), game balancing (numerical values), and UI/UX design are outside the scope of this skill.

sustainability-audit

495
from revfactory/harness-100

Full audit pipeline for ESG/sustainability where an agent team collaborates to generate environmental, social, and governance assessments along with an integrated report and improvement plan. Use this skill for requests such as 'run an ESG audit', 'write a sustainability report', 'ESG assessment', 'carbon emissions calculation', 'ESG rating diagnosis', 'governance review', 'social responsibility assessment', 'GRI report', 'TCFD disclosure', 'ESG improvement plan', and other ESG/sustainability tasks. Also supports assessment of specific pillars (E/S/G) only or improving existing reports. However, actual on-site audit execution, third-party verification certificate issuance, ESG rating agency score changes, and carbon credit trading are outside the scope of this skill.

materiality-assessment

495
from revfactory/harness-100

ESG materiality assessment matrix. Referenced by the esg-reporter and improvement-planner agents when evaluating ESG issue materiality and setting priorities. Use for 'materiality assessment', 'importance analysis', or 'Materiality Matrix' requests. Stakeholder surveys and external certification are out of scope.

ghg-protocol

495
from revfactory/harness-100

GHG Protocol detailed guide. Referenced by the environmental-analyst agent when calculating and reporting greenhouse gas emissions. Use for 'GHG Protocol', 'carbon emissions', 'Scope 1/2/3', or 'carbon footprint' requests. Carbon credit trading and CDM project execution are out of scope.

citation-standards

495
from revfactory/harness-100

Academic citation and reference standards guide. Referenced by the paper-writer and submission-preparer agents when composing citations and references. Use for 'citation format', 'APA', or 'references' requests. Original paper retrieval and professional database access are out of scope.