Skip to content
Back to search

head-of-content

SkillWorks with Claude CodeGitHub

Social media content research and marketing skills for Claude Code and Cowork

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/bradautomates-head-of-content/badge.svg)](/listings/bradautomates-head-of-content)

HTML

<a href="/listings/bradautomates-head-of-content"><img src="/api/listings/bradautomates-head-of-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.

1. Clone the Repository

git clone https://github.com/bradautomates/head-of-content.git
cd head-of-content

2. Set Up Your Environment

Copy the example environment file and add your API keys (see [API Keys Setup](#api-keys-setup) below):

cp .env.example .env

Then edit `.env` with your API keys.

3. Open in Claude Desktop

1. Open **Claude Desktop** 2. Click the **Claude Coworker** tab the in sidebar 3. At the bottom of the panel, click **Work in a folder** 4. Select your `head-of-content` folder

4. Install the Skills

The repository includes 6 `.skill` files that need to be added to Claude Desktop:

1. In Claude Desktop, go to **Settings** (gear icon) 2. Click **Capabilities** 3. Click **Skills** 4. Click **Add Skill** 5. Upload each `.skill` file from your `head-of-content` folder: - `x-research.skill` - `instagram-research.skill` - `youtube-research.skill` - `tiktok-research.skill` - `video-content-analyzer.skill` - `content-planner.skill`

Repeat the "Add Skill" process for each file.

---

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.

README.md · README · 413 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Claude Cowork - Head of Content
  2. > Your AI-powered content research coworker. Stop guessing what content works—let Claude research, analyze, and surface winning patterns across X/Twitter, Instagram, YouTube, and TikTok.
  3. >
  4. > Check out this [YouTube video](https://www.youtube.com/@bradbonanno) where we walk through setting up and using Head of Content.
  5. <img src="images/claude-cowork.png" alt="Head of Content - Claude Cowork" width="800">
  6. A [Claude Cowork](https://docs.anthropic.com/en/docs/claude-code/claude-cowork) skill set that automates social media content research—identifying high-performing content, analyzing viral patterns with AI, and generating actionable content strategies.
  7. ## Get Your API Keys
  8. | Service | What It Powers | Sign Up |
  9. |---------|----------------|---------|
  10. | **Apify** | X/Twitter, Instagram, TikTok scraping | [Sign up for Apify](https://console.apify.com/?fpr=ih20xe) |
  11. | **TubeLab** | YouTube outlier detection | [Sign up for TubeLab](https://tubelab.net/?ref=brad) |
  12. ## What This Does
  13. - **Research high-performing content** across 4 major platforms
  14. - **Identify statistical outliers** using engagement scoring algorithms
  15. - **Analyze videos with AI** to extract hooks, structure, and replicable patterns
  16. - **Generate content plans** with cross-platform opportunity scoring
  17. - **Create platform playbooks** with specific recommendations
  18. ## Prerequisites
  19. - **macOS** (required for Claude CoWork)
  20. - **Claude Max Plan** (required for custom skills)
  21. - **Claude Desktop** installed
  22. - **Python 3.8+** with pip
  23. ---
  24. ## Quick Start
  25. ### 1. Clone the Repository
  26. ```bash
  27. git clone https://github.com/bradautomates/head-of-content.git
  28. cd head-of-content
  29. ```
  30. ### 2. Set Up Your Environment
  31. Copy the example environment file and add your API keys (see [API Keys Setup](#api-keys-setup) below):
  32. ```bash
  33. cp .env.example .env
  34. ```
  35. Then edit `.env` with your API keys.
  36. ### 3. Open in Claude Desktop
  37. 1. Open **Claude Desktop**
  38. 2. Click the **Claude Coworker** tab the in sidebar
  39. 3. At the bottom of the panel, click **Work in a folder**
  40. 4. Select your `head-of-content` folder
  41. ### 4. Install the Skills
  42. The repository includes 6 `.skill` files that need to be added to Claude Desktop:
  43. 1. In Claude Desktop, go to **Settings** (gear icon)
  44. 2. Click **Capabilities**
  45. 3. Click **Skills**
  46. 4. Click **Add Skill**
  47. 5. Upload each `.skill` file from your `head-of-content` folder:
  48. - `x-research.skill`
  49. - `instagram-research.skill`
  50. - `youtube-research.skill`
  51. - `tiktok-research.skill`
  52. - `video-content-analyzer.skill`
  53. - `content-planner.skill`
  54. Repeat the "Add Skill" process for each file.
  55. ---
  56. ## API Keys Setup
  57. This repository requires 3 API keys.
  58. ### Apify (X/Twitter, Instagram, TikTok)
  59. Apify powers the social media scraping for X, Instagram, and TikTok.
  60. **Actors used:**
  61. - [Tweet Scraper V2](https://apify.com/apidojo/tweet-scraper?fpr=ih20xe) - X/Twitter posts and profiles
  62. - [Instagram Scraper](https://apify.com/apify/instagram-scraper?fpr=ih20xe) - Instagram posts and reels
  63. - [TikTok Scraper](https://apify.com/clockworks/tiktok-scraper?fpr=ih20xe) - TikTok videos and profiles
  64. **Setup:**
  65. 1. Go to [console.apify.com](https://console.apify.com/?fpr=ih20xe)
  66. 2. Click **Sign Up** (A paid subscription is required for the X scraper to function as expected)
  67. 3. After signing in, go to **Settings** > **Integrations**
  68. 4. Copy your **Personal API Token**
  69. **Cost:** Free tier includes $5/month. Research runs typically cost $0.10-$0.50 depending on volume.
  70. ### TubeLab (YouTube)
  71. TubeLab provides YouTube outlier detection and video intelligence.
  72. **APIs used:**
  73. - [Outliers API](https://tubelab.net/docs/api/reference/search-outliers?ref=brad) - Find viral videos in any niche
  74. - [Transcripts API](https://tubelab.net/docs/api/reference/get-video-transcript?ref=brad) - Get video transcripts
  75. **Setup:**
  76. 1. Go to [tubelab.net](https://tubelab.net/?ref=brad)
  77. 2. Click **Sign Up** and create an account
  78. 3. Go to **Settings** > **API** (or visit [tubelab.net/settings/api](https://tubelab.net/settings/api?ref=brad))
  79. 4. Generate and copy your **API Key**
  80. **Cost:** Free tier available. Paid plans start at ~$29/month for higher limits.
  81. ### Google Gemini (Video Analysis)
  82. Gemini AI analyzes video content to extract hooks, patterns, and structure.
  83. 1. Go to [aistudio.google.com](https://aistudio.google.com/)
  84. 2. Sign in with your Google account
  85. 3. Click **Get API Key** (or visit [aistudio.google.com/apikey](https://aistudio.google.com/apikey))
  86. 4. Click **Create API Key** and copy it
  87. **Cost:** Free tier includes 60 requests/minute. More than enough for research.
  88. ---
  89. ## Environment Setup
  90. ### Create Your .env File
  91. Copy the example environment file:
  92. ```bash
  93. cp .env.example .env
  94. ```
  95. Open `.env` in your editor and add your API keys:
  96. ```bash
  97. # YouTube Research - TubeLab API
  98. TUBELAB_API_KEY=your-tubelab-api-key-here
  99. # X/Twitter, Instagram, TikTok Research - Apify API
  100. APIFY_TOKEN=your-apify-token-here
  101. # Video Analysis - Gemini API
  102. GEMINI_API_KEY=your-gemini-api-key-here
  103. ```
  104. ### Verify Setup
  105. Test that your environment is configured correctly:
  106. ```bash
  107. # Load environment variables
  108. export $(cat .env | grep -v '^#' | xargs)
  109. # Verify they're set
  110. echo "Apify: ${APIFY_TOKEN:0:10}..."
  111. echo "TubeLab: ${TUBELAB_API_KEY:0:10}..."
  112. echo "Gemini: ${GEMINI_API_KEY:0:10}..."
  113. ```
  114. ---
  115. ## Configure Your Research Targets
  116. Before running research, configure which accounts to track in `.claude/context/`:
  117. ### X/Twitter Accounts
  118. Edit `.claude/context/x-accounts.md`:
  119. ```markdown
  120. # X/Twitter Accounts to Track
  121. | Username | Niche | Notes |
  122. |----------|-------|-------|
  123. | @levelsio | indie hacking | bootstrapped founder, viral tweets |
  124. | @naval | philosophy/startups | high engagement threads |
  125. | @sahaborhani | AI/tech | technical content |
  126. ```
  127. ### Instagram Accounts
  128. Edit `.claude/context/instagram-accounts.md`:
  129. ```markdown
  130. # Instagram Accounts to Track
  131. | Username | Niche | Notes |
  132. |----------|-------|-------|
  133. | @garyvee | marketing | high volume, reels focus |
  134. | @hormozi | business | educational content |
  135. ```
  136. ### TikTok Accounts
  137. Edit `.claude/context/tiktok-accounts.md`:
  138. ```markdown
  139. # TikTok Accounts to Track
  140. | Username | Niche | Notes |
  141. |----------|-------|-------|
  142. | @garyvee | marketing | cross-platform content |
  143. | @tiktokcreators | meta/tips | platform trends |
  144. ```
  145. ### YouTube Channel (Your Channel)
  146. Edit `.claude/context/youtube-channel.md` with your channel info:
  147. ```markdown
  148. # YouTube Channel Context
  149. ## Channel Information
  150. - **Channel Name:** Your Channel Name
  151. - **Channel Handle:** @yourhandle
  152. - **Channel ID:** UCxxxxxxxxxxxxxxxxxx
  153. ## Niche & Positioning
  154. - **Primary Niche:** Your niche
  155. - **Content Style:** Your style
  156. - **Target Audience:** Your audience
  157. ## Content Strategy
  158. - **Typical Video Length:** 10-20mins
  159. - **Upload Frequency:** Weekly
  160. - **Best Performing Topics:** Your best topics
  161. ## Goals
  162. - **Growth Targets:** Your subscriber goal
  163. - **Content Goals:** Your content goals
  164. ```
  165. ---
  166. ## Available Skills
  167. Once connected, these skills are available in Claude Desktop:
  168. | Command | Description |
  169. |---------|-------------|
  170. | `/x-research` | Research X/Twitter content |
  171. | `/instagram-research` | Research Instagram reels and posts |
  172. | `/youtube-research` | Find YouTube outliers in your niche |
  173. | `/tiktok-research` | Research TikTok videos |
  174. | `/content-planner` | Run all research + create content plan |
  175. Type `/` in the chat to see all available skills.
  176. ---
  177. ## Usage
  178. ### Run Individual Platform Research
  179. In Claude Desktop, simply invoke the skill:
  180. ```
  181. Run x-research
  182. ```
  183. This will:
  184. 1. Fetch recent content from your tracked accounts
  185. 2. Calculate engagement scores and identify outliers
  186. 3. Analyze top videos with AI (if applicable)
  187. 4. Generate a report in `x-research/YYYY-MM-DD_HHMMSS/`
  188. ### Run Full Content Planning
  189. For comprehensive cross-platform research:
  190. ```
  191. Run content-planner
  192. ```
  193. This will:
  194. 1. Run all 4 platform research skills in parallel
  195. 2. Aggregate findings across platforms
  196. 3. Identify cross-platform content opportunities
  197. 4. Generate platform-specific playbooks
  198. 5. Output everything to `content-plans/YYYY-MM-DD_HHMMSS/`
  199. ### Natural Language
  200. You can also just ask Claude:
  201. - "Research what's performing on X right now"
  202. - "Find trending content in my Instagram niche"
  203. - "Create a content plan for next week"
  204. - "What videos are going viral on TikTok?"
  205. ---
  206. ## Output Structure
  207. ### Platform Research Output
  208. Each research run creates a timestamped folder:
  209. ```
  210. x-research/2024-01-15_143022/
  211. ├── raw.json # Raw API data
  212. ├── outliers.json # Identified outliers with metrics
  213. ├── video-analysis.json # AI-extracted patterns (if videos)
  214. └── report.md # Human-readable summary
  215. ```
  216. ### Content Plan Output
  217. ```
  218. content-plans/2024-01-15_143022/
  219. ├── content-ideas.md # Cross-platform content opportunities
  220. ├── x-playbook.md # X/Twitter specific intelligence
  221. ├── instagram-playbook.md # Instagram specific intelligence
  222. ├── youtube-playbook.md # YouTube specific intelligence
  223. └── tiktok-playbook.md # TikTok specific intelligence
  224. ```
  225. ---
  226. ## Engagement Scoring
  227. Each platform uses optimized engagement weights:
  228. ### X/Twitter
  229. | Signal | Weight | Why |
  230. |--------|--------|-----|
  231. | Bookmarks | 4x | Strongest intent signal |
  232. | Replies | 3x | Conversation starter |
  233. | Retweets | 2x | Amplification |
  234. | Quotes | 2x | Commentary |
  235. | Likes | 1x | Passive approval |
  236. ### Instagram
  237. ```
  238. engagement = likes + (3 × comments) + (0.1 × views)
  239. ```
  240. ### TikTok
  241. ```
  242. engagement = likes + (3 × comments) + (2 × shares) + (2 × saves) + (0.05 × views)
  243. ```
  244. ### YouTube
  245. ```
  246. score = zScore × recency_boost (5% daily decay)
  247. ```
  248. **Outlier threshold:** Content scoring above `mean + (2.0 × std_dev)` is flagged as an outlier.
  249. ---
  250. ## Troubleshooting
  251. ### "API key not found" errors
  252. ```bash
  253. # Make sure .env exists and has your keys
  254. cat .env
  255. # Load environment variables before running
  256. export $(cat .env | grep -v '^#' | xargs)
  257. ```
  258. ### "No accounts configured" warnings
  259. Make sure you've added accounts to track in `.claude/context/`:
  260. - `x-accounts.md`
  261. - `instagram-accounts.md`
  262. - `tiktok-accounts.md`
  263. ### Cowork not showing in Claude Desktop
  264. 1. Verify you're on the **Claude Max plan**
  265. 2. Update and restart Claude Desktop
  266. ### Apify rate limits
  267. The free Apify tier has usage limits. If you hit them:
  268. - Reduce the number of accounts tracked
  269. - Increase time between research runs
  270. - Consider upgrading your Apify plan
  271. ---
  272. ## License
  273. MIT License - Feel free to modify and distribute.
  274. ---
  275. ## Contributing
  276. Contributions welcome! To add new skills or improve existing ones:
  277. 1. Fork the repository
  278. 2. Use `/skill-creator` to scaffold new skills
  279. 3. Follow the patterns in existing skills
  280. 4. Submit a pull request
  281. ---
  282. ## Implement AI in Your Business
  283. > Practical AI implementation for real business results
  284. Learn how to implement AI tools and workflows that actually move the needle for your business on my [YouTube channel](https://www.youtube.com/@bradbonanno).
  285. Follow [@corpcowboy_](https://x.com/corpcowboy_) on X

Ratings and comments

Sign in to rate this skill.

Sign in

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