This is a full research pipeline for identifying what's actually working on TikTok right now. You point it at competitor accounts, it pulls recent videos via Apify, runs statistical analysis to find outliers (anything performing above mean plus 2 standard deviations), then uses AI to extract the actual hook formulas and content patterns from the top 5 videos. The output is a structured report with replicable techniques, not just metrics. It's legitimately useful if you're trying to reverse engineer viral content in a niche, though you'll need both Apify and Gemini API keys. The engagement scoring formula weights comments and shares heavily, which feels right for TikTok's algorithm.

skills.sh installs
1.2K
GitHub stars
309
last updated
Aug 21, 2026

Install

$ npx -y skills add bradautomates/head-of-content --skill tiktok-research --agent claude-code

Installs into .claude/skills of the current project.

Files

TikTok Research

Research high-performing TikTok videos, identify outliers, and analyze top video content for hooks and structure.

Prerequisites

  • APIFY_TOKEN environment variable or in .env
  • GEMINI_API_KEY environment variable or in .env
  • apify-client and google-genai Python packages
  • Accounts configured in .claude/context/tiktok-accounts.md

Verify setup:

python3 -c "
import os
try:
    from dotenv import load_dotenv
    load_dotenv()
except ImportError:
    pass
from apify_client import ApifyClient
from google import genai
assert os.environ.get('APIFY_TOKEN'), 'APIFY_TOKEN not set'
assert os.environ.get('GEMINI_API_KEY'), 'GEMINI_API_KEY not set'
" && echo "Prerequisites OK"

Workflow

1. Create Run Folder

RUN_FOLDER="tiktok-research/$(date +%Y-%m-%d_%H%M%S)" && mkdir -p "$RUN_FOLDER" && echo "$RUN_FOLDER"

2. Fetch Content

python3 .claude/skills/tiktok-research/scripts/fetch_tiktok.py \
  --days 30 \
  --limit 50 \
  --sorting latest \
  --output {RUN_FOLDER}/raw.json

Sponsors

Details

Repository
github.com/bradautomates/head-of-content
Categories
Frontend Development, Data Science & ML
First seen
Apr 16, 2026

More from bradautomates/head-of-content

All 4
1vtex avatarvtex-io-app-settingsvtex/skillsApply when defining, validating, or consuming VTEX IO app settings. Covers settingsSchema, app-level configuration boundaries, and how backend or frontend code 1.2Kskills.sh installs
2customware-ai avatarcpq-buildercustomware-ai/skillsConfigure-Price-Quote (CPQ) vertical skill for the Customware SPA. Defines patterns, minimum standards, layout patterns, lifecycle indicators, product configura1.2Kskills.sh installs
3software-mansion-labs avatarexpo-horizonsoftware-mansion-labs/skillsSoftware Mansion's guide for migrating Expo SDK apps to Meta Quest using expo-horizon packages. Use when adding Meta Quest or Meta Horizon OS support to an exis1.2Kskills.sh installs
4cursor avatarcreate-plugin-scaffoldcursor/pluginsCreate a new Cursor plugin scaffold with a valid manifest, component directories, and marketplace wiring.1.2Kskills.sh installs
5llama-farm avatarcode-reviewllama-farm/llamafarmComprehensive code review for diffs. Analyzes changed code for security vulnerabilities, anti-patterns, and quality issues. Auto-detects domain (frontend/backen1.2Kskills.sh installs
6neolabhq avatarcreate-hookneolabhq/context-engineering-kitCreate and configure git hooks with intelligent project analysis, suggestions, and automated testing1.2Kskills.sh installs