{
  "markdown": "# Hook Skills\n\n**5 open-source skills for stronger short-form video hooks.**\n\nHook Skills is a focused skill pack for designing, decoding, routing, and QA-ing short-form video hooks.\n\nIt is built for TikTok, Reels, Shorts, UGC ads, AI video workflows, and any creative system where the first 1-3 seconds decide whether the viewer keeps watching.\n\nThis repo packages the hook layer only:\n\n- choose the right opening route\n- turn vague ideas into a stable hook brief\n- decode benchmark references into reusable opening logic\n- design stronger visual openings\n- QA prompts before spending generation credits\n\n## Why This Exists\n\nMost short-form videos do not fail because the body is bad.\n\nThey fail because the opening does not create a concrete viewer question before the content feels like an ad.\n\nWe built these skills to make hook work less fuzzy and more operational:\n\n- mechanism before wording\n- product reveal timing before product hype\n- visible conflict before visual polish\n- reusable diagnosis before random inspiration\n\n## What Is Inside\n\n### Routing\n\n- [`pattern-router`](routing/pattern-router/SKILL.md)  \n  Choose the right opening route before prompt writing starts.\n\n- [`hook-design`](routing/hook-design/SKILL.md)  \n  Turn a rough idea into a reusable `Hook Brief`.\n\n- [`reference-decode`](routing/reference-decode/SKILL.md)  \n  Distill benchmark clips and frames into reusable opening structure.\n\n### Creative\n\n- [`visual-hook`](creative/visual-hook/SKILL.md)  \n  Strengthen frame one, first slide, or first 1-3 seconds.\n\n### QA\n\n- [`prompt-preflight-qa`](qa/prompt-preflight-qa/SKILL.md)  \n  Catch weak openings, early product reveal, and prompt drift before generation.\n\n## How We Distilled It\n\nThis repo is informed by analysis across **1,000+ short-form hooks, benchmark openings, and hook-adjacent prompt examples**.\n\nThe working method:\n\n1. Collect winning and failed opening examples across short-form formats.\n2. Group them by stop-scroll job, not by niche or surface wording.\n3. Compare viewer question, product timing, visible proof, and self-recognition.\n4. Extract reusable opening mechanisms and failure patterns.\n5. Package those judgments into installable skills instead of a swipe file.\n\nRead the full write-up in [`docs/methodology.md`](docs/methodology.md).\n\n## Quick Start\n\n| Tool | Install |\n| --- | --- |\n| Claude Code | `/plugin marketplace add PostPlusAI/hook-skills` |\n| OpenClaw | `clawhub install PostPlusAI/hook-skills` or bundle |\n| Gemini CLI | `gemini extensions install https://github.com/PostPlusAI/hook-skills` |\n| Qwen Code | `qwen extensions install https://github.com/PostPlusAI/hook-skills` |\n| Amp | `amp skill add PostPlusAI/hook-skills` |\n| Kimi Code CLI | `kimi plugin install https://github.com/PostPlusAI/hook-skills.git` |\n| CodeBuddy | `/plugin marketplace add PostPlusAI/hook-skills then /plugin install postplus-hook-skills` |\n| Cursor / Codex / Windsurf / Cline / Copilot / 35+ agents | `npx skills add PostPlusAI/hook-skills` |\n\nInstall one skill:\n\n```bash\nnpx skills add PostPlusAI/hook-skills -s hook-design\n```\n\nThe repository includes the marketplace and extension manifests needed for these install surfaces.\n\n## Try These Requests\n\n```text\nTurn this rough opening into a stronger hook brief\n```\n\n```text\nThe product appears too early. Fix the hook logic first\n```\n\n```text\nDecode this benchmark into a reusable opening structure\n```\n\n```text\nReview this prompt before we spend credits on generation\n```\n\n## Pipeline\n\n```\n                        ┌──────────────────────┐\n                        │     Raw input         │\n                        │  (brief / references  │\n                        │   / prompt draft)     │\n                        └──────────┬───────────┘\n                                   │\n                                   ▼\n                   ┌───────────────────────────┐\n                   │      pattern-router       │\n                   │                           │\n                   │  Routes the opening job:  │\n                   │  segment type, viewer     │\n                   │  question, product rule   │\n                   │                           │\n                   │  Output: Route Summary    │\n                   └──────────┬───────────────┘\n                              │\n                              ▼\n                   ┌───────────────────────────┐\n                   │       hook-design         │\n                   │                           │\n                   │  Locks mechanism +        │\n                   │  product timing. Reads    │\n                   │  hook-principles.md +     │\n                   │  hook-examples.md for     │\n                   │  reference.               │\n                   │                           │\n                   │  Output: Hook Brief       │\n                   └──────────┬───────────────┘\n                              │\n              ┌───────────────┴────────────────┐\n              │                                │\n              ▼                                ▼\n ┌──────────────────────┐       ┌──────────────────────┐\n │   reference-decode   │       │     visual-hook      │\n │                      │       │                      │\n │  When benchmarks or  │       │  When frame-one or   │\n │  references exist:   │       │  first 3 s need      │\n │  extract essence,    │       │  visual strength:    │\n │  viewer question,    │       │  map hook mechanism  │\n │  grammar, drift      │       │  to visual family    │\n │  boundaries          │       │                      │\n └──────────┬───────────┘       └──────────┬───────────┘\n            │                              │\n            └──────────────┬───────────────┘\n                           │\n                           ▼\n                  ┌──────────────────────────┐\n                  │   prompt-preflight-qa    │\n                  │                          │\n                  │  Pre-generation check:   │\n                  │  opening strength,       │\n                  │  product timing, drift   │\n                  │  risk, missing fields    │\n                  │                          │\n                  │  Output: Verdict + Fixes │\n                  └──────────┬───────────────┘\n                             │\n                             ▼\n                  ┌──────────────────────────┐\n                  │  Ready for image /       │\n                  │  video generation        │\n                  └──────────────────────────┘\n```\n\n**Reference files (in `routing/hook-design/`):**\n\n```\nhook-principles.md    6 mechanism definitions, product reveal rules,\n                      common failure patterns\n\nhook-examples.md      200+ example sentences organized by mechanism,\n                      3 complete Hook Brief diagnosis examples,\n                      appendices (FAQ, tips, niche references)\n```\n\nThe goal is not to generate more hook ideas. The goal is to make the opening logic explicit enough that downstream prompt writing does not have to guess.\n\n## Repo Structure\n\n```text\nhook-skills/\n├── routing/\n│   ├── pattern-router/\n│   ├── hook-design/\n│   └── reference-decode/\n├── creative/\n│   └── visual-hook/\n├── qa/\n│   └── prompt-preflight-qa/\n├── .claude-plugin/\n├── .codebuddy-plugin/\n└── docs/\n    └── methodology.md\n```\n\n## Positioning\n\nThis is the open-source hook layer.\n\nIt is intentionally narrow, practical, and easy to install.\n\nMore production skills, research workflows, and creative systems: [postplus.io](https://postplus.io)\n\n## Contributing\n\nSee [`CONTRIBUTING.md`](CONTRIBUTING.md).\n\n## Versioning\n\nSee [`VERSIONS.md`](VERSIONS.md).\n",
  "bytes": 7608,
  "sha": "76ee30b3d4dc2b817690920d818621743468153efd91e045b4d58cb658ace27f",
  "repo_slug": "postplusai/hook-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_postplusai_hook_skills_bde20633/readme"
}