agentleFS
Docat0209Docat0209/SoloForge/skills/content-create/SKILL.md

content-create

Skill1 starsChanged 7 months agoMITView on GitHub

Creates VALUE content: blog posts, tutorials, articles, educational material, onboarding/lifecycle emails. Goal = build trust and attract audience. Triggers ONLY when: user asks to create content, write an article, or prepare educational material. Do NOT trigger when: writing code documentation, README files, landing page copy, or ad copy.

The file

Show its rules and text

We split this skill into the rules it gives an agent

14 rules. About 0 are common, 13 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈13

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use "They Ask, You Answer" (Marcus Sheridan).

    line 16
  2. Distinctive:

    Use second person ("you") not first person ("we")

    line 66
  3. Distinctive:

    Never use phrases like "our solution" or "we built" in the first 80% of the content

    line 75
  4. Distinctive:

    If the content targets search traffic:

    line 79
  5. Distinctive:

    Search intent match: read the top 5 Google results for the keyword — match the FORMAT they use (listicle, how-to, comparison, etc.)

    line 83
  6. Distinctive:

    Meta description: write a compelling 150-160 character description with the keyword

    line 85
  7. Distinctive:

    Headers: use H2/H3 hierarchy, include keyword variations in subheadings

    line 86
  8. Distinctive:

    Use web search to verify keyword volume and competition before committing to a keyword.

    line 88
  9. Distinctive:

    Before delivering the content, verify ALL of the following:

    line 92
  10. Distinctive:

    If any check fails, rewrite the failing section before delivering.

    line 103
  11. Very specific:

    After content is created and approved, store in memory/content_log.md:

    line 107
  12. Distinctive:

    When publishing to API-allowed platforms (Dev.to, Medium, Hashnode):

    line 119
  13. Distinctive:

    Use Playwright to navigate to the platform's editor

    line 120
  14. Distinctive:

    Only publish after user confirms the preview looks correct

    line 123

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “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 Creation SOP

Boundary

This skill (content-create) = VALUE content. Goal is to build trust and attract audience. Covers: blog posts, tutorials, articles, educational material, onboarding email sequences (welcome, activation, value delivery, social proof), and platform-specific content.

Not this skill — use copy-craft instead for CONVERSION copy: landing pages, CTAs, ad copy, microcopy, sales/upgrade/win-back emails. Goal there is to get someone to ACT.

Step 1: Identify the Customer's Question

Use "They Ask, You Answer" (Marcus Sheridan). Every piece of content must answer a REAL question the target audience is already asking.

Prioritize the Big 5 content types:

  1. Pricing/cost — "How much does X cost?" "What affects the price of X?"
  2. Problems — "What are the downsides of X?" "Problems with X"
  3. Comparisons — "X vs Y" "How does X compare to Y?"
  4. Best-of lists — "Best tools for X" "Top X solutions in 2025"
  5. Reviews — "Is X worth it?" "Honest review of X"

Action: Ask the user what question they want to answer. If unclear, search the web for common questions in the target niche using forums, Reddit, Quora, and "People Also Ask" on Google.

Step 1b: Onboarding & Lifecycle Email Sequences

For email sequences that educate and build trust (not sell), use this structure (source: Encharge, HubSpot):

EmailTimingPurposeSubject line rule
WelcomeInstantConfirm signup, set expectations, one quick-win actionUse their name + what they just did
ActivationDay 1Guide to first meaningful action (Time to First Value)Verb + specific outcome ("Create your first X")
Value deliveryDay 3Show what's possible, share a power-user tipQuestion format ("Did you know you can...?")
Social proofDay 7Customer story with specific resultsName-drop or result number in subject

For upgrade/sales/win-back emails, use copy-craft.

Step 2: Choose Platform and Format

Each platform has specific constraints. Match format to platform:

PlatformFormatLengthStyle
Dev.to / HashnodeTechnical tutorial800-1500 wordsCode blocks, step-by-step, practical outcomes
MediumNarrative essay1000-2000 wordsStorytelling, personal experience, clear takeaways
Twitter/XThread5-10 tweetsData-driven, opinionated, one idea per tweet
LinkedInProfessional insight300-500 wordsLessons learned, career relevance, formatted for mobile
RedditAnswer-format200-800 wordsGenuinely helpful, zero self-promotion in the post body
Hacker NewsShow HN onlyBrief descriptionWorking product required, factual, non-promotional
Blog (SEO)Long-form guide1500-3000 wordsTopic cluster model, keyword-optimized

Action: Confirm platform with user before writing. If blog/SEO, identify the target keyword first.

Step 3: Write from the Customer Perspective

This is the most common failure mode. Content must use the CUSTOMER'S vocabulary, not the developer's.

  • Wrong: "Our microservices architecture enables horizontal scaling"
  • Right: "Your app won't crash when 10,000 users show up at once"

Rules:

  • Address their pain in their words — search forums/Reddit to learn their exact phrasing
  • Show outcomes they care about (time saved, money saved, problems avoided)
  • Use second person ("you") not first person ("we")
  • Include specific, concrete examples — not abstract benefits

Step 4: Apply the 95/5 Rule

  • 95% of the content must be pure, standalone value
  • 5% (at most) can mention the product — and only if naturally relevant
  • Litmus test: would this content be valuable if the product didn't exist? If NO, rewrite.
  • Product mentions go at the END, never the opening
  • Never use phrases like "our solution" or "we built" in the first 80% of the content

Step 5: SEO Optimization (Blog Content Only)

If the content targets search traffic:

  1. Topic cluster model: identify the pillar page and where this piece fits as a cluster page
  2. Target keyword: include in title, at least one H2, and first paragraph
  3. Search intent match: read the top 5 Google results for the keyword — match the FORMAT they use (listicle, how-to, comparison, etc.)
  4. Internal linking: link to pillar page and 2-3 related cluster pages
  5. Meta description: write a compelling 150-160 character description with the keyword
  6. Headers: use H2/H3 hierarchy, include keyword variations in subheadings

Use web search to verify keyword volume and competition before committing to a keyword.

Step 6: Quality Check

Before delivering the content, verify ALL of the following:

  • Answers a real question the audience is asking (not a question we wish they'd ask)
  • Uses the customer's vocabulary, not internal jargon
  • Would get upvoted/shared on its own merit with zero product mention
  • Follows the platform's format and length constraints
  • 95/5 rule: product mention is minimal and at the end (if present at all)
  • Includes specific examples, numbers, or code — not just abstract advice
  • Has a clear, compelling title that promises a specific outcome
  • No fluff paragraphs — every paragraph earns its place

If any check fails, rewrite the failing section before delivering.

Step 7: Store in Auto Memory

After content is created and approved, store in memory/content_log.md:

  • Topic and target keyword
  • Platform and format
  • Date created
  • Target audience segment
  • Links to published version (added after distribution)
  • Performance metrics (added after tracking — views, clicks, conversions)

This builds a content library for future reference and prevents duplicate topics.

Playwright MCP Usage

When publishing to API-allowed platforms (Dev.to, Medium, Hashnode):

  1. Use Playwright to navigate to the platform's editor
  2. Fill in title, body, tags, and canonical URL
  3. Preview before publishing — take a screenshot for user review
  4. Only publish after user confirms the preview looks correct

For platforms where automation is NOT allowed (Reddit, HN): draft the content in a local file and instruct the user to post manually.

Next Steps

Report to user: "Content created: [title]. Platform: [target]. Word count: [N]"

Suggested next steps (user decides):

  • Content ready → "Run content-distribute"
  • Launch content → "Run community-engage"

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.