CommunityWriting & Editinggithub.com

tianbester-ZA/books

Answers what 17 advertising and editing books say about a question (Schwartz, Caples, Hopkins, Ogilvy, Sugarman, Cialdini, Heath, Bencivenga, Masters of Copywriting, Miller, Sharp, three Hormozi books, Murch, Pearlman, Block), by searching notes on 3,286 passages that were each read in full, and citing the passage ids. Use it whenever someone asks what the books say about a hook, offer, proof, awareness, urgency, pricing, guarantees, rhythm, cuts or where the eye goes, wants evidence for a creative call, wants to settle an argument about an ad, or asks what a named book or author is good for. /bb:script and /bb:edit call it for their decisions.

What is books?

books is a Claude Code agent skill that answers what 17 advertising and editing books say about a question (Schwartz, Caples, Hopkins, Ogilvy, Sugarman, Cialdini, Heath, Bencivenga, Masters of Copywriting, Miller, Sharp, three Hormozi books, Murch, Pearlman, Block), by searching notes on 3,286 passages that were each read in full, and citing the passage ids. Use it whenever someone asks what the books say about a hook, offer, proof, awareness, urgency, pricing, guarantees, rhythm, cuts or where the eye goes, wants evidence for a creative call, wants to settle an argument about an ad, or asks what a named book or author is good for. /bb:script and /bb:edit call it for their decisions.

Works with✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tianbester-ZA/butcherbird-skills/tree/main/plugins/bb/skills/books

Installed? Explore more Writing & Editing skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

/bb:books

Goal

A straight answer to what the books say, with the passage ids behind it, and a plain note of where they disagree or don't speak at all.

Why

Claude half-remembers these books and sounds sure anyway. Each book here has been read passage by passage, and a reader wrote a plain note on each passage: what it says and what to do about it in a reel. Searching those beats reciting from memory, and the ids mean anyone can check.

How

python3 "${CLAUDE_SKILL_DIR}/scripts/search.py" "plain words" --job hook --k 8
python3 "${CLAUDE_SKILL_DIR}/scripts/search.py" "plain words" --book caples
python3 "${CLAUDE_SKILL_DIR}/scripts/search.py" --show caples-0221
python3 "${CLAUDE_SKILL_DIR}/scripts/search.py" --toc sugarman
python3 "${CLAUDE_SKILL_DIR}/scripts/search.py" --books

Search matches words, not meaning, so literal short words work and whole questions don't. Run a few searches with different words, then --show the ones you'll rely on.

Jobs: want, awareness, offer, proof, hook, shape, and for editing feel, rhythm, eye.

The cards. ${CLAUDE_SKILL_DIR}/cards/<book>.md is a one-page summary of each book: the core idea, what it changes against what a generic script does, its ten best passages and an index by job. Read a card when someone asks about a book as a whole, or to get your bearings before searching.

What you get

Answer first in a few plain lines, each with its id (caples-0221). Then one line on where the books disagree, if they do, and which way we'd lean for a 15 to 60 second video.

Be straight about the limits. These are print, mail-order, TV and lab books, so a number tells you what happened there, not what a reel will do. Hormozi's numbers are his own claims. Many of Cialdini's are favours, not purchases. Nothing tests a muted feed. If the books don't speak to it, say so; never force a citation.

What's here and what isn't

Short notes in our own words and the cards ship with this pack, never the books or quotes from them. --show gives you the note, and that's what you cite. Say what a book teaches in your own words. If someone wants the original, tell them which book and chapter.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

tianbester-ZA/edit

Cuts 15 to 60 second paid ads and organic reels from raw footage to finished 9:16 and 4:5 masters with sound, on this Mac with ffmpeg. Asks what the video is for first, listens to every clip, plans each beat (what to feel, where to cut and hold, where the eye lands) against three editing books through the book search, shows options before a draft, and runs a separate critic pass on the rough cut. Use it whenever someone asks to edit, cut, re-cut, trim, "make a reel from", "put together", caption, score or finish a video, for a client or for Butcherbird, paid or organic, UGC, founder, talking head, behind the scenes or montage, and for 4:5 versions, re-cutting an opening after a weak hook rate, or explaining why a cut feels off. Writing or changing the words or the idea belongs to /bb:script.

tianbester-ZA/script

Writes 15 to 60 second paid social video scripts and reels (UGC, founder, talking head, skits) and packs them in Butcherbird's one-ad-per-page shoot-pack format, checking every hook, promise, proof and offer decision against 17 advertising books through the book search, then running a separate critic pass. Use it whenever someone asks for scripts, hooks, a script pack, a shoot pack, ad concepts, reel ideas, UGC or creator briefs, founder videos, skits, "what should they say", or "write me five videos for X", for any client, even with only a deal and a vibe. Also use it to re-hook a tired ad, rewrite a weak script, write the on-screen words for an edit of footage already shot, or judge why a script feels flat. Not for static ads, emails or landing pages.

Related Skills