mockumentary-revision

Mockumentary Revision & Polish

Safety Notice

This listing is imported from skills.sh public index metadata. Review upstream SKILL.md and repository scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "mockumentary-revision" with this command: npx skills add joelborellis/screenplay-mockumentary/joelborellis-screenplay-mockumentary-mockumentary-revision

Mockumentary Revision & Polish

Refine mockumentary screenplays for comedy, authenticity, and consistency.

Revision Pass Order

Complete these passes in sequence. Each addresses different issues.

Pass 1: Documentary Authenticity Check

Does this feel like a real documentary?

Check for:

  • Consistent camera logic (who's filming? why?)

  • Believable interview setups

  • Appropriate verite moments (not too staged)

  • B-roll that a real documentary would have

  • Characters who behave like real people being filmed

Red flags:

  • Scenes where camera presence is convenient but unexplained

  • Talking heads that feel like exposition dumps

  • Too-perfect timing that breaks documentary illusion

  • Characters who forget they're being filmed when plot requires

Pass 2: Earnestness Audit

Do characters take themselves seriously?

The cardinal sin of mockumentary: characters who seem to know they're funny.

Check each character:

  • Do they believe in what they're doing?

  • Are they trying to look good for the camera?

  • Is their self-image consistent?

  • Do they rationalize their failures?

Red flags:

  • Winking at the audience

  • Self-deprecating humor (mockumentary characters don't mock themselves)

  • Characters acknowledging the absurdity of their world

  • Punchlines that require breaking character

Pass 3: Gap Consistency

Is the gap between self-image and reality consistent for each character?

For each major character, trace their arc:

  • Same blind spot throughout?

  • Do moments of clarity feel earned?

  • Does the gap create consistent comic opportunities?

Red flags:

  • Character suddenly aware of something they're defined by not seeing

  • Gap that changes based on scene needs

  • Moments of insight with no setup

Pass 4: Talking Head Function

Does every talking head earn its place?

Each interview should:

  • Reveal character (not just information)

  • Show gap between self-image and reality

  • React to/reframe what we just saw

  • Set up what we're about to see

  • Provide comic contrast

Cut if talking head:

  • States what we just watched

  • Provides exposition that could be shown

  • Doesn't reveal character

  • Breaks comic rhythm

Pass 5: Comedy Punch-Up

Is each comic moment landing?

Mockumentary comedy tools:

  • The beat: Pause that lets absurdity land

  • The look: Character glances at camera

  • The contradiction: Interview vs. reality

  • The understatement: Huge thing described casually

  • The overshare: TMI to camera

  • The commitment: Character doubles down when they should quit

For each intended laugh:

  • Is the setup clear?

  • Is the payoff specific enough?

  • Is there enough space for it to land?

  • Could it be shorter/punchier?

Pass 6: Pacing and Rhythm

Does the comedy breathe?

Check:

  • Variety of scene lengths

  • Talking heads not bunched together

  • Verite scenes have room to develop

  • Big laughs have setup time

  • Small laughs keep momentum

The Three-Scene Test: Read any three consecutive scenes aloud. Do they have different rhythms?

Pass 7: Dialogue Polish

Does each character have a distinct voice?

Read only one character's lines through the entire script:

  • Consistent vocabulary?

  • Recognizable speech patterns?

  • Interview voice different from scene voice?

  • Could you identify who's speaking without the character name?

Dialogue tightening:

  • Cut words that don't add meaning

  • Find the funniest word (not the first word you thought of)

  • Let interrupted dialogue stay interrupted

Common Mockumentary Problems

"Too Written" Dialogue

Problem: Dialogue sounds like scripted comedy, not documentary footage.

Fix: Add imperfection. Real people:

  • Start sentences, abandon them, restart

  • Use filler words (um, like, you know)

  • Repeat themselves

  • Get interrupted

Missing Camera Logic

Problem: How is the camera getting this shot?

Fix: Either justify camera presence or acknowledge the documentary is reconstructed/has access.

Unearned Sweetness

Problem: Characters become sincere/warm in ways that don't fit.

Fix: Earn emotional moments through character consistency, not sudden changes. Sweetness works in mockumentary when it comes from the same place as the comedy—the character's genuine (if misguided) heart.

Satire Without Specificity

Problem: General mockery rather than precise observation.

Fix: Make satire specific. Not "corporate culture is silly" but "the specific way this company does motivational posters reveals their dysfunction."

Revision Notes Format

When revising based on notes, track changes in: dev/revisions/

Create files like:

  • dev/revisions/v2-notes.md

  • dev/revisions/v3-punch-up.md

Include:

  • What was changed

  • Why

  • What to watch in next pass

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

General

mockumentary-screenplay

No summary provided by upstream source.

Repository SourceNeeds Review
General

mockumentary-structure

No summary provided by upstream source.

Repository SourceNeeds Review
General

mockumentary-concept

No summary provided by upstream source.

Repository SourceNeeds Review
General

mockumentary-characters

No summary provided by upstream source.

Repository SourceNeeds Review