Skip to content
Back to search

marketing-skill

Marketing skills for Claude Code: AI competitor research, content calendars, social posts, SEO briefs, ad copy, email sequences, cold outreach, short-form video scripts and rendered videos, montages from your own videos or photos, community posts, and approval-gated publishing.

Safety scan

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

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/marcosmodly/marketing-skill with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/marcosmodly/marketing-skill'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/marcosmodly--marketing-skill/badge.svg)](/listings/marcosmodly--marketing-skill)

HTML

<a href="/listings/marcosmodly--marketing-skill"><img src="/api/listings/marcosmodly--marketing-skill/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.

**Plugin method (recommended):**

claude plugin marketplace add marcosmodly/marketing-skill
claude plugin install marketing-skill@marketing-skill

This works once the plugin's branch is merged to the repo's default branch, since `marketplace add` tracks a repo's default branch. To try it before merging (e.g. against a feature branch), clone the repo locally and point at your checkout instead — this is verified to work regardless of which branch is checked out:

git clone https://github.com/marcosmodly/marketing-skill.git
cd marketing-skill && git checkout <branch-name>   # if not already on it
claude plugin marketplace add ./
claude plugin install marketing-skill@marketing-skill

**Manual fallback:** no confirmed minimum Claude Code version exists for the plugin system — if `claude plugin` isn't available on your install (check with `claude plugin --help`), copy the skills in by hand instead:

cp -r skills/* ~/.claude/skills/        # personal, all projects
# or
cp -r skills/* /your/project/.claude/skills/   # project-scoped

The manual copy skips the setup command (see "Configure" below for the equivalent manual step) and `${CLAUDE_PLUGIN_ROOT}` path substitution. Copied skills can't find `references/`, `state/`, or `scripts/` on their own, so set `CLAUDE_PLUGIN_ROOT` to your clone of this repo before starting Claude Code (`export CLAUDE_PLUGIN_ROOT=/path/to/marketing-skill`); otherwise each skill asks you where the plugin lives.

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.

.claude-plugin/marketplace.json · Manifest · 39 lines

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

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "marketing-skill",
  3. "description": "Marketing skills for Claude Code: AI competitor research, content calendars, social posts, SEO briefs, ad copy, email sequences, cold outreach, short-form video scripts and rendered videos, montages from your own videos or photos, community posts, and approval-gated publishing.",
  4. "owner": {
  5. "name": "marcosmodly",
  6. "url": "https://github.com/marcosmodly"
  7. },
  8. "plugins": [
  9. {
  10. "name": "marketing-skill",
  11. "displayName": "Marketing Skills",
  12. "source": ".",
  13. "description": "14 AI marketing skills for Claude Code: competitor research, social media content calendars, LinkedIn/X/newsletter repurposing, SEO content briefs, Meta/Google/LinkedIn ad copy, email drip sequences, personalized cold email outreach, TikTok/Reels/YouTube Shorts scripts and rendered videos (marketing types and everyday memeable formats), montages edited from your own videos or photos, rules-aware Reddit/Product Hunt/Hacker News/Discord posts, visual briefs, and approval-gated publishing to n8n, Make, or platform APIs.",
  14. "category": "marketing",
  15. "tags": [
  16. "marketing",
  17. "content-marketing",
  18. "social-media",
  19. "seo",
  20. "copywriting",
  21. "ad-copy",
  22. "email-marketing",
  23. "cold-email",
  24. "content-calendar",
  25. "competitor-analysis",
  26. "short-form-video",
  27. "community-marketing",
  28. "marketing-automation"
  29. ],
  30. "author": {
  31. "name": "marcosmodly",
  32. "url": "https://github.com/marcosmodly"
  33. },
  34. "homepage": "https://github.com/marcosmodly/marketing-skill",
  35. "repository": "https://github.com/marcosmodly/marketing-skill",
  36. "license": "MIT"
  37. }
  38. ]
  39. }
README.md · README · 615 lines

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

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Marketing Skills for Claude Code
  2. **14 AI marketing skills in one Claude Code plugin:** competitor research,
  3. social media content calendars, LinkedIn and X posts, SEO content briefs,
  4. ad copy, email sequences, personalized cold email outreach, TikTok / Reels /
  5. YouTube Shorts scripts, montages edited from your own videos or photos,
  6. Reddit and Hacker News posts, and approval-gated publishing to n8n, Make,
  7. or platform APIs.
  8. [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
  9. [![Claude Code plugin](https://img.shields.io/badge/Claude%20Code-plugin-D97757.svg)](#install)
  10. [![Agent Skills](https://img.shields.io/badge/Agent%20Skills-SKILL.md-555.svg)](skills/)
  11. ```
  12. claude plugin marketplace add marcosmodly/marketing-skill
  13. claude plugin install marketing-skill@marketing-skill
  14. ```
  15. Every skill is a standard `SKILL.md` in [`skills/`](skills/), shares one
  16. brand-voice config, and works on its own or chained together. Nothing
  17. posts or sends without your explicit approval. Using OpenAI Codex? See
  18. [Using with Codex](#using-with-codex).
  19. If it saves you time, a star on the repo helps other people find it.
  20. Made something with it? [Share it in Show and tell](https://github.com/marcosmodly/marketing-skill/discussions/categories/show-and-tell).
  21. ## See it
  22. [![The plugin's 78-second launch video: a desk at night, the camera pushing into the monitor, Claude asking what you've got before a video, a realistic character in the mascot's place, and Claude reading how a reference video is edited](media/explainer/v4/poster-landscape.jpg)](media/explainer/v4/marketing-skill-v4-landscape.mp4)
  23. **[▶ Watch the 78-second launch video](media/explainer/v4/marketing-skill-v4-landscape.mp4)**:
  24. the plugin installing and running its skills in Claude Code, the
  25. questions it asks before a video (where you post, who presents, a video
  26. you like, the tools you pay for), your own character in the mascot's
  27. place, and Claude copying how a video you like is edited, all cut like a
  28. product launch, with one camera moving from screen to screen. The plugin
  29. made it itself from [one script](media/explainer/v4/script.md), with a
  30. voiceover, subtitles synced to it, and music cut on the beat.
  31. [![The vertical cut for TikTok, Reels, and Shorts: the plugin's 3D mascot at a desk, on a stage, on a rooftop, in a living room, and in a park, under big bold captions](media/explainer/v3/poster.jpg)](media/explainer/v3/marketing-skill-v3.mp4)
  32. **[▶ Watch the vertical cut](media/explainer/v3/marketing-skill-v3.mp4)**
  33. (9:16, for TikTok, Reels, and Shorts): the plugin's 3D mascot presenting
  34. all fourteen skills under the bold captions, made from
  35. [its own script](media/explainer/v3/script.md) the same way.
  36. [![Your own character in the mascot's place: a Mixamo character waving in a living room, a mannequin presenting on a stage, an expressive robot giving a thumbs up in a park, and the first character pointing at a product screen](media/explainer/character/poster.jpg)](media/explainer/character/your-own-character.mp4)
  37. **[▶ Watch: your own character](media/explainer/character/your-own-character.mp4)**
  38. (22 seconds): bring your mascot or avatar as a rigged 3D model (`.glb`)
  39. and it takes the robot's place, playing its own animations or posed from
  40. its skeleton, holding your product, and talking with the voice. Three
  41. different rigs, [one script](media/explainer/character/script.md).
  42. <sub>Music from #Uppbeat (free for Creators!): https://uppbeat.io/music/tracks/21-on-the-block/funky-diesel License code: WKCBH1LMDV3AQDIE · Voiceover: AI voice (Kokoro)</sub>
  43. 32 video templates, rendered on your machine with music composed in your
  44. brand's own sound. Each frame below is one template, mid-video:
  45. **Marketing videos** (ads, demos, narrated explainers, testimonials, FAQs, launches, team)
  46. ![Marketing templates](docs/gallery/marketing.jpg)
  47. **Everyday posts**: meme captions, comment bait, skits, and stories
  48. ![Meme caption templates](docs/gallery/meme-captions.jpg)
  49. ![Comment bait templates](docs/gallery/comment-bait.jpg)
  50. ![Skit and story templates](docs/gallery/skits-and-stories.jpg)
  51. **3D and pixel-art animation**, narrated, with captions synced to the voice.
  52. The 3D videos star your brand's mascot: it walks, waves, holds up your
  53. product, points at your screen, cheers, and lip-syncs to the voice.
  54. ![3D and pixel-art templates](docs/gallery/animation.jpg)
  55. The [earlier landscape explainer](media/explainer/marketing-skill-explainer.mp4)
  56. was made with the same renderer.
  57. ## What you can do with it
  58. - **Competitor analysis:** research a rival and get a SWOT, messaging
  59. breakdown, and sales battlecard with cited sources.
  60. - **Social media content calendar:** batch-write a week or month of dated
  61. posts for LinkedIn, Twitter/X, newsletters, Reddit, and short-form
  62. video, without repeating recent topics.
  63. - **Content repurposing:** turn one blog post or announcement into a
  64. LinkedIn post, an X thread, and a newsletter blurb.
  65. - **SEO content briefs:** target keyword, search intent, related keywords,
  66. outline, and meta title and description, with no made-up search volumes.
  67. - **Ad copy:** A/B-testable variants for Facebook and Instagram (Meta),
  68. Google Search (RSA), and LinkedIn Ads, sized to each platform's limits.
  69. - **Email marketing:** drip, nurture, and welcome sequences with timing,
  70. subject lines, and preview text.
  71. - **Cold email outreach:** a daily batch of researched, 1:1 personalized
  72. prospecting emails, written short with one ask and checked by
  73. `scripts/email_check.py` before they're queued, deduplicated against a
  74. permanent contact log that syncs replies, bounces, and unsubscribes
  75. from Gmail.
  76. - **Short-form video:** it starts by checking your project's own files
  77. and asking you to confirm what the project is and what the video is
  78. for, then writes hook-first scripts plus caption, hashtags, and
  79. best time to post for TikTok, Instagram Reels, and YouTube Shorts,
  80. shaped to the right type of marketing video (how-to, testimonial,
  81. launch, FAQ, and more) or to an everyday FYP format (POV, tier list,
  82. text-message skit, storytime, hot take, and 17 more). Also the finished
  83. vertical video itself, rendered on your machine: animated text over
  84. stock or AI backgrounds, a narrated 3D animation starring your brand's
  85. mascot (it moves, gestures, holds up your product, and lip-syncs), or
  86. pixel art, with a voiceover, music composed in your brand's own sound,
  87. and meme sound effects, cut in an editing style (UGC, kinetic
  88. typography, fast-paced, cinematic, or meme): a visual hook in the first
  89. half second, punch-ins on the words that sell it, whip pans, glitches,
  90. light leaks, and b-roll every few seconds. Hooks start from the video's
  91. job (the types that suit it, with templates) and are checked before
  92. anything renders: their type, all three layers (on screen, what's heard
  93. first, and what moves), whether three to test are really different, and
  94. which line keeps the hook's promise. A look sets one
  95. coherent visual style for the video's job (documentary, cinematic,
  96. editorial, tech, retro, and more), stock is picked for calm room behind
  97. the captions, and the check before rendering measures text contrast
  98. against the real picture. The bold look gives it a cover that stops the
  99. scroll: huge boxed captions with the selling words in yellow over your
  100. face (your app on the laptop in your photo) or the mascot.
  101. - **Montages from your own videos:** hand over the phone clips you or a
  102. client filmed (a home, a product, a shop, an event), plus your own
  103. music or voiceover if you have them, and get a finished vertical reel
  104. for free: the best moment of each clip, cuts on the beat, a clip's own
  105. sound where someone talks, synced captions, labels, and the client's
  106. logo and contact details on the end card. Only photos? Each photo moves
  107. like a camera through the room (in 3D, near things moving more than far
  108. ones), or, on a paid video-model plan you approve, gets AI camera moves.
  109. Then keep editing it ("use the part where she laughs", "kitchen first",
  110. "calmer music") version by version, with a saved profile per client.
  111. - **Community posts:** Reddit, Product Hunt, Hacker News (Show HN), Indie
  112. Hackers, dev.to, Discord, Slack, and Telegram posts written to each
  113. community's actual rules, with a Go/No-Go before drafting.
  114. - **Visual briefs:** shot lists, per-scene image/video prompts, and aspect
  115. ratios for any AI image or video generator.
  116. - **Publishing:** hand finished content to n8n, Make, or any webhook, or
  117. post directly to LinkedIn, X, Facebook, Reddit, Discord, Slack,
  118. Telegram, dev.to, YouTube, Instagram, or TikTok with your own API
  119. credentials.
  120. **[See a full worked run →](EXAMPLE.md)** — one continuous
  121. `full-pipeline` call from research to the approval checkpoint before
  122. anything actually publishes.
  123. ## Skills
  124. | Skill | Triggers on | Does |
  125. |---|---|---|
  126. | `competitor-research` | "research a competitor," "analyze a rival," "build a battlecard" | Full analytical competitor brief: overview, recent moves, messaging analysis, SWOT, recommendations, sources |
  127. | `content-calendar` | "content calendar," "a week of posts," "plan a month of content" | Batch-generates several dated, platform-tagged posts in one pass, checked against `state/content-calendar.md` so it doesn't repeat a recent topic; queues everything for approval, never sends |
  128. | `content-repurposer` | "repurpose this," "turn this into a LinkedIn post/thread/newsletter" | One source → a LinkedIn post, a Twitter/X thread, and a newsletter blurb, in one pass |
  129. | `seo-brief` | "SEO brief," "keyword research," "optimize this for search" | Target/secondary keywords, search intent, suggested outline, meta title/description — never fabricates search-volume numbers |
  130. | `ad-copy-generator` | "ad copy," "Meta/Google/LinkedIn ad variants," "A/B test copy" | Multiple ad variants per platform, each a distinct hook angle, sized to that platform's character limits |
  131. | `email-sequence` | "email sequence," "drip campaign," "welcome series" | A multi-email sequence with send timing, subject lines, and a real narrative arc across emails |
  132. | `email-outreach` | "cold outreach," "prospecting emails," "daily sales outreach," "personalized cold email to [name]" | Researches real prospects against a defined ICP (public-web research by default; a connected prospecting tool only if you ask for verified contact details), checks each one against a permanent contact log so nobody's contacted twice — or ever again once unsubscribed/replied — drafts a short, genuinely personalized email per prospect (one hook from their own research, one ask, follow-ups that say something new), checks every draft with `scripts/email_check.py`, never guesses an email address, re-confirms strategy monthly, and queues everything for approval (or drafts directly in Gmail if connected); sends nothing by default, or — if you choose a sending mode — the emails you approved, or all that pass the checks, at their send times |
  133. | `visual-brief-generator` | "visual brief," "video brief," "shot list," "image prompts for X" | A structured shot list, per-scene prompts, aspect ratios, and style guide; generates the actual asset only if a visual-gen tool is connected |
  134. | `short-form-video` | "TikTok video," "Instagram Reel script," "YouTube Short," "short-form/vertical video for..." | A hook-first script/shot list plus a ready-to-post package per platform (YouTube Shorts/Instagram Reels/TikTok) — title/caption, sized hashtags, and a best-time-to-post window, shaped to one of 23 marketing video types (testimonial, how-to, announcement, and so on) or 22 everyday FYP formats (POV, tier list, text-message skit, storytime, and so on); if you opt in, makes the actual video too, either with a connected tool (Higgsfield, Figma Weave, Canva, or similar) or by rendering it locally (`scripts/video/`): animated text over stock or AI backgrounds, or a narrated animation starring the brand's 3D mascot, or pixel art, with music in the project's own saved sound; otherwise points to current free tools |
  135. | `clip-montage` | "make a montage of these videos," "edit these clips into a reel," "recap video from today," "make a montage" | The default for montages, and free: brings in the user's own clips (location data stripped), looks at each one frame by frame to pick its best moment, and renders a 9:16 montage cut on the beat of their own music (or a generated track, or none for an in-app sound), with a clip's own sound where someone talks, their voiceover with synced captions, labels, and the client's contact end card; then edits it on request, saving each version. With only photos it asks for clips first, then hands over to `montage-video` |
  136. | `montage-video` | "make a video from these listing photos," "turn these product photos into a reel," "property tour from these pictures" | Brings in the client's photos and clips (upright, sized, location data stripped), looks at each one to order the shots, and renders a 9:16 montage with moves, beat-synced cuts, labels, price and specs, music or a voiceover with synced captions, and the client's branded contact end card; then edits it on request, saving each version and what each client prefers |
  137. | `community-post-generator` | "post this to r/[subreddit]," "help me post on Product Hunt," "write a Show HN/Show IH for this," "post this on dev.to," "post this in our Discord/Slack/Telegram" | Live-researches that specific subreddit's, Product Hunt's, Hacker News's, Indie Hackers', dev.to's, or a public Telegram channel's/group's actual rules and typical post style first (verifying each source is actually about that target, not a similarly-named one); for Discord, Slack, and private Telegram targets, asks you for the rules instead, since it can't research those. Gives a plain Go/No-Go either way, and only drafts a post (shaped for that platform — title+body, title+URL+first comment for Show HN, dev.to's title+body+tags, or a single chat message in Discord's, Slack's, or Telegram's own formatting for the chat platforms) if it's actually welcome there, written to read like a person wrote it |
  138. | `publish-pipeline` | "publish this," "send to n8n/Make," "fire the webhook," "send the queued post for [date]" | Packages finished content/assets into JSON and hands off to your automation via webhook (or, optionally, straight to a platform API) after showing you the exact payload |
  139. | `full-pipeline` | "run the full pipeline," "research X and publish it," "do the whole thing end to end" | Chains research, repurposing, visual brief, and publish into one run, with a mandatory pause before anything actually publishes |
  140. Plus one setup command: `/marketing-skill:marketing-setup`.
  141. ## Using your own project as source material
  142. `competitor-research`, `content-calendar`, `content-repurposer`,
  143. `seo-brief`, `ad-copy-generator`, `email-sequence`, `email-outreach`,
  144. `visual-brief-generator`, `short-form-video`, and `community-post-generator`
  145. can pull from the project they're installed in instead of requiring you to
  146. paste content every time. If you reference
  147. "our product," "our feature," "our changelog," etc. without providing the
  148. text, they'll check `README*`, `CHANGELOG*`, `docs/**/*.md`, and
  149. `package.json`/`pyproject.toml` at the project root first, and ask you
  150. directly only if nothing relevant turns up. They only read
  151. documentation-oriented files this way — never arbitrary source code — so
  152. install this in your product's own repo to get the most out of it.
  153. ## Install
  154. **Plugin method (recommended):**
  155. ```
  156. claude plugin marketplace add marcosmodly/marketing-skill
  157. claude plugin install marketing-skill@marketing-skill
  158. ```
  159. This works once the plugin's branch is merged to the repo's default
  160. branch, since `marketplace add` tracks a repo's default branch. To try it
  161. before merging (e.g. against a feature branch), clone the repo locally and
  162. point at your checkout instead — this is verified to work regardless of
  163. which branch is checked out:
  164. ```
  165. git clone https://github.com/marcosmodly/marketing-skill.git
  166. cd marketing-skill && git checkout <branch-name> # if not already on it
  167. claude plugin marketplace add ./
  168. claude plugin install marketing-skill@marketing-skill
  169. ```
  170. **Manual fallback:** no confirmed minimum Claude Code version exists for
  171. the plugin system — if `claude plugin` isn't available on your install
  172. (check with `claude plugin --help`), copy the skills in by hand instead:
  173. ```
  174. cp -r skills/* ~/.claude/skills/ # personal, all projects
  175. # or
  176. cp -r skills/* /your/project/.claude/skills/ # project-scoped
  177. ```
  178. The manual copy skips the setup command (see "Configure" below for the
  179. equivalent manual step) and `${CLAUDE_PLUGIN_ROOT}` path substitution.
  180. Copied skills can't find `references/`, `state/`, or `scripts/` on their
  181. own, so set `CLAUDE_PLUGIN_ROOT` to your clone of this repo before
  182. starting Claude Code (`export CLAUDE_PLUGIN_ROOT=/path/to/marketing-skill`);
  183. otherwise each skill asks you where the plugin lives.
  184. ## Using with Codex
  185. OpenAI's Codex reads Claude Code's plugin files (`.claude-plugin/`), so
  186. the same repo installs there too:
  187. ```
  188. codex plugin marketplace add marcosmodly/marketing-skill
  189. codex plugin add marketing-skill@marketing-skill
  190. ```
  191. To try a branch, add `--ref <branch-name>` to the first command, or pass
  192. the path to a local clone instead of `marcosmodly/marketing-skill`.
  193. All 14 skills load as-is; Codex ignores the `allowed-tools` line. A few
  194. things differ from Claude Code:
  195. - **Setup command:** Codex turns `/marketing-skill:marketing-setup` into
  196. a skill, so ask Codex to "run the marketing setup" instead of typing
  197. the slash command. Codex only converts commands under 4 KB, so keep
  198. `commands/marketing-setup.md` short when editing it.
  199. - **Plugin folder:** Codex doesn't fill in `${CLAUDE_PLUGIN_ROOT}`. Each
  200. skill works out the plugin folder itself (from the `CLAUDE_PLUGIN_ROOT`
  201. environment variable, or by finding the folder that holds
  202. `references/brand-voice.md`). Setting the variable is the reliable
  203. option, and it keeps your brand voice and queued posts in a folder you
  204. control rather than in Codex's installed copy:
  205. ```
  206. export CLAUDE_PLUGIN_ROOT=/path/to/marketing-skill # your clone
  207. codex
  208. ```
  209. - **Sandbox:** in its usual `workspace-write` mode, Codex only writes
  210. inside the folder you started it in and blocks network access from
  211. shell commands. If the plugin folder is somewhere else, add it to
  212. `writable_roots` (or approve the writes when asked). Publishing
  213. (`publish_webhook.py`, `publish_direct.py`) needs network access. Both
  214. settings go in `~/.codex/config.toml`:
  215. ```toml
  216. [sandbox_workspace_write]
  217. writable_roots = ["/path/to/marketing-skill"]
  218. network_access = true
  219. ```
  220. - **Live research:** `competitor-research`, `seo-brief`,
  221. `community-post-generator`, `content-calendar`, `email-outreach`,
  222. `short-form-video`, and `full-pipeline` research the web as they run.
  223. Set `web_search = "live"` in `~/.codex/config.toml` so results are
  224. current rather than cached.
  225. - **Connected tools:** Gmail drafts, prospecting tools, and video tools
  226. (Higgsfield, Figma Weave, Canva) work once the matching MCP server is
  227. set up in Codex. Without one, each skill falls back the same way it
  228. does in Claude Code.
  229. ## Configure
  230. Every skill reads `references/brand-voice.md` before producing output —
  231. your task priority, content types (short-form video, long-form video,
  232. text posts, email, images), target audience, tone, output format, banned
  233. words, and formatting constraints, defined once and reused everywhere.
  234. - **Guided setup:** run `/marketing-skill:marketing-setup` any time
  235. (first-run or to update your answers). If you make videos, it also asks
  236. where you post them, who presents them (you, your own 3D character, the
  237. robot mascot, a realistic AI avatar, or no one), a video whose style to
  238. follow, which paid tools you have, and whose voice
  239. ([what Claude asks before a video](docs/video.md#what-claude-asks-before-a-video)).
  240. - **Automatic:** if you skip setup, the first skill you actually use will
  241. ask the same 4 questions itself before proceeding, and save your answers
  242. for next time.
  243. - **Manual:** edit `references/brand-voice.md` directly — keep its
  244. section headings intact so every skill can still find them.
  245. `email-outreach` additionally reads its own
  246. `references/outreach-strategy.md` — ICP/target segment(s), value
  247. proposition and angle per segment, offer and primary CTA, the proof it
  248. may cite, sender identity, regions, daily volume, follow-up cadence, and
  249. suppression window. It's configured the same way:
  250. guided setup the first time `email-outreach` runs, or hand-edit directly.
  251. Unlike `brand-voice.md`, it also re-opens itself automatically — the
  252. skill checks its "last refreshed" date on every run and walks you through
  253. a strategy-refresh conversation once 30 days have passed, using
  254. `state/outreach-log.md`'s accumulated send/reply/bounce counts to inform
  255. it.
  256. ## Making videos
  257. `short-form-video` writes the script, captions, hashtags, and posting
  258. times for TikTok, Reels, and Shorts, and, if you want, makes the video:
  259. - **From a template:** 7 marketing types and 22 everyday formats (above),
  260. rewritten for your product and brand voice, over stock or AI
  261. backgrounds.
  262. - **Narrated:** a script of numbered lines becomes a voiceover (a free
  263. local voice, or your own takes) over a background per line, with
  264. word-by-word captions synced to the voice (`compose.js`).
  265. - **Animated, in 3D or pixel art:** the same narrated script, drawn as 3D
  266. scenes starring your brand's mascot, a robot in your colors that walks
  267. in, waves, types at a desk with your app on the monitor, points at your
  268. screen, holds up your laptop, cheers, and lip-syncs to the voice, moving
  269. through a living room, a launch stage, a city rooftop, and a park (or
  270. standing in your own photo). Have your own mascot or avatar as a rigged
  271. 3D model (`.glb`)? It takes the robot's place, with every action and
  272. prop; or as
  273. a pixel-art game with chiptune music (`style: 3d` or `style: pixel`).
  274. - **The bold look:** `captions: bold` gives any narrated video the cover
  275. of the big creator ads: huge capitals boxed in black with the selling
  276. words in yellow, the first line on screen from frame 0, a series tag
  277. ("week 2") in the corner, and your screenshot on the laptop or phone in
  278. your own photo.
  279. - **The product demo:** a launch video's look for software: the camera
  280. drifts into a dark room and pushes into the monitor, a terminal types
  281. your real install commands, an AI agent's session does the job, the
  282. things you made float past, and the camera moves from screen to screen
  283. without a cut, under small subtitles (`captions: subtitle`).
  284. - **Copy a video you like:** send a reference video and say "make ours
  285. like this". `reference.js` reads how it's edited (every cut and
  286. transition, how long scenes hold, the montage bursts, one moving camera
  287. or cut after cut, its palette, its tempo, whether it cuts on the beat)
  288. and plans yours to match, copying the editing, never the content.
  289. - **Your own footage:** a talking-head take from your phone gets its
  290. pauses cut and captions added (`cut.js`); screen recordings play in a
  291. phone frame.
  292. - **A montage of your clips** (`clip-montage`, the default and free): the
  293. phone videos you film, each at its best moment, cut on the beat of your
  294. own music, with a clip's own sound, your voiceover and synced captions,
  295. labels, and a client's own look and contact end card (`montage.js`).
  296. - **A montage of your photos** (`montage-video`): a home's or a product's
  297. photos, each moving: free local 3D moves and pans, or, on a paid plan
  298. you approve, real camera moves and new angles generated by a connected
  299. AI video model (Figma Weave, Higgsfield) and checked against each
  300. photo.
  301. Every video gets your **sonic identity** (one genre, key, and hook, so
  302. your sound becomes recognizable) and **visual identity** (colors, font,
  303. and a logo end card that lands with the sonic logo), the hook on screen
  304. from the first frame, and a QA pass for text the platforms' buttons
  305. would cover or that leaves too fast to read. Hook variants render
  306. several openings to test, and a video log steers the next videos by how
  307. yours actually did. Setup is free: Node, Playwright, and ffmpeg.
  308. ```
  309. cd scripts/video && npm install
  310. node compose.js script.md # a narrated video page from a script
  311. node montage.js inspect clips/ --slug maple # bring in a client's clips or photos; then montage.js <script.md>
  312. node render.js page.html out.mp4 --cover 0 # the video, its captions (.srt), and its cover
  313. ```
  314. **A mascot video or the bold cover, step by step.** Ask Claude in plain
  315. words, for example "make a 3D mascot video about our new invoicing app,
  316. here's a screenshot" (add "with our own mascot, here's the .glb" to put
  317. your character in the robot's place), or "make a TikTok with the big bold captions,
  318. here's a photo of me holding my laptop and a screenshot of the app". It
  319. writes a script like this one, voices it, and renders it:
  320. ```
  321. ---
  322. style: 3d # the mascot; leave it out for photo backgrounds
  323. character: assets/our-mascot.glb # optional: your own rigged 3D character instead of the robot
  324. captions: bold # big boxed captions; *words* in asterisks turn yellow
  325. hook: we made invoicing *one tap*
  326. series: week 2 # a tag in the top corner
  327. ---
  328. 1. We made invoicing *one tap*. [shot: mascot do=talk prop=laptop src=assets/app.png]
  329. 2. It took a year of late nights. [shot: desk src=assets/app.png]
  330. 3. Here's the new app. [shot: mascot do=point prop=screen src=assets/app.png]
  331. 4. Try it *free* this week. [shot: mascot do=cheer]
  332. ```
  333. To make it by hand, put your screenshot in `state/videos/assets/`, save
  334. the script as `script.md`, and run the commands above. Every action,
  335. prop, and scene the mascot has:
  336. [3D and pixel-art animation](docs/video.md#3d-and-pixel-art-animation).
  337. The bold look, and putting your app on the screen in a photo of you:
  338. [The bold look](docs/video.md#the-bold-look-a-cover-that-stops-the-scroll).
  339. A launch video of your app or tool, its screens instead of a presenter
  340. ("make a launch video for my CLI, here are the install commands"):
  341. [The product demo](docs/video.md#the-product-demo-a-launch-videos-look).
  342. A video edited like one you like ("make ours like this one", with the
  343. video attached): [Copy a video you like](docs/video.md#copy-a-video-you-like).
  344. Everything else, from backgrounds and sound to templates and connected
  345. video tools: **[docs/video.md](docs/video.md)**.
  346. ## Content calendar & approval model
  347. `content-calendar` batch-generates posts and queues them in
  348. `state/content-calendar.md` — a plain Markdown table that's both the
  349. forward calendar and the permanent send history (rows accumulate; nothing
  350. gets cleared out). It's safe to hand-edit directly. The table itself is
  351. just an index: each row's Notes column points at the file under
  352. `state/posts/` that actually holds that post's full content —
  353. `publish-pipeline` reads the file, not the table, when it sends.
  354. The file enforces a separation of duties that every skill in this plugin
  355. respects: **generation and approval are always two different steps.**
  356. `content-calendar` (and anything else that drafts content) can only write
  357. `Planned`, `Drafted`, or `Ready for Approval` to a row's Status — never
  358. `Approved`. Only `publish-pipeline` writes `Approved`, and only
  359. immediately after showing the real content to a human in a live
  360. conversation and getting an actual reply back — silence, a timeout, or
  361. the request having been phrased as blanket authorization ("just post
  362. these") never counts as that reply. `publish-pipeline` then flips the row
  363. to `Sent` right after a successful send.
  364. When more than one row is ready at once, `publish-pipeline` lists them
  365. together as a numbered batch (each with its Account/Destination/
  366. Attachments/Final Text spelled out) instead of asking "send this?" one
  367. row at a time — a reply has to name specific numbers to approve them,
  368. since an unqualified "send them all" invites rubber-stamping a list
  369. nobody actually read. It also flags any row more than 14 days old as
  370. Stale right in that listing, and `content-calendar` separately reports
  371. how many rows across the whole calendar have crossed that age every time
  372. it runs — a queue that's easy to lose track of is exactly what turns a
  373. careful approval step into a bulk-approved backlog later.
  374. This matters most the moment you try to run this plugin unattended — see
  375. "Running this on a schedule" below.
  376. ## Running this on a schedule
  377. Nothing in this plugin runs on a timer by itself — a skill only executes
  378. when a session invokes it. To get daily/weekly output, schedule the
  379. *session*, not the plugin: Claude Cowork's scheduled tasks (or Claude
  380. Code's own Routines/triggers) can fire a session on a cadence that runs
  381. `content-calendar` or `full-pipeline`.
  382. That solves "run it every day." It does **not** turn this into unattended
  383. auto-posting, on purpose: `content-calendar` only ever queues rows as
  384. `Drafted`/`Ready for Approval`, and `publish-pipeline` only sends a row
  385. already `Approved` by an actual human reply in that conversation — a
  386. scheduled trigger firing with nobody there to reply just leaves content
  387. queued for you to review later, which is the intended behavior, not a
  388. bug to work around. If you deliberately want unattended sending, you'd
  389. need to change that approval step yourself — this plugin doesn't ship a
  390. way to do that, on the theory that a live company account posting
  391. unsupervised is a decision only you should make explicitly, not one a
  392. scheduling tool should make for you by default.
  393. `email-outreach` follows the exact same model, just applied to cold email
  394. instead of social posts: schedule a daily session to get a consistent
  395. daily batch (its own "consistent daily outreach" requirement), and it
  396. queues every draft as `Drafted`/`Ready for Approval` — never `Sent` —
  397. exactly like `content-calendar` does, for the same reason. That's the
  398. default. If you want the daily run to send too, set a sending mode in
  399. `references/outreach-strategy.md`: `approve` sends the emails you
  400. approved by name when their send times come, and `auto` sends without
  401. anyone reading them, within a daily cap and a set of checks
  402. (`scripts/outreach_queue.py`; see [Cold outreach](docs/outreach.md)). Its monthly
  403. strategy refresh doesn't need a separate schedule at all: the skill
  404. checks `references/outreach-strategy.md`'s own last-refreshed date on
  405. every run and walks through the refresh conversation itself once 30 days
  406. have passed, so the one daily trigger alone covers both cadences.
  407. ## Publishing, community posts, and outreach
  408. - **[Publishing](docs/publishing.md):** hand finished content to n8n,
  409. Make, or any webhook (`scripts/publish_webhook.py`), or post straight
  410. to LinkedIn, X, Facebook, Reddit, Discord, Slack, Telegram, dev.to,
  411. YouTube, Instagram, or TikTok with your own credentials
  412. (`scripts/publish_direct.py`). Both refuse to run without `--dry-run`
  413. or `--confirmed`. The page covers what each platform's access really
  414. takes, including TikTok's private-only rule until your app is audited.
  415. - **[Community posts](docs/community-posting.md):** how
  416. `community-post-generator` researches each subreddit's, Product Hunt's,
  417. Hacker News's, Indie Hackers', dev.to's, or a Telegram channel's actual
  418. rules before drafting, and asks you for Discord's and Slack's.
  419. - **[Cold outreach](docs/outreach.md):** how the emails are written and
  420. checked, the contact log that keeps
  421. anyone who replied, bounced, or unsubscribed from ever being emailed
  422. again, and how Gmail and prospecting tools plug in.
  423. ## FAQ
  424. ### What are Claude Code skills?
  425. A skill is a folder with a `SKILL.md` file that teaches Claude a
  426. repeatable task. Claude reads each skill's description and uses it
  427. automatically when your request matches ("write an SEO brief for…",
  428. "give me a week of LinkedIn posts"), or you can call one by name, such as
  429. `/marketing-skill:seo-brief`.
  430. ### Do I need API keys or paid tools?
  431. No. Research uses Claude's built-in web search and fetch, and every skill
  432. produces its full written output with no connector or API key. Gmail, a
  433. prospecting tool, Higgsfield, Canva, and platform API credentials are
  434. optional extras, and paid ones are used only when you ask. Rendering a
  435. video locally needs only free tools (Node, Playwright, and ffmpeg), plus
  436. free Pexels and Pixabay keys if you want stock backgrounds.
  437. Actually sending content needs your own webhook or credentials.
  438. ### Will it post or send emails automatically?
  439. No. Drafts are queued in `state/`, and only `publish-pipeline` sends,
  440. after you approve specific items in a live conversation.
  441. `email-outreach` creates drafts and sends nothing unless you choose a
  442. sending mode: `approve` (it sends the emails you approved, at their send
  443. times) or `auto` (it sends without review, within limits). See
  444. [Cold outreach](docs/outreach.md) and
  445. [Content calendar & approval model](#content-calendar--approval-model).
  446. ### Can I use just one skill?
  447. Yes. Ask for what you need and only the matching skill runs. To skip the
  448. plugin system, copy the skill folders in by hand (see [Install](#install)).
  449. ### Is it validated by numbers?
  450. Partly, and [docs/results.md](docs/results.md) has what there is.
  451. - **Plugin vs plain Claude:** seven checks in `evals/`, scored with and
  452. without the plugin by `claude plugin eval`. They test the things a skill
  453. promises: a No-Go when a subreddit bans self-promotion, no made-up search
  454. volumes, no invented facts about a competitor. In the latest run the
  455. plugin clearly beat plain Claude on one (asking for a Discord server's
  456. rules instead of drafting blind), led by a run on two, tied on three,
  457. and lost one (its battlecard stated an absence the source didn't). All
  458. of it is published, the loss included.
  459. - **Real results:** not yet beyond the launch posts. Each skill logs what
  460. went out, and `python3 scripts/results.py` turns your logs into
  461. removal rates, medians, and reply rates, with "too few to tell" until
  462. there's enough to go on.
  463. - **Untested:** the advice built into the skills (hook patterns, posting
  464. times, outreach cadence) is common practice. Nothing here has tested it.
  465. ## Repo layout
  466. ```
  467. .claude-plugin/
  468. plugin.json # plugin metadata
  469. marketplace.json # lets this repo install itself via `marketplace add` (Claude Code and Codex)
  470. skills/ # the 14 skills, one SKILL.md each
  471. commands/
  472. marketing-setup.md # the /marketing-skill:marketing-setup command
  473. references/
  474. brand-voice.md # shared config every skill reads (hand-edited)
  475. outreach-strategy.md # email-outreach's own config: ICP, angle, offer, proof, regions, cadence (hand-edited or guided setup)
  476. cold-email.md # how a cold email is written: the four parts, length, subject lines, follow-ups, deliverability, opt-out
  477. video-types.md # 23 marketing video types: goal, short-form beats, and how each gets made (hand-editable)
  478. sound-guide.md # music genres, sound effects, how to pick a project's sonic identity, a hook library, licensed tracks
  479. hooks.md # hook patterns by goal, written to work with the sound off, and how to test them
  480. video-rendering.md # the local render procedure short-form-video follows
  481. fyp-formats.md # 22 everyday / FYP formats: why each works, beats, copy at two tones, weekly mix and rotation
  482. montage-guide.md # clip-montage's and montage-video's shot order, filming tips, moves, music by mood, and wording rules
  483. docs/ # the longer guides: video, publishing, community posts, outreach, the template gallery, and results.md (the plugin's own numbers)
  484. evals/ # claude plugin eval cases: each runs with and without the plugin, and the difference is scored
  485. state/
  486. content-calendar.md # calendar/history index (generated + appended to, hand-editable)
  487. posts/ # one file per queued post's full content, linked from the index above
  488. outreach-log.md # outreach queue/history + permanent suppression list (generated + appended to, hand-editable)
  489. outreach/ # one file per drafted email's full content, linked from the log above
  490. video-log.md # every posted video with its format, hook, and numbers; steers the next ones
  491. post-log.md # every posted Reddit/HN/dev.to/text post: the verdict it went out under, removed or not, and its numbers
  492. clients/ # one profile per client (look, sound, contact details, notes); kept out of git
  493. scripts/
  494. publish_webhook.py # stdlib-only webhook sender (see --help)
  495. publish_direct.py # stdlib-only direct-to-platform scaffold (LinkedIn/X/Meta/Reddit/Discord/Slack/Telegram/dev.to/YouTube/Instagram/TikTok), needs your own API credentials (see --help); --metrics reads a post's numbers back
  496. email_check.py # stdlib-only: checks drafted cold emails (length, subject, filler openers, placeholders, opt-out, address) and email sequences before they're queued
  497. outreach_queue.py # stdlib-only: which queued cold emails may be sent now under your sending mode (drafts / approve / auto), and why the rest wait
  498. results.py # stdlib-only: what the logs add up to (removal rates, medians, reply rates, an A/B significance test), or an eval result's table
  499. video/
  500. render.js # animated HTML page -> vertical MP4 with an original soundtrack (needs Node, Playwright, ffmpeg)
  501. soundtrack.js # the music and sound-effects synthesizer render.js uses (no dependencies)
  502. media.js # finds stock photos and clips (Pexels, Pixabay, Openverse) and writes their credits
  503. check.js # QA pass over templates: layout lint, cues, fonts, loudness, contact sheets
  504. voice.js # free local voiceover: a script -> one WAV per line, in a Kokoro stock voice or your own voice cloned by the Voicebox app
  505. captions.js # word timing for a voice line, caption chunks, and .srt files
  506. compose.js # a narrated video page from a script: voice, backgrounds (photos, the 3D mascot, or pixel art), synced captions, the bold look
  507. montage.js # a montage page from a client's clips or photos: intake, clip moments and sound, moves, beat-synced cuts, labels, contact end card
  508. depth.js # a photo's depth map (free local model), for the montage's 3D camera moves
  509. brand.js # applies the Visual Identity to a page: colors, font, logo end card
  510. cut.js # a filmed talking-head take: pauses cut, captions, and a page to render it
  511. beats.js # a music track's tempo, beats, bars, and drops, to cut a video on its beat
  512. reference.js # how a reference video is edited (cuts, transitions, pacing, palette, tempo), and a plan to match it
  513. gallery.js # rebuilds the template gallery in docs/gallery
  514. templates/ # 8 marketing + 22 everyday + 3D (the mascot: templates/mascot.py; the product demo's screens: templates/demo.py) and pixel-art starting pages, built by templates/build.py
  515. ```
  516. ## Share what you made
  517. Made a content calendar, a cold email batch, a video, or a launch post
  518. with these skills? Post it in
  519. [Show and tell](https://github.com/marcosmodly/marketing-skill/discussions/categories/show-and-tell),
  520. along with which skills you ran and anything that didn't work the way you
  521. expected. Questions go in
  522. [Q&A](https://github.com/marcosmodly/marketing-skill/discussions/categories/q-a),
  523. and bugs in [Issues](https://github.com/marcosmodly/marketing-skill/issues).
  524. ## Contributors
  525. Fixes, new skills, and docs are welcome. [CONTRIBUTING.md](CONTRIBUTING.md)
  526. covers how to send a pull request and run the checks first.
  527. - [marcosmodly](https://github.com/marcosmodly)

Ratings and comments

Sign in to rate this skill.

Sign in

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