Agent skill

First Chapter Hook

by Ckokoski in Ckokoski/AuthorAgent

Analyze and rewrite first chapters for maximum reader retention using genre-specific hook patterns

MITAuto-check passedMedia & Creative

Install First Chapter Hook

skills CLI
$ npx skills add Ckokoski/AuthorAgent --skill first-chapter-hook -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Ckokoski/AuthorAgent first-chapter-hook --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Ckokoski/AuthorAgent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/_archived/premium/first-chapter-hook .claude/skills/first-chapter-hook && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
first-chapter-hook
GitHub stars
123
Token cost
~1.3k tokens
SKILL.md length
374 words
Files
1
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

Analyze and rewrite first chapters for maximum reader retention using genre-specific hook patterns

  • Works in 4 steps: Does your opening match what readers of… → Where do you conform vs. subvert genre… → Comp title comparison (how do… → …
  • Media & Creative work in your project
  • SKILL.md covers Hook Score Analysis, Genre Hook Templates, Opening Line Workshop and Look Inside Optimizer, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

First Chapter Hook is an agent skill from Ckokoski/AuthorAgent. Analyze and rewrite first chapters for maximum reader retention using genre-specific hook patterns

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative. The repository describes itself as: The Autonomous AI Writing Agent — a secure, author-focused AI for fiction and nonfiction authors (Planning, Revision, Promotion, and more). The licence is MIT.

When your agent uses it

  • Media & Creative work in your project

Example prompts

  • “/first-chapter-hook”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Does your opening match what readers of THIS genre expect?
  2. Where do you conform vs. subvert genre conventions?
  3. Comp title comparison (how do bestsellers in your genre open?)
  4. "Shelf test" — Would a bookstore browser keep reading?

What it can do on your machine

Read from SKILL.md and the folder at commit 47e9570. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

First Chapter Hook loads about 1.3k tokens when it runs. Until then it costs about 29 tokens; SKILL.md has 374 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~29
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Ckokoski/AuthorAgent at commit 47e9570, republished under its MIT licence (© Ckokoski). 374 words, ~1,315 tokens.

Download SKILL.mdSave it as .claude/skills/first-chapter-hook/SKILL.md (or your agent's skills folder).
name
first-chapter-hook
description
Analyze and rewrite first chapters for maximum reader retention using genre-specific hook patterns
author
Writing Secrets
version
1.0.0
triggers
first chapter, opening hook, hook analysis, chapter one, first page, opening line, reader retention, hook score
permissions
file:read, file:write

First Chapter Hook — Premium Skill

Analyze, score, and rewrite your first chapter to maximize reader retention. Because if your first page doesn't hook them, they never see page two.

Hook Score Analysis

Paste your first chapter and get a detailed hook assessment:

First Chapter Hook Score: "The Silent Hour" — Chapter 1

Overall Hook Score: 72/100

╔══════════════════════════════════════════════════╗
║ OPENING LINE                          ★★★★☆  8/10 ║
║ First 250 Words (Look Inside)         ★★★☆☆  6/10 ║
║ Inciting Disturbance (first 3 pages)  ★★★★☆  7/10 ║
║ Character Investment (by page 5)      ★★★★☆  8/10 ║
║ Question Engine (unanswered hooks)    ★★★☆☆  6/10 ║
║ Pacing Momentum                       ★★★★☆  7/10 ║
║ Voice Distinctiveness                 ★★★★★  9/10 ║
║ Genre Promise (signals correct genre) ★★★★☆  8/10 ║
║ Last Line Pull (chapter-end hook)     ★★★☆☆  6/10 ║
║ DNF Risk Assessment                   ★★★★☆  LOW  ║
╚══════════════════════════════════════════════════╝

Strengths:
✅ Strong voice — reader knows who's telling this story
✅ Character is immediately sympathetic (dog detail works)
✅ Genre promise is clear by paragraph 3

Weaknesses:
⚠️ First 250 words spend too long on setting — Amazon "Look Inside" readers will bounce
⚠️ The inciting disturbance doesn't land until page 4 — move to page 1-2
⚠️ Chapter ends on a soft note — needs a question or revelation to pull into Ch2
⚠️ Only 2 unanswered questions planted — aim for 4-5 micro-hooks

Genre Hook Templates

Analyze your opening against genre-specific reader expectations:

Supported Genres
  • Thriller/Suspense — Danger-first openings, ticking clock, in medias res
  • Romance — Meet-cute or emotional wound, voice-heavy, chemistry signal
  • Fantasy — World-hook (one fascinating detail), character-in-motion, magic tease
  • Mystery — Crime or anomaly, detective intro, red herring plant
  • Sci-Fi — World displacement, technology-as-character, status quo disruption
  • Literary Fiction — Voice showcase, thematic seed, emotional resonance
  • Horror — Normalcy with wrongness, dread buildup, false safety
  • YA — Voice-first, identity conflict, immediate stakes
What Gets Analyzed Per Genre
  1. Does your opening match what readers of THIS genre expect?
  2. Where do you conform vs. subvert genre conventions?
  3. Comp title comparison (how do bestsellers in your genre open?)
  4. "Shelf test" — Would a bookstore browser keep reading?

Opening Line Workshop

Generate and compare opening line alternatives:

Your current opening:
"It was a Tuesday when everything changed."

Hook Score: 3/10 — Generic, tells rather than shows, no sensory detail

Generated Alternatives (matched to your Voice Profile):

1. "The blood on my kitchen floor wasn't mine."
   Score: 9/10 — Immediate question, visceral, personal stakes

2. "I found the letter at 3 AM, tucked inside a book I'd never owned."
   Score: 8/10 — Mystery, specific detail, implies intrusion

3. "Three rules kept me alive in this city. I broke all of them before breakfast."
   Score: 8/10 — Voice-heavy, stakes, promises action

4. "The last person to live in this house disappeared on a Tuesday."
   Score: 7/10 — Keeps your Tuesday but adds danger and specificity

Pick one, or I'll generate more variations.

Look Inside Optimizer

Amazon's "Look Inside" feature typically shows your first 250-500 words. This tool optimizes specifically for that window:

  1. Word-by-word audit of your first 250 words
  2. Identifies backstory dumps, passive voice, info-dumps, slow pacing
  3. Rewrites weak sections while preserving your voice
  4. A/B comparison — your version vs. optimized version side-by-side
  5. Conversion prediction — estimate of "Look Inside" → purchase likelihood
Show full SKILL.md (141 more words)Show less

Chapter-End Hook Generator

Analyze your chapter endings and generate stronger pull-through hooks:

  • Cliffhanger variants — Action cutoff, revelation, reversal
  • Question hooks — Plant an unanswered question
  • Emotion hooks — End on a feeling that demands resolution
  • Promise hooks — Hint at what's coming without spoiling

First Five Pages Rewrite

Full rewrite service for your opening pages:

  1. Load your Voice Profile + Book Bible
  2. Identify the core story promise
  3. Restructure for maximum impact
  4. Rewrite while maintaining your voice
  5. Present original vs. rewrite with annotations
  6. Author approves before any file changes

Commands

  • hook score — Full first chapter hook analysis
  • opening line workshop — Generate and compare opening lines
  • optimize look inside — Optimize first 250 words for Amazon
  • chapter end hook [number] — Strengthen any chapter's ending hook
  • rewrite opening — Full first-five-pages rewrite with annotations
  • genre hook check [genre] — Compare your opening to genre conventions

© Ckokoski, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/_archived/premium/first-chapter-hook of Ckokoski/AuthorAgent.

Open the folder on GitHubat commit 47e9570

Compare with similar skills

First Chapter Hook next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

First Chapter Hook compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
First Chapter Hook this skillCkokoski/AuthorAgent123—~1.3kAutomated safety check: PassMIT
Guizang Social Cardsop7418/guizang-social-card-skill7.4k1 repos~7.8kAutomated safety check: PassAGPL-3.0
Weekly Changelog Videoheygen-com/hyperframes59k—~3.3kAutomated safety check: PassApache-2.0
Anthropic Brand Stylinganthropics/skills180k30 repos~559Automated safety check: PassApache-2.0
MoneyPrinterTurbo Video Generatorharry0703/MoneyPrinterTurbo129k—~2.1kAutomated safety check: WarnMIT
Brag Slim Launch Video Makerlatent-spaces/brag14k1 repos~1.9kAutomated safety check: PassMIT

Similar skills

  • Guizang Social Cards

    op7418/guizang-social-card-skill

    Produces social card sets for Xiaohongshu and WeChat: carousels, Live Photo motion cards and puzzle layouts, and WeChat cover pairs, rendered from single-file HTML.

    7.4k GitHub starsUsed in 1 repo~7.8k tokens
    Media & CreativeAuto-check passed
  • Weekly Changelog Video

    heygen-com/hyperframes

    Turns a weekly changelog markdown file into a branded HyperFrames video with voiceover, animated mock-UI scenes and captions, using fonts, background and scripts bundled in the skill.

    59k GitHub stars~3.3k tokensUpdated today
    Media & CreativeAuto-check passed
  • Anthropic Brand Styling

    anthropics/skills

    Official

    Applies Anthropic's brand colors and fonts to artifacts such as PowerPoint slides, using fixed hex values for text and accents, Poppins headings and Lora body text.

    180k GitHub starsUsed in 30 repos~559 tokens
    Media & CreativeAuto-check passed
  • MoneyPrinterTurbo Video Generator

    harry0703/MoneyPrinterTurbo

    Installs and runs MoneyPrinterTurbo to turn a topic or script into a finished short video with voice-over, subtitles, stock footage and music.

    129k GitHub stars~2.1k tokensUpdated today
    Media & CreativeAuto-check: warnings
  • Builds a short, shareable launch video with music and motion from a project directory or a website URL, using only tools already on the machine.

    14k GitHub starsUsed in 1 repo~1.9k tokens
    Media & CreativeAuto-check passed
  • HyperFrames Media Use

    heygen-com/hyperframes

    Finds, generates and edits media for HyperFrames video projects: music, sound effects, images, icons, logos, voiceovers, captions and color grades.

    59k GitHub stars~2.4k tokensUpdated today
    Media & CreativeAuto-check passed

More from Ckokoski/AuthorAgent

All 23 skills in this repo
  • After Action Review

    Ckokoski/AuthorAgent

    Structured post-goal reflection that extracts lessons, evaluates quality, and feeds the self-improvement loop

    123 GitHub stars~1.6k tokensUpdated 3 mo ago
    Auto-check passed
  • Comp Title Finder

    Ckokoski/AuthorAgent

    Find and analyze comparable titles for query letters, marketing, and positioning strategy

    123 GitHub stars~1.4k tokensUpdated 3 mo ago
    Auto-check passed
  • Continuity Check

    Ckokoski/AuthorAgent

    Scan manuscript for inconsistencies in characters, timeline, settings, and names

    123 GitHub stars~1.5k tokensUpdated 3 mo ago
    Auto-check passed
  • Deep Voice Analysis

    Ckokoski/AuthorAgent

    Advanced 47-marker voice analysis engine — analyzes your writing to build a comprehensive Voice Profile for AuthorClaw

    123 GitHub stars~1.4k tokensUpdated 3 mo ago
    Auto-check passed
  • Dictation Cleanup

    Ckokoski/AuthorAgent

    Transform raw speech-to-text dictation into polished prose while preserving the author's natural voice

    123 GitHub stars~1.2k tokensUpdated 3 mo ago
    Auto-check passed
  • Error Recovery

    Ckokoski/AuthorAgent

    Intelligent error diagnosis, automatic recovery strategies, and prevention of recurring failures

    123 GitHub stars~1.7k tokensUpdated 3 mo ago
    Auto-check passed

Questions about First Chapter Hook

What does First Chapter Hook do?

Analyze and rewrite first chapters for maximum reader retention using genre-specific hook patterns. First Chapter Hook is an agent skill from Ckokoski/AuthorAgent.

When should I use First Chapter Hook?

First Chapter Hook fits situations like: media & Creative work in your project.

How do I install First Chapter Hook in Claude Code?

Run `npx skills add Ckokoski/AuthorAgent --skill first-chapter-hook -a claude-code`. Or copy the skill folder (skills/_archived/premium/first-chapter-hook in Ckokoski/AuthorAgent) into .claude/skills/first-chapter-hook in your project. Claude Code loads it when a task matches its description.

How do I install First Chapter Hook in Codex?

Run `npx skills add Ckokoski/AuthorAgent --skill first-chapter-hook -a codex`. Or copy the skill folder (skills/_archived/premium/first-chapter-hook in Ckokoski/AuthorAgent) into .agents/skills/first-chapter-hook in your project. Codex loads it when a task matches its description.

Can I use First Chapter Hook in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Ckokoski/AuthorAgent --skill first-chapter-hook -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/first-chapter-hook, .gemini/skills/first-chapter-hook, .github/skills/first-chapter-hook and .opencode/skills/first-chapter-hook in your project.

What does First Chapter Hook need to run?

SKILL.md names no scripts, command-line tools or credentials: First Chapter Hook is instructions for the agent only.

Does First Chapter Hook access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is First Chapter Hook safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does First Chapter Hook use?

First Chapter Hook is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does First Chapter Hook use?

About 1.3k tokens (SKILL.md is roughly 5.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to First Chapter Hook?

Skills that share tags, products or a category with First Chapter Hook: Guizang Social Cards (op7418/guizang-social-card-skill, 7.4k stars), Weekly Changelog Video (heygen-com/hyperframes, 59k stars), Anthropic Brand Styling (anthropics/skills, 180k stars) and MoneyPrinterTurbo Video Generator (harry0703/MoneyPrinterTurbo, 129k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains First Chapter Hook?

Ckokoski (a GitHub user) maintains it in Ckokoski/AuthorAgent, which has 123 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on July 11, 2026.

Source: Ckokoski/AuthorAgent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.