Skip to content

aaaronmiller/create-viral-content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Viral Content Deliberative Refinement - Complete Package

Transform complex ideas into content that spreads. This skill codifies the refinement process that separates forgettable posts from ones that generate discussion, shares, and action.

What You're Getting

A production-ready system for creating viral social content across all major platforms, with integrated AI tell detection and humanization.


File Manifest

Core Files

File Size Purpose
SKILL.md ~11 KB Complete viral content framework
README.md This file Package overview
marketplace.json ~1 KB Anthropic marketplace manifest
VALIDATION-REPORT.md ~15 KB 10-persona adversarial validation

Resources (resources/ folder)

File Purpose
ai-tells.md Comprehensive AI detection guide with human alternatives
platform-templates.md Platform-specific templates (Reddit, LinkedIn, Twitter, YouTube, TikTok, Email)
refinement-protocol.md Adversarial refinement passes for text and thumbnails
humanize-integration.md Integration with humanize-writing skill
viral-titles.md Title psychology, formulas, and scoring
viral-thumbnails.md Thumbnail design psychology and checklist
NEW research-statistics.md Consolidated data from 40 research sources
NEW title-formulas.md 50+ title formulas with examples
NEW thumbnail-checklist.md Quick-reference thumbnail design checklist

Quick Start

Installation

Claude Code:

/plugin install viral-content-forge

Claude.ai:

  1. Create new Project
  2. Upload SKILL.md to Project Knowledge
  3. Optionally add resource files

Basic Usage

Create a viral Reddit post about [TOPIC].
Platform: r/MachineLearning
Target: technical audience who appreciates practical insights

Integration with humanize-writing Skill

This skill integrates with the humanize-writing skill for the final polish pass. When both skills are installed, viral-content-forge automatically invokes humanize-writing to:

  • Remove AI vocabulary tells
  • Ensure natural sentence rhythm
  • Maintain viral hooks while sounding human

Manual Fallback

If humanize-writing is unavailable, the skill includes a built-in humanization checklist.


Key Features

Hook Architecture

  • Prediction + Stakes patterns
  • Tribal Identity Split patterns
  • Before/After Compression patterns

Platform Optimization

  • Reddit (subreddit-specific calibration)
  • Twitter/X threads
  • LinkedIn posts
  • YouTube comments
  • Hacker News

AI Tell Detection

  • 100+ AI tells with replacements (text, video, thumbnail)
  • Platform-specific tells (TikTok, LinkedIn, Reddit, Email)
  • Video script tells
  • Thumbnail text tells

Refinement Protocol

Six adversarial passes:

  1. The Skeptic
  2. The Expert
  3. The Scroller
  4. The Competitor
  5. The Editor
  6. NEW Thumbnail-specific passes

Research Basis

40 documented sources including:

  • BuzzSumo (100M headlines)
  • Netflix thumbnail personalization
  • Outbrain negative superlatives study
  • Academic viral content research

Examples

Before (AI-generated):

I'm excited to share a revolutionary new approach to prompt engineering. Here's the thing: traditional single-pass prompting is limited...

After (humanized viral):

I think deliberative refinement is the 2026 prompt technique that matters most. The core idea: you don't ask AI for an answer—you make it defend one...


Ethical Framework

Do: Polish your own ideas, convert expertise to accessible content, learn viral mechanics

Don't: Astroturf, spread misinformation, impersonate others, engagement farm without substance


Version & Compatibility

Field Value
Version 2.0.0
Created December 2025
Updated December 2025
Author Ice-ninja
License MIT
Compatibility Claude.ai, Claude Code, Claude API
Research Sources 40 documented

Dependencies

  • Optional: humanize-writing skill (for enhanced humanization pass)

Support

For issues or feature requests, open an issue on the GitHub repository.

About

Claude Code Skill file to assist in creating social media content so that it recieves upvotes/goes viral.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors