Skip to content
Back to search

create-viral-content

"Writes and sharpens social posts, threads, titles, hooks and scripts so they spread and read as human. Use for any public-facing post, title or caption."

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/aaaronmiller--create-viral-content/badge.svg)](/listings/aaaronmiller--create-viral-content)

HTML

<a href="/listings/aaaronmiller--create-viral-content"><img src="/api/listings/aaaronmiller--create-viral-content/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

The skill is a folder named `create-viral-content` containing `SKILL.md` and `references/`. Every platform below needs the folder name to stay exactly `create-viral-content`.

**claude.ai (web and desktop).** Download `create-viral-content.zip` from the [latest release](https://github.com/aaaronmiller/create-viral-content/releases/latest) and upload it under Settings, Capabilities, Skills. To build the zip yourself instead, its single top-level folder must be `create-viral-content`:

git clone https://github.com/aaaronmiller/create-viral-content
cd create-viral-content && git archive --prefix=create-viral-content/ -o ../create-viral-content.zip HEAD

Do not upload GitHub's "Download ZIP" archive: it wraps the files in `create-viral-content-main/`, and the folder name must match the skill name.

**Claude Code.**

git clone https://github.com/aaaronmiller/create-viral-content ~/.claude/skills/create-viral-content

**Codex, Gemini CLI, opencode, Qwen Code, Cursor, Kilo** (shared user-level skills folder):

git clone https://github.com/aaaronmiller/create-viral-content ~/.agents/skills/create-viral-content

**Antigravity:** clone into `~/.gemini/config/skills/create-viral-content`.

**Claude API and OpenAI API:** upload the same zip as a skill bundle.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 258 lines
  1. ---
  2. name: create-viral-content
  3. description: "Writes and sharpens social posts, threads, titles, hooks and scripts so they spread and read as human. Use for any public-facing post, title or caption."
  4. license: MIT
  5. metadata:
  6. description-reviewed: "2026-11-10"
  7. author: ice-ninja
  8. version: "3.0.0"
  9. updated: "2026-11-10"
  10. tags: "social, writing, marketing, ai-tells"
  11. ---
  12. # Create Viral Content
  13. Turn a draft or a brief into a post that earns shares, comments and action,
  14. and that reads as written by a person with a point of view.
  15. ## Contents
  16. - [Workflow](#workflow)
  17. - [What platforms reward in 2026](#what-platforms-reward-in-2026)
  18. - [Hooks, body and closer](#hooks-body-and-closer)
  19. - [Platform rules](#platform-rules)
  20. - [Titles and thumbnails](#titles-and-thumbnails)
  21. - [AI tells: the top five](#ai-tells-the-top-five)
  22. - [Refinement passes](#refinement-passes)
  23. - [Ethics and disclosure](#ethics-and-disclosure)
  24. - [Example](#example)
  25. - [Reference files](#reference-files)
  26. ## Workflow
  27. Run these steps in order for every request. Skip a step only when the
  28. request makes it irrelevant (for example, no thumbnail for a Reddit post).
  29. 1. **Pin the brief.** Identify platform, audience, goal and the author's own
  30. stake: a claim, a number, an event or an experience only they have. If
  31. none is given, ask for one; without it, platforms now classify the post
  32. as slop.
  33. 2. **Check platform rules.** Read the platform section below and, for
  34. LinkedIn, X, YouTube, Instagram, Threads, Reddit or email, the matching
  35. section of `references/platform-updates-2026.md`. For Reddit, check the
  36. target subreddit's AI rule first.
  37. 3. **Draft the hook.** Generate at least five hooks from the patterns below
  38. and pick the strongest by the title score.
  39. 4. **Draft the body and closer** using the structure below and the matching
  40. template in `references/platform-templates.md`.
  41. 5. **Remove AI tells.** Apply the top five below, then scan against the
  42. "Current-Model Tells (2026)" table in `references/ai-tells.md`.
  43. 6. **Run the refinement passes.** Attack the draft from five perspectives
  44. and revise after each.
  45. 7. **Package.** For video, write two or three title and thumbnail variants
  46. that make different promises (YouTube tests pick by watch time).
  47. 8. **Check disclosure.** Apply the disclosure rules below before handing
  48. the draft back, and say which one applies.
  49. Deliver the final draft, the alternates considered, and one line on why the
  50. chosen hook wins.
  51. ## What platforms reward in 2026
  52. These changes override older advice. Details and sources:
  53. `references/platform-updates-2026.md`.
  54. - **Perspective beats polish.** LinkedIn's slop classifiers (from
  55. 2026-07-30) cut out-of-network reach for fluent posts with no identifiable
  56. stance; classified slop gets about 40% fewer views.
  57. - **Keyword-comment bait is dead.** "Comment GUIDE and I'll DM you" lost
  58. about half its LinkedIn reach from 2026-07-27. A plain question is fine.
  59. - **Links cost reach.** About 16-21% on LinkedIn, including "link in the
  60. comments"; near-zero median engagement for non-Premium link posts on X.
  61. Put substance first and the link last, or in a reply.
  62. - **Originality is enforced on video.** YouTube demonetizes templated AI
  63. content and AI personas on health or finance; Shorts cuts reach for
  64. re-uploads, and narrating someone else's footage does not count.
  65. - **Mutuals and communities win replies.** X boosts mutual-follow replies;
  66. Bluesky ranks replies by social proximity; Threads reports which
  67. community drove each post.
  68. - **Posting time barely matters on LinkedIn** (±2% of final reach). Do not
  69. spend effort on it.
  70. ## Hooks, body and closer
  71. ### Hook (first line, first two seconds)
  72. Pick one pattern and fill it with the author's real material.
  73. - **Prediction + stakes:** "I think [concept] is the [year] [category] that
  74. [outcome]." A personal conviction, a timeframe and a consequence.
  75. - **Tribal split:** "[Technique] separates [group] from [everyone else]."
  76. The reader picks a side.
  77. - **Before/after compression:** "What used to take [old cost] now takes
  78. [new cost]." A concrete, shareable gain.
  79. - **Specific result:** "I tried [thing] for [time]. [Number] changed." The
  80. number must be real.
  81. ### Body
  82. Order: **what** it is (one or two sentences), **how** it works with a
  83. concrete example, **why now**, then the **payoff** the reader can use.
  84. Explain the thing before arguing why it matters. Give at least one concrete
  85. example per abstract claim.
  86. ### Closer (last 10%)
  87. End on a statement, not a request:
  88. ```
  89. BAD: "Try it. Change my mind." / "Comment GUIDE and I'll send it."
  90. GOOD: "Your next [action] shouldn't [old way]. It should [new way]."
  91. ```
  92. A specific question that invites a real answer is acceptable; generic
  93. "what do you think?" is not.
  94. ## Platform rules
  95. | Platform | Length | Do | Avoid |
  96. |---|---|---|---|
  97. | Reddit | 200-400 words | Casual-expert voice, quotable TL;DR, match the subreddit (r/MachineLearning: conservative claims; r/LocalLLaMA: self-hosting angle) | AI-sounding replies (98% of replies are human-written, so tells stand out), posting before reading the subreddit's AI rule |
  98. | Hacker News | Short | "Show HN:" format, understate | Hype words |
  99. | X | under 280 chars per post | Standalone hook post, substance before link, replies inside the author's niche | "1/" numbering, bare link posts |
  100. | LinkedIn | 150-300 words | First-person claim or lived detail, plain-question or statement closer | Keyword-comment CTAs, link in post or comments when reach matters, hashtag stuffing |
  101. | YouTube comment | about 500 chars | Bold claim first, mechanic in two sentences, quotable closer | Formatting |
  102. | TikTok | Caption 5-10 words | Keyword in the first three words, hook in 1-3 seconds, sound-off friendly text | Unlabeled realistic AI visuals |
  103. | Instagram Reels | Text overlay in 2 s | First-frame hook, optimize for sends to a friend; Reels may trail a long video | Watermarked reposts, minor-crop reposts |
  104. | Carousel | 5-10 slides | Slide 1 curiosity gap, middle slides deliver, last slide quotable | Assuming carousels still beat photos (the lead shrank to about 9%) |
  105. | Threads | Short | First line written as a headline (posts appear in Google Discover), UTM links | Relying on native link stats (removed) |
  106. | Email subject | 30-50 chars | Personalized curiosity; pitch in preheader and first sentence because AI inbox summaries read them | ALL CAPS urgency, fake "quick question", emoji overload |
  107. Full templates: `references/platform-templates.md`. Adapting one piece to
  108. several platforms: `references/cross-platform-adaptation.md`.
  109. ## Titles and thumbnails
  110. Titles decide most of a video's or article's performance. Generate 25 or
  111. more, then score each 0-3 on curiosity, specificity and emotion; ship only
  112. 7 or above.
  113. - **Length:** for text headlines, about 11 words or 65 characters still
  114. works. For YouTube, 2026 data (507k videos) shows longer, specific titles
  115. break out more (over 75 characters: 35.9% vs under 30: 26.1%).
  116. - **Numbers:** specific beats round ($1,247 over $1,000); odd beats even.
  117. - **Negative superlatives** outperform positive ones on clicks; use them
  118. only when true.
  119. - **Thumbnail:** a face with a calm or neutral expression (shocked faces are
  120. only 5-11% of 2026 breakouts), 4-6 words that add to the title rather than
  121. repeat it, at most three elements, legible at 120 px wide.
  122. - **Variants:** make each variant a different promise the video keeps.
  123. Formulas and scoring: `references/viral-titles.md`,
  124. `references/title-formulas.md`. Thumbnail design:
  125. `references/viral-thumbnails.md`, `references/thumbnail-checklist.md`.
  126. ## AI tells: the top five
  127. Current models dropped the famous tells (em dashes fell 99% in Opus 5.5), so
  128. check for these first. Score clusters, not single hits.
  129. 1. **Importance flagging:** "this matters", "why X matters", "matters most".
  130. 2. **"More than" contrast:** "is more than a X, it...", "rather than
  131. simply", "not only... but also".
  132. 3. **Forward-looking transitions:** "looking ahead", "adds another layer",
  133. "in practice", "here's the thing".
  134. 4. **Enthusiasm and helpfulness:** "excited to share", "game-changer",
  135. "can help you", "makes it easier", "genuinely".
  136. 5. **Perspective-free polish:** fluent sentences of uniform length with no
  137. stance, number or lived detail. Fix it by adding the author's own claim
  138. and varying sentence length.
  139. Complete catalog with older tells, platform-specific tells and video and
  140. thumbnail tells: `references/ai-tells.md`. For a voice polish pass, use the
  141. humanize-writing skill if installed (`references/humanize-integration.md`).
  142. Never promise that a rewrite evades AI detectors; detector vendors now
  143. target "humanized" text. Substance and the author's real voice are what
  144. both readers and platform classifiers reward.
  145. ## Refinement passes
  146. Attack the draft once per pass and revise before the next. Details and
  147. thumbnail-specific passes: `references/refinement-protocol.md`.
  148. 1. **Skeptic:** Why should I care? What is actually new?
  149. 2. **Expert:** Is every claim accurate? What would an expert nitpick?
  150. 3. **Scroller:** Would I stop for this first line?
  151. 4. **Competitor:** How is this different from the last ten similar posts?
  152. 5. **Editor:** What can go without losing meaning? Cut about 20%.
  153. Stop when a full pass produces no change.
  154. ## Ethics and disclosure
  155. Use this skill to sharpen the author's own ideas. Refuse astroturfing,
  156. coordinated inauthentic behavior, misinformation, impersonation, fake
  157. reviews or testimonials, and invented personal experiences.
  158. Disclosure, as of November 2026:
  159. - **Paid or sponsored content:** always disclose.
  160. - **EU audiences, public-interest topics** (politics, health, economics):
  161. EU AI Act Article 50 applies from 2026-08-02. Either a named person edits
  162. substantively and takes editorial responsibility, or the post carries an
  163. AI label.
  164. - **Realistic AI images, audio or video:** label them (YouTube, TikTok,
  165. India, South Korea; New York for ads with synthetic performers).
  166. - **LinkedIn:** disclose substantial AI involvement when it is not apparent.
  167. - **Reddit:** follow the subreddit's rule.
  168. State in the hand-back which rule applies. Full table:
  169. `references/platform-updates-2026.md`.
  170. ## Example
  171. **Before (reads as AI):**
  172. ```
  173. I'm excited to share a revolutionary productivity hack that will change
  174. your workflow forever. Here's the thing: most people waste hours on email.
  175. Let's dive into how inbox zero can transform your day. First, batch
  176. process. Second, use templates. Finally, schedule check-ins. What do you
  177. think?
  178. ```
  179. **After (human, specific):**
  180. ```
  181. Email before noon is self-sabotage. I tested it for 3 weeks: no inbox
  182. until 2pm. My deep-work hours went from 2 to 4+. That 7:47am Slack ping?
  183. Not your fire. Morning brain builds. Afternoon brain reacts. Flip the
  184. order and you stop playing defense. Two inbox windows, 2pm and 5pm,
  185. handle everything that matters.
  186. ```
  187. What changed: enthusiasm, transition and list-scaffold tells removed;
  188. engagement bait replaced by a statement; real numbers added (3 weeks, 2 to
  189. 4+ hours, 7:47am); sentence length varied from 3 to 12 words; conviction
  190. opener instead of an announcement.
  191. ## Reference files
  192. Load only what the current step needs.
  193. | File | Contents | Load when |
  194. |---|---|---|
  195. | `references/platform-updates-2026.md` | Dated 2026 ranking, anti-AI and disclosure changes with sources | Steps 2 and 8, always for public posts |
  196. | `references/ai-tells.md` | 100+ tells: current-model table, classic tells, platform, video and thumbnail tells | Step 5 |
  197. | `references/platform-templates.md` | Templates and examples for 8 platforms | Step 4 |
  198. | `references/refinement-protocol.md` | Adversarial passes for text and thumbnails | Step 6 |
  199. | `references/viral-titles.md` | Title psychology, formulas and scoring | Titles |
  200. | `references/title-formulas.md` | 50+ title formulas with examples | Titles |
  201. | `references/viral-thumbnails.md` | Thumbnail psychology, design and AI prompts | Thumbnails |
  202. | `references/thumbnail-checklist.md` | Quick thumbnail checklist | Thumbnails |
  203. | `references/research-statistics.md` | Research data, including 2026 studies that supersede older rules | Justifying a choice |
  204. | `references/humanize-integration.md` | Handing off to the humanize-writing skill | Step 5 voice pass |
  205. | `references/cross-platform-adaptation.md` | One piece adapted to several platforms | Multi-platform requests |
  206. | `references/trend-intelligence.md` | Finding a topic when the user has none | No topic given |
  207. | `references/feedback-loop.md` | Tracking engagement over time | User wants to learn from results |
README.md · README · 104 lines
  1. # create-viral-content
  2. <p align="center">
  3. <img src="https://img.shields.io/github/stars/aaaronmiller/create-viral-content?style=for-the-badge&color=f59e0b" alt="Stars">
  4. <img src="https://img.shields.io/badge/Agent%20Skill-v3.0.0-8b5cf6?style=for-the-badge" alt="Agent Skill v3.0.0">
  5. <img src="https://img.shields.io/badge/Platforms-Reddit%20%C2%B7%20X%20%C2%B7%20LinkedIn%20%C2%B7%20YouTube%20%C2%B7%20TikTok-0ea5e9?style=for-the-badge" alt="Platforms">
  6. </p>
  7. An Agent Skill that turns a draft or a brief into social content that spreads
  8. and reads as written by a person with a point of view. It covers hooks,
  9. platform rules, titles and thumbnails, AI-tell removal, adversarial
  10. refinement and AI-disclosure rules, updated for the platform changes of
  11. June to November 2026.
  12. ## Install
  13. The skill is a folder named `create-viral-content` containing `SKILL.md` and
  14. `references/`. Every platform below needs the folder name to stay exactly
  15. `create-viral-content`.
  16. **claude.ai (web and desktop).** Download `create-viral-content.zip` from the
  17. [latest release](https://github.com/aaaronmiller/create-viral-content/releases/latest)
  18. and upload it under Settings, Capabilities, Skills. To build the zip
  19. yourself instead, its single top-level folder must be `create-viral-content`:
  20. ```bash
  21. git clone https://github.com/aaaronmiller/create-viral-content
  22. cd create-viral-content && git archive --prefix=create-viral-content/ -o ../create-viral-content.zip HEAD
  23. ```
  24. Do not upload GitHub's "Download ZIP" archive: it wraps the files in
  25. `create-viral-content-main/`, and the folder name must match the skill name.
  26. **Claude Code.**
  27. ```bash
  28. git clone https://github.com/aaaronmiller/create-viral-content ~/.claude/skills/create-viral-content
  29. ```
  30. **Codex, Gemini CLI, opencode, Qwen Code, Cursor, Kilo** (shared user-level
  31. skills folder):
  32. ```bash
  33. git clone https://github.com/aaaronmiller/create-viral-content ~/.agents/skills/create-viral-content
  34. ```
  35. **Antigravity:** clone into `~/.gemini/config/skills/create-viral-content`.
  36. **Claude API and OpenAI API:** upload the same zip as a skill bundle.
  37. ## Use
  38. ```
  39. Write a LinkedIn post about [topic]. I ran [experiment] for [time] and
  40. [result]. Audience: [who].
  41. ```
  42. ```
  43. Give me 10 YouTube title and thumbnail-text variants for a video about
  44. [topic]. The video shows [what it delivers].
  45. ```
  46. The skill runs an eight-step workflow: pin the brief and the author's own
  47. stake, check platform rules, draft hooks, draft the body, remove AI tells,
  48. run five refinement passes, package variants, and check disclosure.
  49. ## Files
  50. | File | Purpose |
  51. |---|---|
  52. | `SKILL.md` | Workflow, platform rules, hooks, titles, top AI tells, ethics and disclosure |
  53. | `references/platform-updates-2026.md` | Dated 2026 ranking, anti-AI and disclosure changes with sources |
  54. | `references/ai-tells.md` | 100+ AI tells, including current-model tells (2026) |
  55. | `references/platform-templates.md` | Templates for Reddit, X, LinkedIn, YouTube, TikTok, Instagram, email |
  56. | `references/refinement-protocol.md` | Adversarial passes for text and thumbnails |
  57. | `references/viral-titles.md`, `references/title-formulas.md` | Title psychology and 50+ formulas |
  58. | `references/viral-thumbnails.md`, `references/thumbnail-checklist.md` | Thumbnail design and checklist |
  59. | `references/research-statistics.md` | Research data, with 2026 studies that supersede older rules |
  60. | `references/humanize-integration.md` | Hand-off to the humanize-writing skill |
  61. | `references/cross-platform-adaptation.md` | One piece across several platforms |
  62. | `references/trend-intelligence.md` | Finding a topic when you have none |
  63. | `references/feedback-loop.md` | Tracking results over time |
  64. | `CHANGELOG.md` | Version history |
  65. | `marketplace.json` | Marketplace manifest |
  66. ## Optional companion
  67. [humanize-writing](https://github.com/aaaronmiller/custom-skills/tree/main/humanize-writing)
  68. adds a voice-polish pass. Without it, the skill uses its built-in checklist.
  69. ## Ethics
  70. Use it to sharpen your own ideas. It refuses astroturfing, misinformation,
  71. impersonation, fake reviews and invented personal experiences, and it tells
  72. you which AI-disclosure rule applies (including EU AI Act Article 50 for
  73. public-interest content from 2026-08-02).
  74. ## Version
  75. | Field | Value |
  76. |---|---|
  77. | Version | 3.0.0 |
  78. | Updated | 2026-11-10 |
  79. | Author | ice-ninja |
  80. | License | MIT |
  81. | Format | Agent Skills (SKILL.md with name, description, license, metadata) |
  82. Issues and suggestions: open an issue on this repository.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.