coreyhaines31/makerskills / skills/jab-hook
jab-hook
VerifiedGary 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."
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.1 KB |
| references/content-types.md | markdown | 3.4 KB |
| references/inspiration.example.md | markdown | 3.3 KB |
| references/inspiration.md | markdown | 3.6 KB |
| references/patterns.md | markdown | 1.6 KB |
| references/properties.example.yaml | config | 1.7 KB |
| references/properties.md | markdown | 1.6 KB |
| references/typefully-config.example.yaml | config | 1.0 KB |
| references/typefully-config.md | markdown | 1.2 KB |
| references/voice.md | markdown | 3.1 KB |
references/inspiration.md
View on GitHub# Inspiration accounts
**Your personal list lives at `${MAKERSKILLS_CONFIG:-$HOME/.config/makerskills}/jab-hook/inspiration.local.md`** — not in this repo (gitignored, on disk only). The list of operators you're learning from is your taste — keep it private.
See `inspiration.example.md` in this directory for the schema + setup instructions.
## How the skill loads it
1. Read `${MAKERSKILLS_CONFIG:-$HOME/.config/makerskills}/jab-hook/inspiration.local.md` for the personal account list
2. If missing, skip the inspiration scan (skill still works, just without external pattern pull)
## Per-platform organization (load-bearing)
The local file is organized by platform — `## LinkedIn`, `## X (Twitter)`, `## Instagram`, etc. — because **what works on one platform usually doesn't work on another**:
- **LinkedIn**: long-form professional, carousel/document posts, framework breakdowns, narrative + takeaway
- **X**: short (≤280 chars), thread mechanics, reply-as-content, punchier + snarkier
- **Instagram**: visual-first, reel-driven, lifestyle / behind-the-scenes
- **TikTok**: vertical video, hook-heavy, trend-aware short-form
- **YouTube**: long-form (more relevant to `youtubeskills` than `jab-hook`)
When the skill scans inspiration, it pulls from the section matching the TARGET PLATFORM of the draft. Cross-posted drafts (e.g., X + LinkedIn) scan both sections.
## Same person, two platforms
When an operator appears on multiple platforms with strong presence on each, list them in both relevant sections — their craft per platform is usually different. Treat each listing as a separate inspiration source for that platform.
## Pattern library — also local + platform-tagged
When the skill extracts hook patterns / structural patterns from inspiration-account posts, it writes them to:
`${MAKERSKILLS_CONFIG:-$HOME/.config/makerskills}/jab-hook/patterns.local.md`
Each pattern is tagged with the source platform (e.g., `platform: linkedin`) so future scans know which patterns transfer where. Some patterns are platform-portable (story-open hooks); others are platform-specific (LinkedIn carousel structure, X thread mechanics).
This file is gitignored. The pattern library grows with use and stays your private playbook.
## Methodology (this stays public — recipe, not data)
When drafting a `promo` or `educational` post:
1. **Determine the target platform(s)** — X, LinkedIn, both, etc.
2. **Pick 1–2 accounts from the matching platform section(s)** whose audience overlaps the property being promoted
3. **Pull their recent posts via `social-fetch`**
- LinkedIn: `agent-browser` with modal dismissal (no API key needed) or ScrapeCreators if `SCRAPECREATORS_API_KEY` set for full post data
- X: ScrapeCreators recommended; free tier returns preview only
4. **Extract**: hook openers, structural patterns (numbered list / contrarian-take / story-open / thread mechanics), CTA styles, post length, line-break rhythm
5. **Choose ONE pattern** that fits the property + content type + platform conventions
6. **Apply the pattern to YOUR voice** — don't mimic their voice, only the structure
## Notes
- LinkedIn often blocks unauthenticated scraping. If `agent-browser` walls, fall back to: pasting examples, pulling from their public newsletters, or scraping their X accounts.
- Never copy phrasing — only structure, format, hook archetype.
- Inspiration is a starting point. Your voice rules in `voice.md` (+ `voice.local.md` overlay) always override format choices.
- Some patterns transfer across platforms (story-open hooks); others don't (LinkedIn carousels won't work on X). The `patterns.local.md` platform tag helps the skill respect the boundary.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |