agentleFS
Jawad-OfficialJawad-Official/writing-toolkit-skills/skills/script-writer/SKILL.md

script-writer

Skill1 starsChanged 34 days agoMITView on GitHub

Use for anything spoken aloud (video scripts, YouTube or Reels, lectures with speaker notes, workshops and facilitator guides, talks, presentations). Asks for a text style, then writes for the ear with timing, cues, and formats.

2 other projects use a version of this.

Adopted by

Most recently taken up by

  • Other versions2 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 2

    1. kambleakash0/agent-skills★ 10same name
    2. DRAZY/claude-skills★ 1same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

  • In this repository3 other files it gives its agents.

The file

We split this skill into the rules it gives an agent

12 rules. About 0 are common, 10 are distinctive, and 2 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈10

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Write scripts for things the user will say out loud: videos, lectures, workshops, talks, and presentations.

    line 8
  2. Distinctive:

    If the writing-core skill is available, load it first.

    line 14
  3. Very specific:

    Never invent data, stories, or experiences.

    line 19
  4. Distinctive:

    Write in the text style he picked (Step 0.5).

    line 20
  5. Distinctive:

    No style changes the rules: nothing invented, markers for gaps, no em dashes, no moral endings.

    line 59
  6. Distinctive:

    Ask only for what is missing, in one message, at most 3 questions:

    line 63
  7. Distinctive:

    No reading-only devices: No parentheses, footnotes, "the former and the latter", or "as mentioned above".

    line 76
  8. Distinctive:

    Read-aloud test: If a sentence needs a breath in the middle, split it.

    line 79
  9. Distinctive:

    If he wants the slides built, use the Slides artifact type or the pptx skill.

    line 126
  10. Distinctive:

    Contingency: keep a buffer of about 10 to 15% of total time.

    line 138
  11. Very specific:

    Code in workshops: never include code that has not been run.

    line 143
  12. Distinctive:

    Put the full narration on slides.

    line 156

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Script Writer

Write scripts for things the user will say out loud: videos, lectures, workshops, talks, and presentations. He provides the topic, goal, and his own material. Claude writes the script, he rehearses it and delivers it.

Three modes share one set of spoken-word rules: Video, Lecture, Workshop. A talk or presentation uses Lecture mode without the learning-outcome parts, unless it is teaching something.

Step 0: Load the core rules

If the writing-core skill is available, load it first. It holds the shared rules (his inputs first, avoiding generic AI defaults, never inventing, markers, voice, self-check). If it is not available, follow this summary:

  • Name specifics: numbers, tools, examples, sources.
  • Include real failures, trade-offs, and open questions from his material.
  • Plain literal language. No decoration, no em dashes, no filler words like delve, landscape, pivotal, crucial.
  • Never invent data, stories, or experiences. Use markers: [YOUR INPUT: ...], [VERIFY: ...], [FIGURE: ...], [CITE: ...].
  • Write in the text style he picked (Step 0.5).
  • Take a position. End on a concrete point or next step, not a moral.

How spoken text changes the core rules

Listeners cannot re-read, so some core rules change for scripts. These changes come from general practice in speaking and teaching, not from the StoryScope paper behind the core rules.

Core ruleFor spoken scripts
State each point oncePreview, explain, then recap the key point at the end of a segment. Recap facts and steps, never morals or lessons.
Plain literal languageStill plain. Concrete examples and visuals help a lot. Ornamental metaphors still do not.
Name specificsStill name them. Round numbers when spoken ("about 40 percent") and show the exact value on screen or slide.
Varied sentence lengthMostly short sentences. One idea per sentence.

Step 0.5: Ask for the text style

At the start of every new task, ask which text style he wants. Show all 12 styles as a numbered list in the same message as the intake questions, and mark the recommended ones. He can pick one number or combine two (for example "2 + 4"). The style question does not count toward the 3-question intake limit.

Recommended for this skill: 5 Conversational for videos and short-form. 9 Teaching for lectures and workshops. 10 Storytelling for talks and video hooks. For spoken text, styles 2 and 7 are shown but not recommended, because they read stiffly out loud.

Skip the question when he already named a style or tone, when he says "same style" or "you choose", or when the session runs unattended. Then use the closest style, or the first recommended one, and say which in one short line. Follow-up edits on the same piece keep the chosen style. If he skips the question, use the first recommended style and do not ask again for that task.

The full definitions are in writing-core (Rule 0). If it is not loaded, use this list exactly:

1. Plain and clear: common words, short to medium sentences. The default.
2. Formal academic: impersonal, no contractions, precise hedging.
3. Professional: direct and polite, answer first.
4. Technical: exact terms, versions, units, and names.
5. Conversational: friendly, contractions, speaks to "you".
6. Persuasive: claim, evidence, objection answered, clear ask.
7. Concise executive: shortest form, numbers and decisions first.
8. Reflective personal: first person, named feelings, what he learned.
9. Teaching: step by step, terms defined, example before the rule.
10. Storytelling: hook, his real story, tension, payoff.
11. Simple English: very common words, no idioms, for non-native readers.
12. Match my writing: mirrors a sample he pastes.

No style changes the rules: nothing invented, markers for gaps, no em dashes, no moral endings. Storytelling and Reflective use only his real stories and feelings.

Step 1: Intake

Ask only for what is missing, in one message, at most 3 questions:

  1. Mode, platform, and length. Video (YouTube long-form, Reels, TikTok, or Shorts), lecture, workshop, or talk; in person or online; target duration.
  2. Audience. Who they are, what they already know, how many people.
  3. His material. Notes, slides, code, data, and especially his own examples and experiences. These are what make the script his and not the generic version every AI produces for the same topic. Ask for at least one real example or story. Never invent one.

Also note the goal: what the audience should know, do, or feel after.

Spoken-word rules (all modes)

  • Write for the ear. One idea per sentence. Most sentences under 20 words. Active voice. Contractions are fine.
  • Same term every time. Listeners hear a new word as a new thing, so do not rotate synonyms.
  • Signpost. Say the structure out loud: "There are two reasons. First... Second..." Mark transitions: "Now the important part."
  • No reading-only devices. No parentheses, footnotes, "the former and the latter", or "as mentioned above".
  • Numbers. At most one or two per sentence. Round when spoken unless precision matters.
  • Abbreviations. Say the full term on first use. Add pronunciation for unusual names or terms in brackets for him only, for example [say: "kai-square"].
  • Read-aloud test. If a sentence needs a breath in the middle, split it.
  • Visual and verbal split. Slides and on-screen text hold keywords, visuals, and code. The script holds the explanation. Do not put the narration on the slide: people learn better from visuals plus narration than from visuals, narration, and the same text on screen (Mayer's redundancy principle).
  • Timing. Plan about 130 to 150 spoken words per minute for lectures, workshops, and talks, and about 150 to 160 for video narration. Give a word count and estimated duration for each segment and the total. Tell him to time one read-aloud, since his real pace decides.

Mode A: Video

Structure

  1. Hook (first 5 to 10 seconds): the problem, the result, or the question. No "Hi guys, welcome back" and no long intro before the value.
  2. Promise: what the viewer gets by the end, in one sentence.
  3. Beats: one idea per beat, each with a visual change (screen recording, B-roll, zoom, on-screen text, cut).
  4. Payoff: deliver the promise. Show the result.
  5. Close: one next step or call to action, only if he wants one.

Short-form (under about 90 seconds): one idea only. The hook is the first line. Cut every setup sentence that does not pay off.

Ask whether it is talking head, voiceover with screen recording, or mixed, because that changes the visual cues.

Format

SCENE 1  |  0:00 to 0:08  |  ~20 words
VISUAL: what is on screen
ON-SCREEN TEXT: short text overlay, if any
NARRATION: what he says

Offer a narration-only teleprompter version on request.

Mode B: Lecture (and talks)

Plan

  • Learning outcomes: 2 to 4, with measurable verbs (explain, compute, compare, implement, debug). Not "understand".
  • Opening: a problem, question, or surprising result tied to the outcomes. Agenda after the hook, not before.
  • Segments: split the lecture by content, with a short interaction between segments: a question, a poll, a predict-the-output task, or a quick pair discussion. Active learning improves results over pure lecturing (Freeman et al., 2014, PNAS meta-analysis). The popular "10-minute attention span" rule has weak evidence, so break by content, not by a fixed timer.
  • Inside each segment: worked example before practice, and one common misconception named and corrected.
  • Close: recap the key points as facts or steps, one exit question, and what comes next.

Format

SEGMENT 2  |  12:00 to 22:00  |  Outcome 1  |  ~1,300 words
SLIDE TITLE: ...
SLIDE CONTENT: keywords, visual, or code (max about 6 short lines)
SPEAKER NOTES: the script he says
CHECK: question to the audience / expected answer

If he wants the slides built, use the Slides artifact type or the pptx skill. This skill writes the content and speaker notes.

Mode C: Workshop

Plan backward: outcomes first, then the final task participants complete, then the activities that build up to it. Participants should spend more time doing than listening: short demos (about 5 to 10 minutes) followed by practice.

Facilitator guide sections

  1. Overview: title, audience, prerequisites, outcomes, duration, group size.
  2. Setup and materials: links, datasets, tools, room or online setup. For coding workshops: a tested starter repo or notebook, an environment check as the first activity, and a solutions file.
  3. Agenda: time, block name, activity, and expected output for each block.
  4. Each block: purpose, what the facilitator says (script), participant instructions as numbered steps, expected output, common errors and fixes, and timing.
  5. Debrief: 3 to 5 questions that connect the activity back to the outcomes.
  6. Contingency: keep a buffer of about 10 to 15% of total time. Say what to cut if running behind, and give an extension task for fast participants.
  7. Follow-up: resources and a feedback question or form.

Offer a separate participant handout with only the steps and links.

Code in workshops: never include code that has not been run. Run it with the code tools when available. Otherwise mark it [VERIFY: run this before the workshop].

Output format

  • Script blocks in fenced text code blocks so the copy button gives clean text. No markdown inside.
  • Each segment or scene shows its word count and estimated duration. Show the total at the end.
  • Rehearsal notes (2 to 4 bullets): lines worth practicing, where to slow down, where to pause for questions, and which [YOUR INPUT] stories to prepare.
  • Long guides or full lecture scripts: offer a .docx built with the docx skill.

Never do these

  • Invent his stories, experiences, or results.
  • Invent statistics to make a hook sound stronger.
  • Put the full narration on slides.
  • Claim a duration without a word-count basis.
  • Ship workshop code that has not been run.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.