docs(blocks): improve video block descriptions and regenerate docs

Better "What it is" descriptions so the generated docs are
self-explanatory without a separate "What it does" section.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

autogpt_platform/backend/backend/blocks/video/edit_by_text.py

@@ -58,7 +58,7 @@ class EditVideoByTextBlock(Block):
     def __init__(self):
         super().__init__(
             id="98d40049-a1de-465f-bba1-47411298ad1a",
-            description="Edit a video by modifying its transcript",
+            description="Edit a video by modifying its transcript — segments you remove from the transcript are cut from the output video",
             categories={BlockCategory.MULTIMEDIA},
             input_schema=self.Input,
             output_schema=self.Output,

autogpt_platform/backend/backend/blocks/video/transcribe.py

@@ -47,7 +47,7 @@ class TranscribeVideoBlock(Block):
     def __init__(self):
         super().__init__(
             id="fa49dad0-a5fc-441c-ba04-2ac206e392d8",
-            description="Transcribe speech from a video file to text",
+            description="Extract spoken words from a video and return them as a text transcription",
             categories={BlockCategory.MULTIMEDIA},
             input_schema=self.Input,
             output_schema=self.Output,

docs/integrations/README.md

@@ -492,10 +492,10 @@ Below is a comprehensive list of all available blocks, categorized by their prim
 | Block Name | Description |
 |------------|-------------|
 | [Add Audio To Video](block-integrations/video/add_audio.md#add-audio-to-video) | Block to attach an audio file to a video file using moviepy |
-| [Edit Video By Text](block-integrations/video/edit_by_text.md#edit-video-by-text) | Edit a video by modifying its transcript |
+| [Edit Video By Text](block-integrations/video/edit_by_text.md#edit-video-by-text) | Edit a video by modifying its transcript — segments you remove from the transcript are cut from the output video |
 | [Loop Video](block-integrations/video/loop.md#loop-video) | Block to loop a video to a given duration or number of repeats |
 | [Media Duration](block-integrations/video/duration.md#media-duration) | Block to get the duration of a media file |
-| [Transcribe Video](block-integrations/video/transcribe.md#transcribe-video) | Transcribe speech from a video file to text |
+| [Transcribe Video](block-integrations/video/transcribe.md#transcribe-video) | Extract spoken words from a video and return them as a text transcription |
 | [Video Clip](block-integrations/video/clip.md#video-clip) | Extract a time segment from a video |
 | [Video Concat](block-integrations/video/concat.md#video-concat) | Merge multiple video clips into one continuous video |
 | [Video Download](block-integrations/video/download.md#video-download) | Download video from URL (YouTube, Vimeo, news sites, direct links) |

docs/integrations/block-integrations/video/edit_by_text.md

@@ -6,10 +6,7 @@ This block edits a video by modifying its transcript — segments absent from th
 ## Edit Video By Text
 
 ### What it is
-Edit a video by modifying its transcript
-
-### What it does
-Takes a video and a modified version of its transcript, then produces a new video with only the segments that match the provided transcript. Any spoken segments you remove from the transcript will be cut from the output video.
+Edit a video by modifying its transcript — segments you remove from the transcript are cut from the output video
 
 ### How it works
 <!-- MANUAL: how_it_works -->
@@ -22,7 +19,7 @@ The block sends the input video and the desired transcript to the Replicate API
 |-------|-------------|------|----------|
 | video_in | Input video file to edit (URL, data URI, or local path) | str (file) | Yes |
 | transcription | Modified transcript of the input video — segments absent from this text will be cut from the output video | str | Yes |
-| split_at | Alignment granularity for transcript matching: `word` aligns cuts at word boundaries (default), `character` allows finer sub-word alignment | "word" \| "character" | No (default: `word`) |
+| split_at | Alignment granularity for transcript matching: 'word' aligns cuts at word boundaries, 'character' allows finer sub-word alignment | "word" \| "character" | No |
 
 ### Outputs
 

docs/integrations/block-integrations/video/transcribe.md

@@ -6,10 +6,7 @@ This block transcribes speech from a video file to text using the Replicate API.
 ## Transcribe Video
 
 ### What it is
-Transcribe speech from a video file to text
-
-### What it does
-Extracts spoken words from a video and returns them as a text transcription. The block accepts video input as a URL, data URI, or local path and outputs the full transcript as a string.
+Extract spoken words from a video and return them as a text transcription
 
 ### How it works
 <!-- MANUAL: how_it_works -->