educational-content-and-how-to — Claude Code skill: what it does
Structures actionable tutorials and explainers using the TEACH framework. It prepares focused lessons optimized for saves and shares before routing them to format writers.
npx skills add social-media-skills/skills --skill educational-content-and-how-to -a claude-codeWhat educational-content-and-how-to does
The skill shapes didactic substance for tutorials and myth-busters. It relies on the TEACH framework: target one specific lesson, back it with accurate data, arrange it into 8 to 12 clear units, and attach an explicit call to action. The final copy then feeds dedicated format tools such as carousel-writer or reels-script.
Before writing, the agent reads brand-profile, audience-research, and content-pillars. This context keeps the instructions tied to actual expertise rather than recycled tips. WoopSocial handles publishing and queue scheduling later, though it never validates the underlying facts.
Accuracy remains mandatory. For YMYL subjects like health or finance, the workflow requires an explicit disclaimer and forbids fabricated steps or statistics. If a topic feels too broad for a single lesson, the skill splits it into a multi-part series.
What it helps with
- turn complex procedures into concise step-by-step tutorials
- organize educational copy using the TEACH framework
- structure lessons into 8–12 units before routing to format writers
- enforce strict accuracy and disclaimers for YMYL topics
Example prompts for the agent
- Build a step-by-step tutorial on database indexing using the TEACH framework
- Structure a myth-buster guide about personal budgeting with a YMYL disclaimer
- Create an 8-unit lesson on Docker basics ready to hand off to
carousel-writer
How to install educational-content-and-how-to
1Skills CLI (Vercel)
npx skills add social-media-skills/skills --skill educational-content-and-how-to -a claude-code2Manually: put the files in place
~/.claude/skills/educational-content-and-how-to/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/educational-content-and-how-to/
1Skills CLI (Vercel)
npx skills add social-media-skills/skills --skill educational-content-and-how-to -a codex2Manually: put the files in place
.agents/skills/educational-content-and-how-to/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add social-media-skills/skills --skill educational-content-and-how-to -a cursor2Manually: put the files in place
.cursor/skills/educational-content-and-how-to/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install social-media-skills/skills educational-content-and-how-to2Manually: put the files in place
.github/skills/educational-content-and-how-to/SKILL.md1Skills CLI (Vercel)
npx skills add social-media-skills/skills --skill educational-content-and-how-to -a gemini-cli2Platform CLI
gemini skills install https://github.com/social-media-skills/skills --path skills/educational-content-and-how-toManually: put the files in place
.devin/skills/educational-content-and-how-to/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add social-media-skills/skills --skill educational-content-and-how-to -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about educational-content-and-how-to
How do I install educational-content-and-how-to in Claude Code?
Run npx skills add social-media-skills/skills --skill educational-content-and-how-to -a claude-code in your terminal.
What does educational-content-and-how-to do?
It designs the core instructional structure of a post by breaking one topic into 8–12 actionable units. Once the lesson is drafted, it routes the text to dedicated tools like carousel-writer or video script generators.
How is this skill different from carousel-writer?
This skill decides the teaching substance, factual accuracy, and step breakdown regardless of platform. carousel-writer simply takes that finished lesson and formats it into slides.
Source text
SKILL.md · MIT
---
name: educational-content-and-how-to
description: >-
The teach-to-grow content type -- pick a genuinely useful topic, teach ONE thing completely,
structure it as a clear lesson, keep it accurate, and route it to the right format. Use when
someone wants to teach their audience, make a how-to / tutorial / step-by-step / explainer /
myth-buster, build authority content, or earn saves. Uses the TEACH framework. Reads
brand-profile + audience-research + content-pillars first. Feeds the format writers
(carousel-writer, reels-script, tiktok-script, thread-writer, caption-writer), hook-writer, the
design/image tools, and lead-magnets/social-selling-and-dm; WoopSocial publishes +
schedules the series. Accuracy is non-negotiable: cite sources, stay within real expertise, YMYL
care, never fabricate steps or stats; measure saves/sends, not likes. Distinct from
carousel-writer (the format it pairs with), reels-script/tiktok-script/thread-writer (other
formats), storytelling-and-narrative (narrative vs didactic), and content-pillars (which topics).
version: 1.0.0
---
# educational-content-and-how-to
The **teach-to-grow content type** — pick a useful topic, teach **one thing completely + accurately**,
structure it, and route it to the right format. The agent **teaches**; the **format writers build it**;
**WoopSocial publishes + serializes.**
## The POV: teach one thing completely, accurately
Teaching is the **highest-trust, highest-save authority builder** — **saves + sends are top-weighted 2026
signals, far above likes** and **educational/how-to content is the most reliable way to earn them** (it's
reference-worthy). The win
isn't recycled generic tips — it's **one genuinely useful idea, taught completely**, as a **flashcard, not a
chapter.** And the gate that separates authority from embarrassment: **accuracy.** Teaching wrong info destroys
trust, and **YMYL** how-tos (health/finance/legal) can cause real harm. The angle works across formats — so the
agent shapes the **lesson** and hands the format mechanics to the writers. **Saves/sends are the metric, not
likes.**
## Read these first
1. **brand-profile** — expertise + voice.
2. **audience-research** — skill level + real pain points.
3. **content-pillars** — which themes.
## The framework: TEACH
(Depth: `references/the-teach-framework.md`.)
- **T — Target one teachable thing:** one process/point/next-step; flashcard not chapter; useful + within real
expertise; if it can't be taught well in one piece, **split into a series.**
- **E — Earn trust with accuracy:** be correct; **cite sources**; stay within expertise; **YMYL → disclaimer +
point to a pro**; never fabricate steps/stats.
- **A — Arrange the lesson:** hook/cover ("is this for me?" + payoff) → context/problem → one step/idea per unit
→ recap → specific CTA; structure step-by-step / PAS / myth-bust / data; 8–12 units, each earns its place.
- **C — Carry it to the right format:** carousel (`carousel-writer`) / tutorial video (`reels-script`/
`tiktok-script`) / thread (`thread-writer`) / post (`caption-writer`); cover → `hook-writer`; visual →
`design-and-templates`/image tools; CTA → `lead-magnets-and-funnels`.
- **H — Harvest saves + serialize:** saves/sends = the top authority signal; serialize a weekly series
(`content-calendar`); evergreen → repurpose across formats (`content-recycling`).
## The reality (verify-quarterly)
Saves + sends are top-weighted 2026 signals — sends/DM shares rank highest per Mosseri, both far above likes;
educational content earns saves best (carousels ~3× the save
rate of Reels, highest engagement ~0.55% vs ~0.50%/0.41%, longest lifespan — Socialinsider/Buffer, attribute;
tutorials inherently saveable + high completion). Teach one job well ("flashcard not chapter"). Structure:
hook/cover (specific, <8–10 words) → context → one step/idea per unit → recap → specific CTA; structures
step/PAS/myth/data; 8–12 units (12–20 deep), every unit earns its place. Format spread: carousel (save king) /
tutorial video / thread / post — same lesson, route to the writer. CTAs: save / send to X / comment GUIDE (→
lead-magnets). Serialize + evergreen → repurpose; **measure saves/sends, not likes.** **Accuracy gate:** cite
sources, stay within expertise, YMYL disclaimer + extra care, never fabricate: `references/educational-content-
2026-reality.md`. The teaching structures, the format-spread table, the accuracy/YMYL checklist, the CTA
library, the WoopSocial flow + worked examples: `references/structures-formats-and-accuracy.md`.
## Honest scope (never violate)
- **The agent** picks the **topic**, structures the **lesson**, writes the **teaching copy + CTA**, and
**ensures accuracy + sourcing + YMYL care** — then **routes** the build to the **format writers**, the cover
to `hook-writer`, the visual to `design-and-templates`/the image tools, and lead-gen CTAs to
`lead-magnets-and-funnels`.
- **WoopSocial publishes + schedules the series.** It does **NOT** verify accuracy, generate the asset, or
teach.
- **Accuracy is non-negotiable** (wrong info destroys authority); **cite sources**; **stay within expertise**;
**YMYL → not-professional-advice disclaimer + point to a pro**; **never fabricate steps/stats** or pad;
**saves/sends = the metric.** (Scope, distinctions + connections: `references/scope-and-connections.md`.)
## Distinct from its siblings (route correctly)
**educational-content-and-how-to (this)** = the teaching ANGLE/substance (what to teach + how to structure a
lesson, across formats) · **carousel-writer** = the carousel FORMAT (they pair — this decides the lesson,
carousel-writer builds the slides) · **reels-script**/**tiktok-script** = the video format · **thread-writer**
= the thread format · **storytelling-and-narrative** = narrative craft (story vs didactic) · **content-pillars**
= which topics · **hook-writer** = the cover/open (pairs) · **data-and-original-research** = producing original
data · **lead-magnets-and-funnels**/**social-selling-and-dm** = the comment-to-DM CTA.
## Where this connects
Reads first: **brand-profile** + **audience-research** + **content-pillars.** Feeds: the **format writers** (the
lesson → the carousel/video/thread/post), **hook-writer** (the cover), **content-calendar** (the series),
**design-and-templates**/**image-prompt** (the visuals). Pairs with: **data-and-original-research** (teach with
original data), **social-seo**/**ai-search-optimization** (how-to is highly indexable + citable in search/AI
answers), **lead-magnets-and-funnels** (the comment-GUIDE CTA). Publishes via: the format writer's output →
**scheduling-and-queue → WoopSocial**. Measure with: native + **analytics-and-reporting** on **saves/sends/
completion** (never fabricated). Accuracy stays with the human/expert.
## Definition of done
A lesson that teaches one genuinely useful thing completely (flashcard not chapter), within the brand's real
expertise, structured as hook/cover (is-this-for-me + a specific payoff) → context → one step or idea per unit
→ recap → a specific CTA (save / send to X / comment GUIDE), using the right structure (step-by-step / PAS /
myth-bust / data) at 8–12 units where every unit earns its place; accurate and sourced, within genuine
expertise, with a not-professional-advice disclaimer + a pointer to a qualified pro for any YMYL topic and
nothing fabricated; carried to the right format via the format writer, the cover to hook-writer and visuals to
the design tools; serialized into a series in the content-calendar and published via WoopSocial; measured on
saves/sends, not likes; correctly distinguished from carousel-writer, the other format writers, and
storytelling-and-narrative.
© social-media-skills · MIT · social-media-skills/skills