/jab-hook — Jab-jab-jab-right-hook for a personal portfolio
Gary Vaynerchuk's framework applied to your configured portfolio: keep the feed mostly jabs (value — BIP + educational) so the hooks (promo) earn attention when they land. Drafts to your personal Typefully workspace.
One-time setup: see references/properties.md and references/typefully-config.md to configure your real portfolio + workspace. Personal config lives in ${MAKERSKILLS_CONFIG:-$HOME/.config/makerskills}/jab-hook/.
Mental model
- N rotation slots (configured in
~/.config/makerskills/jab-hook/properties.yaml): one per property you want to promote on rotation
- ~2 promo posts/week → each property cycles every ~3 weeks at equal weight
- Non-promo days: 50/50 build-in-public vs educational
- Target weekly rhythm: ~2 promo + ~2–3 BIP + ~2–3 educational
- Platforms: X + LinkedIn via your personal Typefully workspace
Step 1 — Pick the mode
Detect from the trigger:
| User says |
Mode |
| "plan my socials," "next week's posts" |
plan |
| "what should I post," "next promo," "pick next" |
pick-next |
| "audit my socials," "what's overdue," "what haven't I posted about" |
audit |
| "draft a promo for X," "BIP post about Y," "educational about Z" |
draft |
If ambiguous, confirm.
Step 2 — Load context
- Read
references/properties.md — the 6 rotation slots and angle ideas
- Read
references/voice.md — the user's voice rules per platform
- Read
references/content-types.md — templates for promo / BIP / educational
- Pull recent posts from your personal Typefully workspace:
- First run: call
mcp__typefully__typefully_list_social_sets and ask which social set is your personal (X + LinkedIn). Save the ID to ${MAKERSKILLS_CONFIG:-$HOME/.config/makerskills}/jab-hook/typefully.yaml for future runs (schema in references/typefully-config.example.yaml — never save it inside the skill folder; upgrades wipe it).
- Call
mcp__typefully__typefully_list_drafts filtered to the last 30 days
- Classify each as promo / BIP / educational by content
- Compute days since last promo for each of the 6 slots
Step 3 — Mode logic
plan (7-day plan)
- Slot the 1–2 most overdue properties as promo posts
- Fill remaining 5 days with alternating BIP and educational (50/50)
- Output as a table:
Day | Type | Property/Topic | Hook | Draft summary
- Don't stack two promo on consecutive days
- After the user approves the plan, offer to draft each one in sequence
pick-next
- Identify the most overdue property
- If most overdue < 14 days, suggest a BIP or educational instead (whichever is less recent)
- Draft 1 post; ask before syndicating
audit
- Report: days since last promo per property, ordered by most overdue
- Flag any property >21 days as overdue
- Suggest the next 1–2 moves
draft
- Skip rotation logic — draft the requested post
- Use the right content-type template
Step 4 — Draft
Follow references/voice.md and references/content-types.md. Default: single post, one per platform (X version + LinkedIn version). Thread only if the second post earns its place.
Link placement (load-bearing): never put a URL in the body. Default is no link at all — let curiosity drive the click. When a link is needed, draft it as a first comment for LinkedIn (Typefully supports auto-comment) or a reply for X. The body always stands alone.
Optional: inspiration scan
For promo and educational posts, optionally scan inspiration accounts (references/inspiration.md) before drafting:
- Pick 1–2 accounts whose audience overlaps with the property
- Pull recent posts (agent-browser if it works on LinkedIn; otherwise ask the user to paste examples or fall back to their X/newsletter)
- Extract structural patterns: hook openers, post length, line-break rhythm, CTA styles
- Apply ONE pattern to the user's voice — never mimic phrasing
- Log new patterns in
${MAKERSKILLS_CONFIG:-$HOME/.config/makerskills}/jab-hook/patterns.local.md (create if missing) so they accumulate — references/patterns.md documents the starter patterns and stays read-only
Skip inspiration scan when the user says "just draft it" or when iterating on an existing post.
Step 5 — Syndicate to Typefully
Ask: "Push to Typefully now? (X + LinkedIn, your personal workspace)"
If yes:
- Read social set ID from
${MAKERSKILLS_CONFIG:-$HOME/.config/makerskills}/jab-hook/typefully.yaml (setup notes in references/typefully-config.md)
- Call
mcp__typefully__typefully_create_draft once for X, once for LinkedIn (or once with both platforms if the social set spans both)
- If the draft has a first-comment link, configure Typefully to add it automatically (LinkedIn auto-comment / X reply). If the MCP doesn't support auto-comment for one of the platforms, surface the comment text so the user can paste it after publishing.
- Default to draft state (not scheduled) — the user reviews in Typefully UI before sending
- Return the Typefully draft URLs
Composes with
paste — clean output for pasting into Typefully / LinkedIn / X manually if the MCP path doesn't fitsocial-fetch — pull inspiration-account posts for structural analysis (replaces inline agent-browser)second-brain — the Content Ideas wiki page hoppers hooks, frameworks, stories; /jab-hook drafts pull candidates from theredeep-research — when a promo needs a stat or citation the draft doesn't have yetmarketingskills:social — generic social frameworks, useful when teaching strategy vs shipping your own postsmarketingskills:copywriting — for hook / headline ideation when stuck
Notes on quality
- 1 promo per week per property is the floor, not the ceiling. Rotation compounds when it's predictable — 4 properties × 1 promo/week = 4 promo weeks/month. Educational + BIP + community fill the rest.
- Never mimic phrasing from inspiration accounts. Extract structure (hook opener type, line-break rhythm, CTA style) and apply to your own voice. Voice is the moat; copying phrasing destroys it.
- Links belong in first comments, not the body for LinkedIn + X. Documented in
~/.claude/memory/feedback_social_link_placement.md. Body posts with inline URLs get algorithm-suppressed on both platforms.
- Draft state, not scheduled state. Every Typefully push defaults to draft — human review in the Typefully UI before publish is non-negotiable. Automated scheduling of unreviewed drafts has repeatedly produced posts the user regrets.
- Reader-perspective framing. "You'll know X" not "we'll teach you X." "What you're guaranteed" not "what we'd guarantee."
- Voice.local.md overrides the shipped voice.md. Personal voice rules never live in the public repo — always in
${MAKERSKILLS_CONFIG:-$HOME/.config/makerskills}/jab-hook/voice.local.md.
- Cadence cap: 2 posts/day per platform, per account. More than that degrades reach + reads as spam.
Memory references
~/.claude/memory/feedback_promo_voice.md (if present) — conviction-coded CTAs + reader-perspective framing~/.claude/memory/feedback_social_cadence.md (if present) — cadence cap (e.g., 2 posts/day per platform)
1---2name: jab-hook3description: Gary Vaynerchuk's jab-jab-jab-right-hook framework applied to a personal portfolio rotation on X and LinkedIn. Jabs = build-in-public + educational (value). Hooks = promo (the ask). Each property in the user's configured portfolio (see `~/.config/makerskills/jab-hook/properties.yaml`) gets a hook at least once every ~3 weeks; jabs fill the rest. Drafts go into the user's Typefully workspace via MCP. Modes — plan (7-day plan), pick-next (single post), audit (coverage report), draft (specific post). Triggers on "/jab-hook," "what should I post," "plan my socials," "next promo," "next jab," "next hook," "social rotation," "promote [property]," "BIP post," "audit my socials," "what haven't I posted about."4---5
6# /jab-hook — Jab-jab-jab-right-hook for a personal portfolio
7
8Gary Vaynerchuk's framework applied to your configured portfolio: keep the feed mostly *jabs* (value — BIP + educational) so the *hooks* (promo) earn attention when they land. Drafts to your personal Typefully workspace.
9
10**One-time setup**: see `references/properties.md` and `references/typefully-config.md` to configure your real portfolio + workspace. Personal config lives in `${MAKERSKILLS_CONFIG:-$HOME/.config/makerskills}/jab-hook/`.
11
12## Mental model
13
14- **N rotation slots** (configured in `~/.config/makerskills/jab-hook/properties.yaml`): one per property you want to promote on rotation
15- **~2 promo posts/week** → each property cycles every ~3 weeks at equal weight
16- **Non-promo days**: 50/50 build-in-public vs educational
17- **Target weekly rhythm**: ~2 promo + ~2–3 BIP + ~2–3 educational
18- **Platforms**: X + LinkedIn via your personal Typefully workspace
19
20## Step 1 — Pick the mode
21
22Detect from the trigger:
23
24| User says | Mode |
25|---|---|
26| "plan my socials," "next week's posts" | **plan** |
27| "what should I post," "next promo," "pick next" | **pick-next** |
28| "audit my socials," "what's overdue," "what haven't I posted about" | **audit** |
29| "draft a promo for X," "BIP post about Y," "educational about Z" | **draft** |
30
31If ambiguous, confirm.
32
33## Step 2 — Load context
34
351. Read `references/properties.md` — the 6 rotation slots and angle ideas
362. Read `references/voice.md` — the user's voice rules per platform
373. Read `references/content-types.md` — templates for promo / BIP / educational
384. Pull recent posts from your personal Typefully workspace:
39 - First run: call `mcp__typefully__typefully_list_social_sets` and ask which social set is your personal (X + LinkedIn). Save the ID to `${MAKERSKILLS_CONFIG:-$HOME/.config/makerskills}/jab-hook/typefully.yaml` for future runs (schema in `references/typefully-config.example.yaml` — never save it inside the skill folder; upgrades wipe it).
40 - Call `mcp__typefully__typefully_list_drafts` filtered to the last 30 days
41 - Classify each as promo / BIP / educational by content
425. Compute **days since last promo** for each of the 6 slots
43
44## Step 3 — Mode logic
45
46### plan (7-day plan)
47- Slot the 1–2 most overdue properties as **promo** posts
48- Fill remaining 5 days with **alternating** BIP and educational (50/50)
49- Output as a table: `Day | Type | Property/Topic | Hook | Draft summary`
50- Don't stack two promo on consecutive days
51- After the user approves the plan, offer to draft each one in sequence
52
53### pick-next
54- Identify the most overdue property
55- If most overdue < 14 days, suggest a BIP or educational instead (whichever is less recent)
56- Draft 1 post; ask before syndicating
57
58### audit
59- Report: days since last promo per property, ordered by most overdue
60- Flag any property >21 days as overdue
61- Suggest the next 1–2 moves
62
63### draft
64- Skip rotation logic — draft the requested post
65- Use the right content-type template
66
67## Step 4 — Draft
68
69Follow `references/voice.md` and `references/content-types.md`. Default: **single post**, one per platform (X version + LinkedIn version). Thread only if the second post earns its place.
70
71**Link placement (load-bearing)**: never put a URL in the body. Default is no link at all — let curiosity drive the click. When a link is needed, draft it as a **first comment** for LinkedIn (Typefully supports auto-comment) or a **reply** for X. The body always stands alone.
72
73### Optional: inspiration scan
74
75For `promo` and `educational` posts, optionally scan inspiration accounts (`references/inspiration.md`) before drafting:
76
771. Pick 1–2 accounts whose audience overlaps with the property
782. Pull recent posts (agent-browser if it works on LinkedIn; otherwise ask the user to paste examples or fall back to their X/newsletter)
793. Extract structural patterns: hook openers, post length, line-break rhythm, CTA styles
804. Apply ONE pattern to the user's voice — never mimic phrasing
815. Log new patterns in `${MAKERSKILLS_CONFIG:-$HOME/.config/makerskills}/jab-hook/patterns.local.md` (create if missing) so they accumulate — `references/patterns.md` documents the starter patterns and stays read-only
82
83Skip inspiration scan when the user says "just draft it" or when iterating on an existing post.
84
85## Step 5 — Syndicate to Typefully
86
87Ask: *"Push to Typefully now? (X + LinkedIn, your personal workspace)"*
88
89If yes:
901. Read social set ID from `${MAKERSKILLS_CONFIG:-$HOME/.config/makerskills}/jab-hook/typefully.yaml` (setup notes in `references/typefully-config.md`)
912. Call `mcp__typefully__typefully_create_draft` once for X, once for LinkedIn (or once with both platforms if the social set spans both)
923. If the draft has a first-comment link, configure Typefully to add it automatically (LinkedIn auto-comment / X reply). If the MCP doesn't support auto-comment for one of the platforms, surface the comment text so the user can paste it after publishing.
934. Default to **draft** state (not scheduled) — the user reviews in Typefully UI before sending
945. Return the Typefully draft URLs
95
96## Composes with
97
98- `paste` — clean output for pasting into Typefully / LinkedIn / X manually if the MCP path doesn't fit
99- `social-fetch` — pull inspiration-account posts for structural analysis (replaces inline agent-browser)
100- `second-brain` — the `Content Ideas` wiki page hoppers hooks, frameworks, stories; `/jab-hook` drafts pull candidates from there
101- `deep-research` — when a promo needs a stat or citation the draft doesn't have yet
102- `marketingskills:social` — generic social frameworks, useful when teaching strategy vs shipping your own posts
103- `marketingskills:copywriting` — for hook / headline ideation when stuck
104
105## Notes on quality
106
107- **1 promo per week per property is the floor, not the ceiling.** Rotation compounds when it's predictable — 4 properties × 1 promo/week = 4 promo weeks/month. Educational + BIP + community fill the rest.
108- **Never mimic phrasing from inspiration accounts.** Extract *structure* (hook opener type, line-break rhythm, CTA style) and apply to your own voice. Voice is the moat; copying phrasing destroys it.
109- **Links belong in first comments, not the body** for LinkedIn + X. Documented in `~/.claude/memory/feedback_social_link_placement.md`. Body posts with inline URLs get algorithm-suppressed on both platforms.
110- **Draft state, not scheduled state.** Every Typefully push defaults to draft — human review in the Typefully UI before publish is non-negotiable. Automated scheduling of unreviewed drafts has repeatedly produced posts the user regrets.
111- **Reader-perspective framing.** *"You'll know X"* not *"we'll teach you X."* *"What you're guaranteed"* not *"what we'd guarantee."*
112- **Voice.local.md overrides the shipped voice.md.** Personal voice rules never live in the public repo — always in `${MAKERSKILLS_CONFIG:-$HOME/.config/makerskills}/jab-hook/voice.local.md`.
113- **Cadence cap: 2 posts/day per platform, per account.** More than that degrades reach + reads as spam.
114
115## Memory references
116
117- `~/.claude/memory/feedback_promo_voice.md` (if present) — conviction-coded CTAs + reader-perspective framing
118- `~/.claude/memory/feedback_social_cadence.md` (if present) — cadence cap (e.g., 2 posts/day per platform)
majiayu000