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.Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.
Brainstorm and write high-retention short-form video and carousel content for TikTok, Reels, and YouTube Shorts. Use whenever someone wants viral hook ideas, a video script or outline, content concepts for a product or topic, or wants to critique and improve a draft hook or script. Works for any storytime, listicle, carousel, or meme. Produces several diverse hook options from proven patterns, structures scripts for retention (hook, escalation, payoff, CTA), and adapts to each platform. Pattern-based guidance grounded in how short-form tends to perform; it improves the odds, it does not guarantee virality."
Generate short-form video ideas at volume and stop the blank-page problem for good. Use whenever someone says they're stuck for ideas, asks for 20 TikTok ideas or Reels ideas or YouTube Shorts ideas for their niche, wants a content brainstorm, needs help building a content pillar system or content matrix, wants to turn one idea into 5 angles, asks what to post this week, or wants a real idea generator workflow instead of staring at a notes app. Runs the systems prolific creators actually use: pillars, mining (comments, Reddit, search autocomplete, competitor outliers), repurposing, evergreen vs trend balance. Pattern-based guidance grounded in how short-form ideation tends to work; never run out of ideas is the goal, virality is not promised.
| This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.
Create and publish concise Rivet launch or changelog posts through an approval-gated workflow, including release research, a required user-selected hero variation, local HTML-rendered social and technical images, an R2 hero upload, MDX authoring, a reviewed draft GitHub PR for manual merge, and a scheduled and verified Buffer thread for @rivet_dev. Use when asked to launch, announce, ship, or prepare and schedule a Rivet feature or release announcement.
This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.
Generate a daily digest of today's policy-authorized meetings and voice memos — key decisions, action items, and themes across available recordings. Use when the user asks "recap my day", "what happened in my meetings today", "daily summary", "what did I discuss today", "any action items from today", or wants a consolidated view of the day's conversations.
Generate a daily digest of today's policy-authorized meetings and voice memos — key decisions, action items, and themes across available recordings. Use when the user asks "recap my day", "what happened in my meetings today", "daily summary", "what did I discuss today", "any action items from today", or wants a consolidated view of the day's conversations.
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.