agentleFS
vindreshsinghvindreshsingh/engineering-skills/skills/marketing/content-marketing/SKILL.md

content-marketing

Skill0 starsChanged 5 months agoMITView on GitHub

Creates long-form marketing content that educates and converts — blog posts, tutorials, newsletters, case studies, and landing copy. Use when you need articles, guides, launch posts, or email content that drives developer engagement and sign-ups.

6 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

2 rules. 0 are common, 2 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 4 edited versions we read keep these.

  • 2

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    If the topic doesn't serve the ICP or a message pillar, reject or reframe it.

    line 40
  2. Distinctive:

    No concrete examples, steps, or screenshots

    line 114

“Common” is measured: kept by at least 6 in 10 of the 4 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Content Marketing

Developers trust useful content, not ad copy. This skill produces long-form pieces that teach something real, demonstrate the product honestly, and end with a clear next step. Content compounds — a good tutorial ranks for months; a generic promo dies in hours.

Chains from [[growth-strategy]] (brief, pillars, ICP) and feeds [[social-distribution]] (snippets), [[seo-growth]] (optimized pages), and [[community-engagement]] (discussion starters).

When to Use

  • Writing a launch blog post or product announcement
  • Creating tutorials, guides, or "how to" articles
  • Drafting newsletter editions or email sequences
  • Producing case studies or user success stories
  • Writing landing page copy (hero, features, FAQ)
  • Repurposing one pillar into multiple formats

Skip for short social posts only — use [[social-distribution]] instead.

Process

1. Start from the brief

Load inputs from [[growth-strategy]] or gather:

  • Topic / working title
  • Target reader (ICP persona)
  • Goal — educate, convert, retain, announce
  • Primary keyword (if SEO matters)
  • Message pillar this piece supports
  • CTA — sign up, try feature, join community, read docs
  • Format — blog (800–2000 words), tutorial (step-by-step), case study, newsletter

If the topic doesn't serve the ICP or a message pillar, reject or reframe it.

2. Outline before writing

Structure every piece:

Hook — specific pain or surprising stat (2–3 sentences)
Problem — why this matters to the reader
Insight — your angle (not generic advice)
Solution / walkthrough — steps, examples, screenshots placeholders
Product tie-in — natural, ≤20% of piece; show don't pitch
Proof — data, quote, mini case, or demo
CTA — one clear action

For tutorials: numbered steps, code/commands where relevant, expected outcome per step.

3. Write for developers

Rules:

  • Lead with value — reader learns something even if they never sign up
  • Be specific — "connect with 3 mentors in your stack" beats "grow your network"
  • Show the product — describe what happens on screen; mark [SCREENSHOT] or [GIF] placeholders
  • No fluff — cut "in today's fast-paced world" and empty superlatives
  • Honest scope — say what the product doesn't do yet
  • Scannable — H2/H3, bullets, short paragraphs, code blocks where useful

Voice: peer explaining something useful, not a brand shouting.

4. Optimize for engagement and conversion

  • Title — benefit or curiosity; include keyword if SEO piece
  • Meta description — 150–160 chars, includes CTA verb
  • First 100 words — hook + promise of what they'll get
  • Internal links — related posts, docs, sign-up page
  • One primary CTA — repeated once mid-article and once at end max
  • Social snippets — draft 3 pull quotes or thread bullets for [[social-distribution]]

5. Repurpose plan

From one article, extract:

AssetFormatChannel
Thread5–8 tweetsX
Carousel outline5 slidesLinkedIn
Reddit postProblem + linkSubreddit (value-first)
Newsletter blurb2 paragraphsEmail
Community questionDiscussion promptDiscord / forum

List these in the deliverable even if another agent publishes them.

6. Review before publish

Self-check:

  • Would I share this if I didn't work on the product?
  • Every claim is true or marked [VERIFY]
  • CTA matches the campaign goal
  • No jargon without explanation
  • Screenshots/demo placeholders noted

Common Rationalizations

  • "SEO will fix a weak article" — Thin content doesn't rank or convert. Quality first.
  • "The whole post should be about our product" — 80% value, 20% product. Invert and readers bounce.
  • "We need more posts, not better posts" — One strong tutorial beats five announcements.
  • "Developers read long docs" — They read long useful docs. Cut everything else.

Red Flags

  • Title promises what the body doesn't deliver
  • No concrete examples, steps, or screenshots
  • CTA missing or buried
  • Reads like a press release
  • Copied from a competitor with names swapped
  • [VERIFY] tags left in published copy

Verification

Content is done when:

  • Outline matches brief (ICP, pillar, goal, CTA)
  • Full draft with hook, problem, insight, solution, proof, CTA
  • Title + meta description written
  • 3 social snippets / pull quotes for repurposing
  • Repurpose table filled (thread, LinkedIn, Reddit, newsletter)
  • Self-review checklist passed; claims verified or flagged

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.