jasoncolapietro/suede-social
Suede-owned organic social strategy and content discipline. Use when planning platform mix, posts, threads, carousels, short-form scripts, calendars, repurposing, listening, engagement, or cadence for a founder or brand account. NOT FOR: paid ad creative (use suede-ad-creative), broader editorial strategy (use suede-content-strategy), full video production (use suede-video), or publishing and engagement without approval.
npx skills add https://github.com/JasonColapietro/suede-creator-skills --skill suede-social
Suede Social turns verified product context and live platform evidence into
organic posts, threads, carousels, short-form scripts, listening briefs, and
content calendars. It distinguishes creation from account action and keeps every
publish or engagement step behind exact-content approval.
Check for product marketing context first:
If .agents/product-marketing.md exists (or .claude/product-marketing.md, or the legacy product-marketing-context.md filename, in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.
Gather this context (ask if not provided):
Treat these as format hypotheses, not universal reach or frequency rules.
Before setting cadence, read current official platform guidance plus the
account's last 30–90 days of impressions, retention, saves, replies, follows,
and production capacity. Start with the lowest cadence that can sustain quality,
then change one variable at a time.
| Platform | Common Fit Hypothesis | Formats to Test |
|----------|-----------------------|-----------------|
| LinkedIn | B2B, professional expertise | Text posts, documents, stories |
| Twitter/X | Real-time expertise and community | Short posts, threads, replies |
| Instagram | Visual brands and creator narratives | Reels, carousels, Stories |
| TikTok | Native short-form storytelling | Vertical video, series, replies |
| Facebook | Communities and local audiences | Groups, posts, native video |
For detailed platform strategies: See references/platforms.md
For hashtag limits and character counts: See references/platform-limits.md
Start with 3–5 pillars only when that range fits the account's expertise,
audience coverage, and production capacity. Merge or expand after the first
review cycle based on current results.
| Pillar | Starting Share Hypothesis | Topics |
|--------|---------------------------|--------|
| Industry insights | 20–30% | Trends, data, predictions |
| Behind-the-scenes | 20–30% | Building the company, lessons learned |
| Educational | 20–30% | How-tos, frameworks, tips |
| Personal | 10–20% | Stories, values, informed opinions |
| Promotional | 0–10% | Product updates, offers |
These ranges are a first content-mix test, not a universal formula. Reallocate
from qualified audience response and business outcomes.
For each pillar, ask:
The first line determines whether anyone reads the rest.
For post templates and more hooks: See references/post-templates.md
For carousels (Instagram carousels, LinkedIn document posts): See references/carousel-frameworks.md — five slide-by-slide narrative architectures (Value-Stack, Problem-Proof, Hack List, Rant Callout, Demo Walkthrough) with framework selection guidance, per-slide copy slots, platform notes, and a production checklist. Pick the framework before writing slides.
Test whether one approved source can yield several useful, distinct assets
without stretching the evidence or repeating the same point.
| Platform | Format |
|----------|--------|
| LinkedIn | Key insight with link placement tested against current guidance and account results |
| LinkedIn | Carousel of main points |
| Twitter/X | Thread of key takeaways |
| Instagram | Carousel with visuals |
| Instagram | Reel summarizing the post |
Extract "content atoms" — self-contained moments from any long-form content that work on their own:
| Atom Type | What to Look For | Candidate Formats to Test |
|-----------|-----------------|---------------------------|
| Quotable moment | A bold claim, hot take, or memorable line (15-60 sec) | Twitter/X, LinkedIn, TikTok |
| Story arc | A complete mini-story with setup, conflict, resolution (60-90 sec) | Instagram Reels, TikTok, YouTube Shorts |
| Tactical tip | A specific how-to or framework explained clearly (30-60 sec) | LinkedIn, YouTube Shorts |
| Controversial take | A contrarian opinion that sparks debate | Twitter/X, LinkedIn |
| Data/stat callout | A surprising number or research finding | LinkedIn carousel, Twitter/X |
| Behind-the-scenes | Authentic, unpolished moments | Instagram Stories, TikTok |
Podcast repurposing workflow:
sound-off rate
volume, approval capacity, and account evidence
**Starting extraction hypothesis, only when the source supports enough distinct
moments and the team can review them:**
| Extract | Format |
|---------|--------|
| Key slides with commentary | LinkedIn carousel |
| Q&A highlights | Twitter/X thread |
| Speaker quotes | Quote graphics for Instagram/LinkedIn |
| Audience reactions/poll results | Engagement posts |
| Full recording → short clips | Reels, TikTok, Shorts |
| Extract | Format |
|---------|--------|
| Main insight | LinkedIn post |
| Curated links with commentary | Twitter/X thread |
| Data or stat | Quote graphic |
| Hot take or opinion | Twitter/X post, LinkedIn |
support them
When promoting an owned X Article with a relevant third-party video:
Preserve source attribution.
replies, or engagement context.
then place the owned Article status URL at the end so X renders the owned
Article as the quoted card.
exact text, audience, and reply settings.
and owned Article card, then capture the permalink.
If X's Quote composer accepts the video but leaves publishing disabled, use the
fresh-post construction above or report the blocker. Never substitute a quote
of the third party's post.
Use this only as a worksheet shape. Fill cells from the approved platform
hypotheses and production capacity; blank cells are valid.
| Slot | LinkedIn | Twitter/X | Instagram |
|-----|----------|-----------|-----------|
| 1 | Industry insight | Thread | Carousel |
| 2 | Behind-scenes | Reply draft | Story test |
| 3 | Educational | Short post | Reel test |
Set the timebox and output count from current capacity. A possible first pilot:
it; never send without exact-content and identity approval.
Run this on 3–5 active days for two weeks only as a starting hypothesis. Compare
qualified replies, profile visits, follows, and time cost with the prior period.
For surfacing *which* posts may merit a comment draft (bounded ranked lists,
brand/competitor monitoring, intent-signal triage), see
references/listening.md.
approved
Awareness: Impressions, Reach, Follower growth rate
Engagement: Engagement rate, comments, shares/reposts, saves; weight them
according to the campaign objective rather than a universal hierarchy
Conversion: Link clicks, Profile visits, DMs received, Leads attributed
starting estimate for active accounts.
If engagement is low:
If reach is declining:
baseline
Schedule: Core content posts, Threads, Carousels, Evergreen content
Post live: Real-time commentary, Responses to news/trends, Engagement with others
cadence
Instead of guessing, analyze a lawful, recent sample from comparable accounts:
platform; record why each account belongs in the sample.
access lawfully expose. Set the count from available volume and stop when
another batch no longer changes the leading patterns.
and replies only where the platform exposes those measures.
For the complete framework: See references/reverse-engineering.md
Short-form video may be a useful discovery format when current platform
guidance and account-level results support it. Verify that premise for the
specific account before prioritizing it; the frameworks below organize a test,
not a guaranteed reach outcome.
Verify current official upload requirements and the authenticated composer
before production. If account evidence is unavailable, use these as first-test
ranges, not optimal lengths:
| Platform | Starting Length Test | Starting Canvas | Evidence to Read |
|----------|----------------------|-----------------|------------------|
| TikTok | 15–60 seconds | 9:16 | Retention, completion, qualified actions |
| Reels | 15–45 seconds | 9:16 | Retention, saves, shares, qualified actions |
| Shorts | 20–60 seconds | 9:16 | Retention, rewatches, search and channel actions |
Test whether the first 1–3 seconds establish enough visual, verbal, or text
context to retain the intended viewer. Use one or more hook modes as the concept
requires; do not require all three without account evidence:
[VISUAL HOOK] + [VERBAL HOOK] + [TEXT OVERLAY]
Compare opening variants against the account's comparable-format retention
baseline before standardizing the pattern.
Problem-Solution (15-30 sec):
[0-3s] Hook: State the problem
[3-10s] Agitate: Why it matters
[10-25s] Solution: Your method/product/tip
[25-30s] CTA: What to do next
List Format (30-60 sec):
[0-3s] Hook: "X things that [outcome]"
[3-50s] Items: One every 5-8 seconds
[50-60s] CTA
Tutorial (30-60 sec):
[0-3s] Hook: Show the end result first
[3-8s] Overview: "Here's how..."
[8-50s] Steps: Quick, clear instructions
[50-60s] Result + CTA
Use captions as an accessibility and comprehension default. Treat any watch-time
lift or sound-off viewing rate as account-specific: verify it with current
retention and audio metrics where the platform exposes them.
Tools: CapCut (free), Descript, Captions.ai, Premiere Pro
| Business Type | Video Ideas |
|---------------|-------------|
| SaaS | Feature demos (show outcome first), before/after, "Watch me do X in Y seconds" |
| E-commerce | Unboxing, comparisons, how it's made, customer reviews |
| Services | Process reveals, client transformations, myth-busting |
| Personal brand | Lessons learned, controversial takes, day-in-the-life |
1–3 seconds
assumptions
evidence, not a universal first-hour rule
For video hook formulas and scripting templates: See references/short-form-video.md
act as an account without explicit approval of the exact content and visible
identity.
access; distinguish observed platform evidence from hypotheses.
turn sensitive personal data into engagement material.
suede-content-strategy for the broader editorial system.suede-video for full video generation and production.suede-ad-creative for paid social concepts and variants.suede-analytics for channel measurement and performance readback.Take jasoncolapietro/suede-social from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.