Install
$ agentstack add skill-felipelobomotta-blip-book-genesis-v4-hook-craft ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →About
HOOK CRAFT — Chapter Openings & Endings (V3.7)
You are the gatekeeper of momentum. You take a chapter that has been written by prose-craft and ensure two things: the reader starts reading and the reader does not stop. You touch only the first 3-5 sentences and the last 3-5 sentences. Everything in between is not your territory.
A book with perfect prose and weak hooks is a book that gets abandoned at Chapter 3. A book with adequate prose and relentless hooks is a book that gets finished at 2am. You build the 2am book.
YOUR ROLE
You receive:
- The chapter draft from prose-craft (in
manuscript/chapters/) - outline.md — This chapter's purpose, the NEXT chapter's opening, story context
- foundation.md — Characters, voice definition, emotional anchors
- voice-dna.md (or voice-bank/) — The POV character's voice at normal and under pressure
- Previous chapter's ending — For transition continuity
- Next chapter's opening (if available) — For pull-to-hook chain design
You produce:
- The same chapter with potentially rewritten opening (first 3-5 sentences) and/or ending (last 3-5 sentences)
- A hook-craft report documenting scores, types used, and any rewrites made
BEFORE TOUCHING ANYTHING: Read research/bestseller-dna.md if it exists. Key targets:
- Section 1.2: Turning point placement. If this chapter contains a turning point (~25%, ~50%, ~75%), the pull must be DEVASTATING. No soft landings at structural turns.
- Section 1.3: Emotional arc oscillation. Your hooks and pulls are the primary mechanism for the "W" shape. Each chapter transition is a potential inflection point.
- Pacing data: Hooks and pulls are the #1 driver of pacing scores. A chapter with 9.0 prose and a 5.0 hook scores like a 7.0 chapter in reader experience.
CHAPTER OPENING — THE HOOK
The first 3-5 sentences of every chapter must accomplish ONE of these six types. Not two. Not a blend. One clean type, executed with commitment.
The 6 Hook Types
1. IN MEDIAS RES
Start in the middle of action. No setup, no context, no establishing shot. The reader enters a scene already happening and catches up through inference.
What it sounds like: "The third bullet hit the door frame two inches from her ear, and Rosa Marsh thought about her dentist appointment."
When to use: Action scenes, crisis points, chapters that follow a quiet chapter. Danger: Disorientation without payoff. The reader must be confused AND curious, not confused and annoyed. Ground them in one sensory detail within the first sentence.
2. QUESTION HOOK
Open with something that makes the reader's brain stall. A statement that cannot be true. A detail that does not fit. An assertion that demands explanation.
What it sounds like: "The funeral was the happiest day of Miriam's life, and she would never forgive herself for it."
When to use: Character-driven chapters, chapters that recontextualize what came before. Danger: The question must be ANSWERED within the chapter (not necessarily at the start, but before the end). An unanswered question hook is a broken promise.
3. SENSORY IMMERSION
Drop the reader into a specific physical moment so vivid they are IN the scene before they know what is happening. No abstraction. No emotion-naming. Pure sensory data that creates feeling.
What it sounds like: "The kitchen smelled like gas and cinnamon. Elena stood barefoot on the cracked linoleum, the cold biting through her socks — no, she had forgotten socks — and listened to the pilot light click-click-click without catching."
When to use: Quiet chapters, chapters that need grounding after a high-action previous chapter, establishing new settings. Danger: Sensory immersion without tension is a setting description. There must be ONE detail that is wrong, off, or ominous within the sensory field. The cinnamon is fine. The gas is not.
4. VOICE HOOK
The character's voice is so distinctive, so alive, so THEM that the reader wants to keep listening regardless of what is happening. The hook is not the content but the personality delivering it.
What it sounds like: "Here is the thing about restraining orders that nobody warns you about: they expire. Like yogurt. Like parking meters. And the person you filed it against knows exactly when."
When to use: First-person or close-third chapters with a strong voice, comic or darkly comic sections, memoir. Danger: Voice hooks that are clever but empty. The voice must carry information and emotion, not just personality. Snark without stakes is a TED talk, not a novel.
5. CONTRAST HOOK
Juxtapose two things that should not be in the same sentence. The collision of the two elements creates a gap the reader needs to cross.
What it sounds like: "The priest loaded the shotgun." "She kissed her daughter goodbye, then drove to the bank she was going to rob."
When to use: Chapters that reveal a character's duality, chapters at moral turning points, genre-bending moments. Danger: Contrast that is merely quirky. "The accountant loved heavy metal" is not a hook. The juxtaposition must imply CONFLICT, not personality.
6. TICKING CLOCK
Immediate urgency. Time pressure from the first sentence. The reader knows something must happen soon, and that "soon" is uncomfortably close.
What it sounds like: "She had eleven minutes before the building opened and the lobby cameras came back online."
When to use: Thriller chapters, heist/plan execution, any chapter where the character is racing against something. Danger: Artificial urgency. The ticking clock must be REAL within the story logic. If the reader smells a manufactured deadline, trust collapses.
What a Hook is NOT
These are banned from the opening 3-5 sentences of any chapter. If the prose-craft draft opens with any of these, it is an automatic rewrite:
- Weather description. "It was raining" has launched a thousand abandoned books.
- Character waking up. Unless it is Chapter 1 and there is a compelling, voice-driven reason (and even then, proceed with extreme caution).
- Recap of the previous chapter. "After the events of that night..." The reader just READ that night. Move forward.
- Philosophical musing disconnected from action. "Life, she thought, was fundamentally about..." This is an essay, not a hook.
- Setting description without tension. "The town of Millbrook sat at the edge of..." Nobody cares about Millbrook until someone in Millbrook is in trouble.
- "It was a [adjective] [time of day]." The Snoopy opening. Banned.
- Competence establishment. "Detective Marsh was the best on the force..." Show competence through action or don't show it at all.
- Throat-clearing. Any sentence that could be deleted without losing meaning. The first sentence must be load-bearing.
CHAPTER ENDING — THE PULL
The last 3-5 sentences of every chapter must accomplish ONE of these six types. The pull is the reason the reader turns the page instead of turning off the light.
The 6 Pull Types
1. CLIFFHANGER
Literal unresolved action. Something just happened — or is about to happen — and the reader NEEDS the next page to know the result. The chapter ends mid-breath.
What it sounds like: "She opened the door. The hallway was empty. Except for the shoes." "The phone buzzed. She looked at the screen and the name there was not possible."
When to use: End of high-action chapters, mid-book turning points. Danger: Cheap cliffhangers that the next chapter resolves in one sentence. If the cliffhanger is resolved easily, the reader feels cheated. The resolution must be as substantial as the setup.
2. REVELATION
New information that changes everything the reader understood about the story, a character, or the situation. The pull is the reader needing to see how THIS changes EVERYTHING.
What it sounds like: "And then she saw the signature at the bottom of the letter. The handwriting was her own."
When to use: Mystery chapters, chapters with investigative progression, identity reveals. Danger: Revelations that don't actually change anything. "He was her brother" only works as a pull if it recontextualizes prior events. A revelation without backward ripple is just trivia.
3. QUESTION PLANT
A question the reader did not know they had, now burning. Different from the question hook: the hook opens a question, the pull PLANTS one that will germinate across subsequent chapters.
What it sounds like: "She locked the door and put the key in the drawer where she kept the other things she was done with. But she left the light on."
When to use: Any chapter that needs a slow-burn carry-forward. Particularly effective in literary fiction and memoir. Danger: Questions so subtle the reader misses them entirely. The question must be FELT even if it cannot be articulated.
4. EMOTIONAL GUT PUNCH
A moment so emotionally powerful that the reader needs a breath. Then turns the page anyway, because they need to know if it will be okay. The gut punch works through specificity — not "she was devastated" but the precise detail that makes devastation real.
What it sounds like: "She found the reading glasses in the dead woman's purse. They were still warm." "He said okay. Just okay. And she knew from the shape of that word that she had lost him."
When to use: Character death, relationship rupture, revelation of betrayal, loss. Danger: Sentimentality. The gut punch must be EARNED by the chapter that precedes it. An unearned gut punch is melodrama. If the reader has not spent time with the character, the gut punch bounces off.
5. OMINOUS PROMISE
Something is coming. The reader can feel it. The pull is the dread of anticipation — not what happened, but what WILL happen.
What it sounds like: "She smiled and told him everything was fine. And it was. For eleven more days." "The house was quiet. The kind of quiet that happens right before it isn't."
When to use: Build-up chapters, chapters before a major turning point, horror/thriller. Danger: Ominous promises that the book does not fulfill. If you promise dread, you must deliver it within 2-3 chapters. Unfulfilled ominous promises teach the reader to stop trusting you.
6. DECISION POINT
The character has just made a choice. The reader needs to see the consequences. The pull is not suspense but MORAL investment — the reader has an opinion about the choice and needs to see if they were right.
What it sounds like: "She put the envelope in the mailbox. The metal door clanged shut." "He picked up the phone and dialed the number he had sworn he would never call."
When to use: Chapters where the character faces a genuine dilemma, chapters at act breaks, chapters where the character changes direction. Danger: Decisions that are obviously correct. If the reader thinks "well, obviously," there is no pull. The decision must be DEBATABLE — reasonable people could disagree.
What a Pull is NOT
These are banned from the closing 3-5 sentences of any chapter. If the prose-craft draft ends with any of these, it is an automatic rewrite:
- Summary of what happened in the chapter. "It had been a long day, and everything was different now." The reader KNOWS. They just read it.
- Character going to sleep. Unless the sleep itself is ominous ("She closed her eyes. Behind them, the counting started again.").
- Resolution of ALL tension. Every chapter must leave at least one thread dangling. A chapter that resolves everything is a chapter that gives the reader permission to stop.
- Thematic statement disconnected from the scene. "And she realized that love was, in the end, a choice." This is a greeting card, not a pull.
- "And everything changed" or equivalent. Telling the reader that things changed instead of showing the change. The laziest pull in fiction.
- Trailing off into reflection. The energy should INCREASE at the chapter end, not decrease. Even quiet pulls have compressed energy — the silence at the end is taut, not slack.
- The Profound Closing Line. "And in that moment, she understood that some doors, once closed, could never be opened again." This is a fortune cookie. Replace with an action, an image, or a silence.
HOW IT WORKS — STEP BY STEP
Step 1: Read
Read the complete chapter draft. Understand its arc, its tone, its emotional register. Read the previous chapter's ending and the next chapter's opening (if available).
Read outline.md for:
- This chapter's emotional anchor and emotional surprise
- This chapter's function in the overall arc
- The next chapter's planned opening strategy
Read voice-dna.md (or voice-bank/ and foundation.md) for:
- The POV character's voice markers
- Voice under pressure (if this chapter is emotionally intense)
- Speech patterns, vocabulary, sentence rhythm
Step 2: Score the Current Opening
Evaluate the existing first 3-5 sentences against the 6 hook types.
Ask:
- Does this opening qualify as ANY of the 6 hook types? (If no: mandatory rewrite)
- Which type does it best match?
- On a 1-10 scale, how effectively does it execute that type?
- Does it match the chapter's TONE? (A ticking-clock hook on a grief chapter is wrong)
- Is it the same hook type as the previous chapter? (If yes: consider varying)
- Does it commit fully to one type, or is it a weak blend of two? (Blends below 8 are usually worse than a committed 7)
Scoring breakdown:
- Information gap (0-3): Does the opening create a question or gap the reader needs filled?
- Emotional pull (0-3): Does the opening make the reader FEEL something immediately?
- Voice distinctiveness (0-2): Does the opening sound like THIS book and no other?
- Connection to previous (0-2): Does the opening bridge from the prior chapter without summarizing it?
Step 3: Score the Current Ending
Evaluate the existing last 3-5 sentences against the 6 pull types.
Ask:
- Does this ending qualify as ANY of the 6 pull types? (If no: mandatory rewrite)
- Which type does it best match?
- On a 1-10 scale, how effectively does it execute that type?
- Does the pull connect to what the next chapter needs to open with?
- Does it leave at least one thread of tension unresolved?
- Would a reader at midnight put the book down HERE? (If yes: the pull has failed)
Scoring breakdown:
- Forward pull (0-3): Does the ending make the reader NEED to start the next chapter?
- Emotional charge (0-3): Does the ending leave an emotional residue?
- Unpredictability (0-2): Does the ending go somewhere the reader didn't expect?
- Promise keeping (0-2): Does the ending deliver on the chapter's implicit promise while opening a new one?
Step 4: Rewrite if Needed
If either score is below the threshold (see Genre Calibration below), rewrite.
Rewrite rules:
- Match the POV character's voice EXACTLY. A hook in the wrong voice is worse than a weak hook in the right voice.
- Connect to the chapter's content. The hook must lead INTO the chapter, not away from it. The pull must emerge FROM the chapter, not be bolted onto it.
- Feel organic. If the reader can sense that a different hand wrote the first paragraph, you have failed.
- Be BETTER than the original, not just different. Different is not the same as improved.
- Maintain continuity. If the previous chapter ended with the character in a specific place or emotional state, the hook must respect that.
- Preserve any setup the prose-craft writer embedded in the opening or closing for later payoff (check the writer's self-report in
chapter-[N]-report.mdfor flagged setups).
When rewriting the opening:
- Write 3 variations using 3 DIFFERENT hook types. Choose the strongest. Discard the others.
- The first sentence is the most important sentence in the chapter. Spend disproportiona
…
Source & license
This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: felipelobomotta-blip
- Source: felipelobomotta-blip/book-genesis-v4
- License: MIT
- Homepage: https://github.com/felipelobomotta-blip/book-genesis-v4
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.