dbs-script-flow — Logic Continuity Check
Version: v1.1
Use Case: Check paragraph coherence, information density, and spoken fluency of short video scripts to identify risk points where viewers might swipe away
Trigger Conditions
When the user:
- Says "Check logic continuity", "Check if the logic is broken", "Is there any redundant content"
- Says "Help me check if this script flows smoothly", "Can viewers watch this script all the way through"
- Says "Check completion rate risks", "Where will viewers swipe away"
- Uses or
Differences from Other Skills
| Skill | What it checks | Analogy |
|---|
| Macro structure: Whether there is an opening, climax, and conclusion | Check if the house is missing any floors |
| Micro coherence: Whether the transition between each paragraph is smooth | Check if the stairs on each floor are broken |
| Overall optimization report + title proposals | Conduct a full physical examination of the house |
Core Principles
The enemy of completion rate is not poor content, but a moment when viewers can't keep up.
Viewers swipe away for only three reasons:
- Logical break: The previous paragraph talks about A, the next suddenly jumps to C, missing B in between
- Dropped information density: A paragraph repeats what has already been said, or goes in circles
- Awkward spoken delivery: Sentences are too long, too formal, use rhetorical questions repeatedly, or are hard to pronounce
Check Process
Step 1: Segment the Script
Divide the script into segments based on natural paragraph breaks (topic switching points), and label each segment with:
- Segment number
- Paragraph topic (one-sentence summary of what the segment is about)
- Paragraph function (Opening / Background setup / Argumentation / Case study / Transition / Climax / Conclusion)
Step 2: Scan Each Segment Across Three Dimensions
For each segment, check in order:
Dimension 1: Logical Coherence (Between Segments)
Ask yourself:
- Is there a logical jump between the last sentence of the previous segment and the first sentence of this segment?
- After listening to the previous segment, can viewers naturally understand why this segment is being discussed?
- If not, what connecting information is missing?
Common Issues:
- Sudden jump from a case to macro analysis without a transition sentence
- Sudden jump from explaining causes to another topic without wrapping up the previous one
- Jump from data to opinion without a "therefore" to connect them
Fixes:
- Add a transition sentence (usually one sentence is enough)
- Add a concluding sentence at the end of the previous segment
- Adjust the order of segments
Dimension 2: Information Density (Within Segments)
Ask yourself:
- Does this segment repeat information that has already been mentioned?
- Does this segment go in circles (using 5 sentences to say what could be said in 1)?
- If this segment is deleted, will viewers miss key information?
Common Issues:
- Repeating the same meaning in three different ways
- Giving too many examples when explaining a concept, even after viewers already understand
- A segment is "correct nonsense" — it says nothing meaningful
Fixes:
- Delete redundant expressions, keep only the most impactful one
- Merge redundant segments
- Mark as "Can be deleted" for the user to decide
Dimension 3: Spoken Fluency (Sentence Level)
Ask yourself:
- Can this sentence be spoken in one breath? (Single sentences over 30 words should be cautious)
- Does it use formal written language? (e.g., "Regarding", "In view of", "Based on the above analysis")
- Does it use repeated rhetorical questions? (e.g., "Do you think X? Actually Y" — acceptable occasionally, annoying if used continuously)
- Does it use self-created concepts? (Terms viewers don't understand without immediate explanation)
Common Issues:
- Nested attributives, cramming too much information into one sentence
- Using a term without immediately explaining it
- Continuous short sentences with a choppy rhythm, or continuous long sentences with a dull rhythm
Fixes:
- Split long sentences into two
- Follow a term with a plain-language explanation
- Adjust the rhythm by alternating short and long sentences
Step 3: Label Risk Levels
Label each identified issue with a risk level:
| Level | Meaning | Explanation |
|---|
| 🔴 High Risk | Viewers will most likely swipe away here | Logical break, significant drop in information density |
| 🟡 Medium Risk | Viewers may get distracted but not necessarily swipe away | Slightly awkward transition, minor redundancy |
| 🟢 Minor Suggestion | Better to fix, but okay if not | Minor spoken adjustments, word choice optimization |
Output Format
## Logic Continuity Check Report
### Paragraph Structure
| Segment No. | Topic | Function | Status |
|-------------|-------|----------|--------|
| 1 | [Topic] | Opening | ✅ |
| 2 | [Topic] | Background setup | ✅ |
| 3 | [Topic] | Argumentation | 🟡 |
| ... | ... | ... | ... |
### Issue List
**🔴 Issue 1: Segment X → Segment Y, Logical Break**
> Original text (end of Segment X): "……"
> Original text (start of Segment Y): "……"
**Problem**: [Specific description of why viewers can't keep up here]
**Fix Suggestion**: Add a transition sentence at the end of Segment X:
> "[Specific transition sentence]"
---
**🟡 Issue 2: Segment Z, Dropped Information Density**
> Original text: "……"
**Problem**: [Specific description of why viewers may get distracted here]
**Fix Suggestion**:
> Revised to: "[Simplified text]"
---
**🟢 Issue 3: Sentence N in Segment W, Awkward Spoken Delivery**
> Original text: "……"
**Problem**: [Specific description of why this sentence is hard to pronounce]
**Fix Suggestion**:
> Revised to: "[Rewritten sentence]"
---
### Overall Assessment
- **Logical Coherence**: [One-sentence summary]
- **Information Density**: [One-sentence summary]
- **Spoken Fluency**: [One-sentence summary]
- **Summary**: [Overall judgment, number of fixes needed, whether it's ready to publish after fixes]
### Ask for Revision Confirmation
After outputting the overall assessment, you must proactively ask the user:
> Would you like me to provide marked-up revisions? I'll keep your original text and mark changes with strikethrough and 🆕 emoji.
**Do not wait for the user to ask** — most users check the script to get revisions, so asking proactively saves back-and-forth.
But **do not revise without asking** — leave the decision to the user, as they may want to revise it themselves.
Marked-Up Revision Process (Execute After User Confirmation)
When the user replies "Revise", "Help me revise", "Just revise it", "Revise the original text", start the marked-up revision process.
Core Principles
Never erase the user's original text. Revisions are marked on top of the original text, not replaced with a new version. The user must be able to clearly see:
- What they wrote
- Which parts are AI's deletion/replacement suggestions
- Which parts are AI's added content
- Which parts were previously revised by AI and restored (avoid losing history in multi-round feedback)
Three Markers (High Visual Contrast)
| Symbol | Purpose | Example |
|---|
| Mark original text suggested for deletion or replacement | ~~The key point is, let's emphasize here~~
|
| 🆕 | Mark added/revised content | |
| ⚠️ | Mark AI's retracted judgment and restored original text | ⚠️ The previous deletion judgment was wrong, restored. These three segments are not off-topic, but are breaking down……
|
Revision Rules
- Make changes directly in the original position — do not write a full new version at the bottom; mark in place
- Pair each change — is immediately followed by 🆕 revised version, making the comparison clear
- When deleting an entire segment: Keep the original segment with strikethrough, and use 🆕 below to explain why it's deleted (or provide a condensed alternative)
- Provide a change list at the end — in table form, list the location, type, and reason for each change, allowing the user to review quickly
- Append instead of overwriting in multi-round feedback — if the user points out a wrong revision, mark it as restored with ⚠️ instead of directly changing it back as if it never happened
Output Format After Revision
[Original text + marked-up changes, edited in place]
---
### Change List
| Location | Type | Explanation |
|----------|------|-------------|
| Opening | 🟢 Replacement | [Brief explanation] |
| Segment X | 🔴 Full deletion | [Reason] |
| Ending | 🟡 Addition | [What was added and why] |
Add a final decision sentence (which changes are mandatory, which are optional) to let the user know priorities.
Notes
- Do not modify content views: This skill only cares about "how to say it", not "what to say". Do not modify the user's arguments, cases, or data
- Fix suggestions must be conversational: The provided transition sentences and revisions must be directly speakable, not formal written language
- Do not over-diagnose: If the script is overall smooth, say "No major issues" instead of forcing to find problems
- Prioritize high-risk issues: It's better to miss a minor suggestion than to bury high-risk issues in a pile of minor ones
- Maintain the user's tone: When revising, keep the user's speaking style, do not make the user's text sound "AI-like"
- Provide specific locations: Each issue must quote the original text so the user can find it at a glance
- Confirm filming method before revising: Whiteboard videos change the judgment criteria — parallel lists are a visual advantage, phrases like "Emphasize here" "Look here" are prompts matching on-board actions and should not be revised. If the user doesn't specify, ask "Is this a whiteboard video or pure spoken delivery?"
- Ask before judging "off-topic": If this segment is deleted, can viewers infer the specific meaning on their own from the previous key point? If not, this segment is necessary supporting content, not redundant. Do not only look at "whether the topic is literally off", but "which argument this segment serves"
Practical Cases
Case: "Xiaohongshu Sued" Script (2026-04-09)
🟡 Issue 1: Line 46, Segment 5, Awkward Spoken Delivery
Original text: "You will enter another similar zone called the merchant traffic pool"
Problem: The repeated "another" and "similar" make it awkward to pronounce. Also, "merchant traffic pool" is a term viewers may not understand.
Fix Suggestion:
Revised to: "You'll have almost no traffic — not completely zero, but it will be very low"
Directly state the result instead of introducing a concept.
🟡 Issue 2: Segment 7 → Segment 8, Missing Transition
Original text (end of Segment 7): "So next, you're violating the platform's引流 rules, and the platform bans your account."
Original text (start of Segment 8): "Then something more interesting happens"
Problem: Jumping directly from "lawyer banned" to "courtroom speech" without wrapping up. Viewers are still digesting the "lawyer banned" information when suddenly pulled to the courtroom.
Fix Suggestion: Revise the end of Segment 7 to:
"So this lawyer's subsequent traffic restriction is actually the standard outcome of this process."
"Standard outcome" wraps up the previous analysis before introducing new information.
Version History
- v1.0 (2026-04-09): Initial version, based on practical experience with the "Xiaohongshu Sued" script
- v1.1 (2026-05-04): Added marked-up revision process; proactively ask "Would you like marked-up revisions?" after diagnosis; added 2 notes (whiteboard video judgment criteria, check argument service before judging off-topic)