P

How to Write a Video Script with GitHub Copilot

Writing a video script requires structure, creativity, and a good understanding of your audience. GitHub Copilot, the AI assistant integrated into your code editor, can help you with this task far beyond simple software development. By leveraging its text generation capabilities directly in VS Code, you can create complete video scripts — from the opening hook to the final call to action. This tutorial guides you step by step to turn a raw idea into a structured, ready-to-shoot video script using GitHub Copilot Chat and smart comments. Whether you produce YouTube videos, technical tutorials, or social media content, you'll discover how to leverage this tool to accelerate your creative process while maintaining editorial control over your content.

Prerequisites

  • 1.Have Visual Studio Code installed with the GitHub Copilot extension activated
  • 2.Have a GitHub Copilot subscription (Individual, Business, or Enterprise)
  • 3.Have an idea for a topic or a brief for the video to script
  • 4.Know the basics of using VS Code and Copilot Chat

Steps

1

Define the framework and brief for the video

Open a new Markdown (.md) file in VS Code. Start by setting the context of your video by writing a structured brief: topic, target audience, desired duration, tone, and main goal. This allows Copilot to have the necessary context to generate relevant suggestions throughout the process.

You are a professional video scriptwriter. I want to create a [DURATION] video on the following topic: [TOPIC]. The target audience is [AUDIENCE]. The tone should be [INFORMAL/CASUAL/PROFESSIONAL]. The goal is [GOAL]. Generate a complete brief with the key messages to convey.

Tip: The more detailed your initial brief, the more accurate and actionable Copilot's suggestions will be. Do not hesitate to mention reference videos or competitors.
2

Generate the structure and outline of the script

Use Copilot Chat to create a detailed outline of your script. Ask it to break the video into logical sections with estimated timecodes. This step is crucial because it defines the pace and narrative progression of your video. Review and adjust the outline before moving to full writing.

Based on the following brief, create a detailed video script outline with: 1) A catchy opening hook (15 seconds), 2) An introduction of the topic, 3) The main sections with estimated timecodes, 4) Transitions between each part, 5) A conclusion with a call to action. Target total duration: [X minutes].

Tip: Ask Copilot to suggest 2-3 hook variations for the opening to choose the most impactful one.
3

Write the script section by section

Go through each section of the outline and ask Copilot to write the full text. Work section by section rather than generating everything at once to maintain control over tone and consistency. Include staging cues (B-roll, graphics, transitions) in brackets directly in the script.

Write the full text for the '[SECTION_NAME]' section of my video script. The tone should be [CHOSEN_TONE]. Include visual cues in brackets [B-ROLL: ...] and natural pauses. The text should be conversational, as if speaking directly to the camera. Duration of this section: approximately [X] seconds.

Tip: Use the shortcut Ctrl+I (Cmd+I on Mac) to open Copilot inline and refine a specific passage without leaving your writing flow.
4

Optimize the script for speech and rhythm

A good video script reads smoothly aloud. Ask Copilot to adapt the text so it sounds natural when spoken: short sentences, simple vocabulary, strategic repetitions of key points. Also check timing by counting about 150 words per minute to estimate actual duration.

Rewrite this script so that it is optimized to be spoken out loud in front of a camera. Simplify long sentences, replace jargon with accessible terms, add breath markers (/), and ensure each sentence is at most 20 words. Also estimate the total duration in minutes (base: 150 words per minute).

Tip: Read your script aloud after each modification. If you stumble over a sentence, ask Copilot to rephrase it — it's the best fluidity test.
5

Finalize with metadata and supplementary elements

Complete your script with all the elements needed for production: video title, SEO-optimized description, tags, YouTube chapters with timecodes, and suggested thumbnail. Copilot can also generate formatted subtitles or a summary for social media from your finalized script.

Based on this finalized video script, generate: 1) 5 catchy, SEO-optimized YouTube title proposals, 2) A 200-word description with relevant keywords, 3) 15 relevant tags, 4) Chapters with timecodes, 5) 3 textually described thumbnail ideas, 6) A hook post for social media.

Tip: Save your final script and metadata in separate files in your project to build a reusable, version-controlled script library with Git.

Common mistakes to avoid

  • Generating the entire script in a single request, which produces generic, personality-free text — always work section by section
  • Not adapting the generated text for speech: a script written to be read and a script written to be spoken are very different in rhythm and vocabulary
  • Forgetting to provide context about the target audience, leading Copilot to produce content that is too vague or poorly calibrated in terms of technical level
  • Accepting the first suggestion without iterating: always ask for variations and combine the best elements from each proposal
  • Neglecting visual and staging cues in the script, which complicates filming and editing later

FAQ

Is GitHub Copilot suitable for writing video scripts or only code?
GitHub Copilot excels at generating structured text, not just code. By working in Markdown files and using Copilot Chat, you get an assistant that understands the context of your project and can generate quality creative content. The advantage over other tools is the direct integration into your work environment and the ability to version your scripts with Git.
What is the maximum script length Copilot can handle effectively?
Copilot works best on sections of 300 to 500 words at a time. For a long script (15-20 minute video), break your work into sections and handle them individually while keeping the overall plan as a reference. Copilot Chat retains the context of the conversation, allowing consistency between sections.
How to maintain a consistent and personal tone throughout the generated script?
Include examples of your writing style or typical phrases you use in your first prompt. You can also create a 'style-guide.md' file in your project with your tone preferences, favorite expressions, and words to avoid. Copilot will take this context into account in its suggestions. Always review and personalize each generated section.

Related tutorials

How to use this prompt

  1. Copy the prompt with the button above.
  2. Paste it into ChatGPT, Claude or your favorite AI assistant.
  3. Replace the bracketed variables with your details, then refine the result.

About Prompt Guide

Prompt Guide is a free library of 2500+ ready-to-use prompts for ChatGPT, Claude and other AIs, with guides to learn prompting and tools to build and optimize your own prompts.

More tutorials

Get new prompts every week

Join our newsletter.