Agent skill

Content Marketing

by EliasOulkadi in EliasOulkadi/shokunin

Write blogs, newsletters, Twitter threads, case studies, and marketing copy that convert.

MITAuto-check passedWriting & Content

Install Content Marketing

skills CLI
$ npx skills add EliasOulkadi/shokunin --skill content-marketing -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install EliasOulkadi/shokunin content-marketing --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/EliasOulkadi/shokunin.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.pack/skills/content-marketing .claude/skills/content-marketing && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
content-marketing
GitHub stars
114
Token cost
~2.5k tokens
SKILL.md length
1,121 words
Files
1
Skills in repo
49
Repo updated
First seen
Licence
MIT

At a glance

Write blogs, newsletters, Twitter threads, case studies, and marketing copy that convert.

  • Works in 7 steps: Define the audience persona — who reads… → Select the copywriting framework — AIDA… → Write the headline first — under 15… → …
  • Tasks that involve Social media posts
  • SKILL.md covers Sub-Commands, Copywriting Frameworks, Headline Formulas and Blog Structure, plus 12 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Content Marketing is an agent skill from EliasOulkadi/shokunin. Write blogs, newsletters, Twitter threads, case studies, and marketing copy that convert. Covers copywriting frameworks (AIDA, PAS, BAB, FAB), headline formulas, SEO/GEO for 2026 (AI Overviews, SGE), newsletter deliverability, Twitter thread hooks, Cialdini psychology, and cognitive biases.

Its SKILL.md is about 2.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: opencode

It sits in Writing & Content, covering Social media posts, Newsletters and Copywriting. The repository describes itself as: 職人 Shokunin 62 AI agent skills for OpenCode, Claude Code, Cursor, Windsurf. ChromaDB memory, MCP servers, declarative self-updates. Multi-model, open source, zero cost. The licence is MIT.

When your agent uses it

  • Tasks that involve Social media posts
  • Tasks that involve Newsletters
  • Tasks that involve Copywriting

Example prompts

  • “/content-marketing”

Requirements

  • Compatibility (from SKILL.md): opencode
  • Pre-approved tools (allowed-tools): websearch, webfetch, read, write, edit, glob, grep, bash, skill

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Define the audience persona — who reads this? What do they know? What problem do they have? Language, examples, and tone reflect this one…
  2. Select the copywriting framework — AIDA for landing pages, PAS for pain-point content, BAB for transformational offers, FAB for product…
  3. Write the headline first — under 15 words, keyword near start, specific outcome promise. Score against headline formulas. No clickbait.
  4. Open with a strong lead — problem-first, story-first, curiosity gap, or data-first. Hook the reader in the first 2 sentences.
  5. Layer Cialdini principles — minimum 3 per piece. Reciprocity (free value), social proof (testimonials/logos), authority (data/sources)…
  6. Optimize for SEO + GEO — primary keyword in H1, first 100 words, one H2. Direct answer in first 2 paragraphs for AI overviews. Structured…
  7. Close with one clear CTA — single action verb + specific outcome. "Get the checklist" not "Learn more."

What it can do on your machine

Read from SKILL.md and the folder at commit 4c68e5b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • websearch
    • webfetch
    • read
    • write
    • edit
    • glob
    • grep
    • bash
    • skill

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    opencode

    From compatibility in the SKILL.md frontmatter.

Context cost

Content Marketing loads about 2.5k tokens when it runs. Until then it costs about 77 tokens; SKILL.md has 1,121 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~77
When it runs · the whole SKILL.md, loaded when a task matches
~2.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from EliasOulkadi/shokunin at commit 4c68e5b, republished under its MIT licence (© EliasOulkadi). 1,121 words, ~2,543 tokens.

Download SKILL.mdSave it as .claude/skills/content-marketing/SKILL.md (or your agent's skills folder).
name
content-marketing
description
Write blogs, newsletters, Twitter threads, case studies, and marketing copy that convert. Covers copywriting frameworks (AIDA, PAS, BAB, FAB), headline formulas, SEO/GEO for 2026 (AI Overviews, SGE), newsletter deliverability, Twitter thread hooks, Cialdini psychology, and cognitive biases.
allowed-tools
websearch, webfetch, read, write, edit, glob, grep, bash, skill
compatibility
opencode
triggers
write a blog post, write a newsletter, write a Twitter thread, case study, marketing copy, copywriting, landing page copy, ad copy, sales copy, content strategy
negatives
sales outreach, proposal, SOW, pitch deck, translation, localization
license
MIT
metadata.version
4.0.0
metadata.workflow
content-marketing
metadata.audience
developers

Content Marketing

Content that ranks, converts, and gets shared. Based on Ogilvy, Cialdini, Copyhackers, and modern distribution strategies.

Sub-Commands

CommandDescription
blogWrite a blog post (outline → draft → optimize → publish)
newsletterWrite a newsletter issue with subject line + body
threadWrite a Twitter/X thread (hook + value + CTA)
case-studyWrite a case study from results data
headlineGenerate and score headlines against formulas
optimizeOptimize existing content for SEO + GEO

Copywriting Frameworks

FrameworkStructureBest for
AIDAAttention → Interest → Desire → ActionLanding pages, emails
PASProblem → Agitate → SolvePain-point focused content
BABBefore → After → BridgeTransformational offers
FABFeature → Advantage → BenefitProduct descriptions
4PsPicture → Promise → Prove → PushLong-form direct response

Headline Formulas

TypeFormulaExample
Direct benefit"[Number] [noun] for [audience]""10 Email Templates for Busy Founders"
How-to"How to [outcome] in [time]""How to Double Conversion Rate in 30 Days"
Pain avoidance"[Outcome] Without [pain]""Get More Leads Without Spending on Ads"
Contrarian"Why [common belief] is [wrong]""Why 'Write for Skimmers' Is Terrible Advice"
Personal story"I [did thing] and [result]""I Rewrote One Page and Made $40K"

Rules: Under 15 words. Keyword near start. Specific outcome promise. No clickbait.

Blog Structure

Headline → Lead (problem/story/curiosity/data) → H2 sections → Code examples → Conclusion → CTA

Lead types:

TypeFormula
Problem-first"[Pain]. Here's how to fix it."
Story-first"I [did thing] and learned [lesson]."
Curiosity gap"[Claim]. Here's why."
Data-first"[Stat]. [Why it matters]."

SEO + GEO (2026)

Traditional SEO
  • Primary keyword in H1, first 100 words, one H2
  • Meta description under 155 chars with value prop
  • URL: kebab-case, no stop words
  • Internal links: 2-3 related posts
GEO (Generative Engine Optimization)
  • Direct answer in first 2 paragraphs (AI scrapes opening)
  • Structured data: FAQ, HowTo, Article schema
  • Entity clarity: define who you are, what you do, for whom
  • Cite primary sources (studies, data, .edu/.gov)
  • Contrarian takes (AI models reference multiple viewpoints)
  • Conversational tone (AI penalizes keyword-stuffed text)

Twitter Threads (5-7 tweets)

Tweet 1: Hook — stop the scroll (240 chars max)
Tweet 2: Context — why this matters
Tweets 3-5: Value — core teaching, step by step
Tweet 6: Proof — evidence, results, data
Tweet 7: CTA — one clear action

Hook patterns: surprising stat, contrarian take, direct promise, story opening, bold claim.

Newsletter Benchmarks

MetricGoodNeeds work
Open rate25-40%Below 20%
Click rate2-5%Below 1%
UnsubscribeUnder 0.5%Over 1%

Subject line: 30-50 chars. Start with verb or number. No ALL CAPS. A/B test 20%.

Cialdini Principles (minimum 3 per piece)

PrincipleApplication
ReciprocityFree content, valuable upfront
ScarcityLimited time, real limits only
AuthorityData, certifications, named sources
Social proofTestimonials, user count, logos
ConsistencyMicro-yes → macro-yes
LikingRelatable voice, shared identity

Production Checklist

  • Audience persona defined and reflected in language
  • Copywriting framework chosen
  • Headline under 15 words, keyword near start
  • At least 3 Cialdini principles applied
  • Every claim backed by data, quote, or source link
  • Primary keyword in H1, first paragraph, one H2
  • Direct answer in first 2 paragraphs (GEO)
  • CTA: single action verb with specific outcome
  • No anti-pattern violations
  • Links tested and valid
  • Read aloud: flow natural, no jargon

Workflow

  1. Define the audience persona — who reads this? What do they know? What problem do they have? Language, examples, and tone reflect this one persona.
  2. Select the copywriting framework — AIDA for landing pages, PAS for pain-point content, BAB for transformational offers, FAB for product descriptions.
  3. Write the headline first — under 15 words, keyword near start, specific outcome promise. Score against headline formulas. No clickbait.
  4. Open with a strong lead — problem-first, story-first, curiosity gap, or data-first. Hook the reader in the first 2 sentences.
  5. Layer Cialdini principles — minimum 3 per piece. Reciprocity (free value), social proof (testimonials/logos), authority (data/sources), scarcity (genuine limits only).
  6. Optimize for SEO + GEO — primary keyword in H1, first 100 words, one H2. Direct answer in first 2 paragraphs for AI overviews. Structured data where applicable.
  7. Close with one clear CTA — single action verb + specific outcome. "Get the checklist" not "Learn more."
Show full SKILL.md (508 more words)Show less

Error Handling

CauseFix
Headline scores poorly against formulas (generic, no outcome)Rewrite with: specific number + target audience + promised result. Test 3-5 variants.
Open rate below 20% on newsletterSubject line too long or too vague. Target 30-50 chars. Start with verb or number. A/B test 20% of list.
Click rate below 1% on newsletterCTA not prominent or actionable. Move CTA higher. Make it a single, specific action with a clear benefit.
Blog post reads like AI-generated, high bounce rateCheck for AI tells: uniform paragraph length, mechanical connectors, absolute neutrality, no opinion. Humanize voice.
Twitter thread hook gets scrolled pastHook must stop the scroll in 240 chars. Use: surprising stat, contrarian take, direct promise, story opening, or bold claim.
Content flagged as thin or unhelpful by GoogleAdd original data, unique perspective, or expert insight. Cite primary sources. Include contrarian viewpoint for GEO.
"Fake scarcity" damages brand trustOnly use genuine limits: limited cohort, real deadline, actual inventory constraint. Never invent urgency.
Cialdini principle overuse feels manipulativeMax 3-4 principles per piece. Layer naturally. Social proof and authority should feel earned, not forced.

Anti-Patterns

MistakeFix
Generic headlineSpecific: name outcome + audience
No social proofAdd testimonials near every claim
Weak CTAAction verb + specific outcome
Writing for "everyone"Pick one persona
Fake scarcityOnly use genuine limits
No proofBack every claim with data
Selling too earlyBuild trust before the ask

Headline Formulas by Platform

Blog Headings
  • "How to [Achieve Outcome] [Timeframe]" (How to Ship Faster in 30 Days)
  • "[Number] [Adjective] Ways to [Solve Problem]" (7 Proven Ways to Reduce Churn)
  • "Why [Common Belief] Is Wrong (And What to Do Instead)"
  • "[Year] Guide to [Topic]: [Specific Angle]" (2026 Guide to SEO: GEO Edition)
Newsletter Subject Lines
  • Questions: "Is your [metric] where it should be?"
  • Urgency: "[Name], [deadline] is tomorrow"
  • Social proof: "How [company] grew [metric] by [number]%"
  • Curiosity gap: "The [industry] secret nobody talks about"
Twitter/X Threads
  • Hook line 1: Contrarian take or surprising statistic
  • Line 2-3: Expand with evidence
  • Line 4-6: Steps/methods (numbered)
  • Line 7-8: Results/social proof
  • Last line: Call to action + link
LinkedIn
  • Line 1: Statement that challenges assumption
  • Line 2-3: Story with specific numbers
  • Line 4-5: Lesson learned
  • Last line: Question to drive comments

Newsletter Deliverability

Authentication
DNS Records:
TXT  @   "v=spf1 include:mail.provider.com ~all"
TXT  _dmarc  "v=DMARC1; p=quarantine; rua=mailto:dmarc@domain.com"
CNAME  selector1._domainkey  selector1.provider.com
CNAME  selector2._domainkey  selector2.provider.com
Deliverability Checklist
  • SPF record covers all sending IPs
  • DKIM signed with 2048-bit key
  • DMARC policy at minimum p=none (monitor), eventually p=reject
  • Custom tracking domain (not shared with other senders)
  • Sender reputation > 95% (Google Postmaster Tools)
  • Spam rate < 0.1% (Google threshold is 0.3%)
  • Unsubscribe link visible in every email (CAN-SPAM/GDPR requirement)
  • List cleaned monthly: remove addresses that haven't opened in 90 days

Sources

  • Ogilvy on Advertising
  • Breakthrough Advertising — Eugene Schwartz
  • Copyhackers — Joanna Wiebe
  • Cialdini "Influence"
  • Google Search Central — SEO documentation
  • Mailchimp / Campaign Monitor — Email benchmarks

Checklist

  • Skill loads without errors in the AI agent
  • YAML frontmatter is valid (description, compatibility, audience)
  • Workflow section provides clear step-by-step instructions
  • Error handling section covers common failure modes
  • All referenced files (references/, scripts/, assets/) exist
  • Skill triggers correctly for intended use cases
  • No broken links or missing resources

© EliasOulkadi, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .pack/skills/content-marketing of EliasOulkadi/shokunin.

Open the folder on GitHubat commit 4c68e5b

Compare with similar skills

Content Marketing next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Content Marketing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Content Marketing this skillEliasOulkadi/shokunin114—~2.5kAutomated safety check: PassMIT
26 Thought Leadership Content Globalminhnv0807/ai-business-skills609—~4.7kAutomated safety check: PassMIT
Content Writer Agentmastra-ai/mastra29k—~1.3kAutomated safety check: PassCustom licence
Content Enginec0x12c/ai-toolkit106—~986Automated safety check: PassNone
Content Enginecohen-liel/hivemind1106 repos~643Automated safety check: PassApache-2.0
Money Contentiamzifei/show-me-the-money1k—~9.6kAutomated safety check: PassCustom licence

Similar skills

  • 26 Thought Leadership Content Global

    minhnv0807/ai-business-skills

    A skill your agent uses when a PERSONAL brand needs long-form WRITTEN content that builds authority rather than sells — LinkedIn posts, X threads, Substack and Medium essays, using PAS-Insight for…

    609 GitHub stars~4.7k tokensUpdated 29 days ago
    Writing & ContentAuto-check passed
  • Content Writer Agent

    mastra-ai/mastra

    Authoring playbook for building agents that draft written content — blog posts, marketing copy, social media posts, newsletters, product descriptions, landing pages, or ad copy.

    29k GitHub stars~1.3k tokensUpdated today
    Writing & ContentAuto-check passed
  • Content Engine

    c0x12c/ai-toolkit

    Turn one idea into platform-native content for X, LinkedIn, TikTok, YouTube, newsletters.

    106 GitHub stars~986 tokensUpdated 3 mo ago
    Writing & ContentAuto-check passed
  • Content Engine

    cohen-liel/hivemind

    Create platform-native content systems for X, LinkedIn, TikTok, YouTube, newsletters, and repurposed multi-platform campaigns.

    110 GitHub starsUsed in 6 repos~643 tokens
    Writing & ContentAuto-check passed
  • Money Content

    iamzifei/show-me-the-money

    Automated content creation pipeline for business growth. An agent skill from iamzifei/show-me-the-money.

    1k GitHub stars~9.6k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • 37 Social Caption Global

    minhnv0807/ai-business-skills

    A skill your agent uses when the user needs ORGANIC social captions for Instagram, LinkedIn, TikTok, Facebook, or X — hook, mobile-readable body, two A/B variants, platform-correct hashtags, written…

    609 GitHub stars~2.2k tokensUpdated 29 days ago
    Writing & ContentAuto-check passed

More from EliasOulkadi/shokunin

All 49 skills in this repo
  • CI CD

    EliasOulkadi/shokunin

    Design CI/CD pipelines for GitHub Actions, GitLab CI, and CircleCI with matrix builds, test sharding, caching, Docker layer caching, OIDC auth, deployment strategies (rolling, blue-green, canary)…

    114 GitHub stars~3.4k tokensUpdated 6 days ago
    Auto-check: notes
  • Component Forge

    EliasOulkadi/shokunin

    Build production-grade components for React, Vue 3, and Svelte 5 with all states (loading, empty, error, success, idle), TypeScript strict, WCAG 2.2 accessibility, server components (RSC), and…

    114 GitHub stars~3.6k tokensUpdated 6 days ago
    Auto-check: notes
  • DB Admin

    EliasOulkadi/shokunin

    PostgreSQL database administration — backup/restore (pgdump, PITR, WAL archiving), health monitoring (connections, bloat, cache hit ratio, dead tuples), connection pooling (PgBouncer), replication…

    114 GitHub stars~2k tokensUpdated 6 days ago
    Auto-check: notes
  • DB Sculptor

    EliasOulkadi/shokunin

    Design database schemas with Prisma/Drizzle, PostgreSQL index strategy (B-tree, GIN, GiST, BRIN, Hash), query optimization (EXPLAIN ANALYZE), migration safety (expand/contract, zero-downtime), and…

    114 GitHub stars~3.1k tokensUpdated 6 days ago
    Auto-check: notes
  • Docker

    EliasOulkadi/shokunin

    Optimize Docker images with multi-stage builds, distroless bases, BuildKit cache mounts, multi-arch builds, compose watch, security hardening (non-root, seccomp, capabilities drop), and…

    114 GitHub stars~3.8k tokensUpdated 6 days ago
    Auto-check: notes
  • Error Handler

    EliasOulkadi/shokunin

    Design error handling, structured logging, and observability with OpenTelemetry (traces, metrics, logs), error classification, recovery patterns (retry with jitter, circuit breaker, bulkhead…

    114 GitHub stars~3.6k tokensUpdated 6 days ago
    Auto-check: notes

Questions about Content Marketing

What does Content Marketing do?

Write blogs, newsletters, Twitter threads, case studies, and marketing copy that convert. Content Marketing is an agent skill from EliasOulkadi/shokunin. Write blogs, newsletters, Twitter threads, case studies, and marketing copy that convert.

When should I use Content Marketing?

Content Marketing fits situations like: tasks that involve Social media posts; tasks that involve Newsletters; tasks that involve Copywriting.

How do I install Content Marketing in Claude Code?

Run `npx skills add EliasOulkadi/shokunin --skill content-marketing -a claude-code`. Or copy the skill folder (.pack/skills/content-marketing in EliasOulkadi/shokunin) into .claude/skills/content-marketing in your project. Claude Code loads it when a task matches its description.

How do I install Content Marketing in Codex?

Run `npx skills add EliasOulkadi/shokunin --skill content-marketing -a codex`. Or copy the skill folder (.pack/skills/content-marketing in EliasOulkadi/shokunin) into .agents/skills/content-marketing in your project. Codex loads it when a task matches its description.

Can I use Content Marketing in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add EliasOulkadi/shokunin --skill content-marketing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/content-marketing, .gemini/skills/content-marketing, .github/skills/content-marketing and .opencode/skills/content-marketing in your project.

What does Content Marketing need to run?

SKILL.md names no scripts, command-line tools or credentials: Content Marketing is instructions for the agent only. Its frontmatter pre-approves these tools: websearch, webfetch, read, write, edit, glob, grep, bash, skill. Compatibility (from SKILL.md): opencode.

Does Content Marketing access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Content Marketing safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Content Marketing use?

Content Marketing is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Content Marketing use?

About 2.5k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Content Marketing?

Skills that share tags, products or a category with Content Marketing: 26 Thought Leadership Content Global (minhnv0807/ai-business-skills, 609 stars), Content Writer Agent (mastra-ai/mastra, 29k stars), Content Engine (c0x12c/ai-toolkit, 106 stars) and Content Engine (cohen-liel/hivemind, 110 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Content Marketing?

EliasOulkadi (a GitHub user) maintains it in EliasOulkadi/shokunin, which has 114 GitHub stars. The repository holds 49 skills in this directory. The repository was last updated on October 5, 2026.

Source: EliasOulkadi/shokunin on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.