About
The `suede-social` skill creates organic social media content—like posts, carousels, scripts, and calendars—for founder or brand accounts. It is specifically for planning and strategy, requiring approval before any publishing or engagement action. Use it for organic content planning, but not for paid ads, broader editorial strategy, or full video production.
Quick Install
Claude Code
Recommendednpx skills add JasonColapietro/suede-creator-skills -a claude-code/plugin add https://github.com/JasonColapietro/suede-creator-skillsgit clone https://github.com/JasonColapietro/suede-creator-skills.git ~/.claude/skills/suede-socialCopy and paste this command in Claude Code to install this skill
Documentation
Suede Organic 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.
Before Creating Content
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):
1. Goals
- What's the primary objective? (Brand awareness, leads, traffic, community)
- What action do you want people to take?
- Are you building personal brand, company brand, or both?
2. Audience
- Who are you trying to reach?
- What platforms are they most active on?
- What content do they engage with?
3. Brand Voice
- What's your tone? (Professional, casual, witty, authoritative)
- Any topics to avoid?
- Any specific terminology or style guidelines?
4. Resources
- How much time can you dedicate to social?
- Do you have existing content to repurpose?
- Can you create video content?
Platform Quick Reference
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 |
|---|---|---|
| B2B, professional expertise | Text posts, documents, stories | |
| Twitter/X | Real-time expertise and community | Short posts, threads, replies |
| Visual brands and creator narratives | Reels, carousels, Stories | |
| TikTok | Native short-form storytelling | Vertical video, series, replies |
| 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
Content Pillars Framework
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.
Example for a SaaS Founder
| 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.
Pillar Development Questions
For each pillar, ask:
- What unique perspective do you have?
- What questions does your audience ask?
- What content has performed well before?
- What can you create consistently?
- What aligns with business goals?
Hook Formulas
The first line determines whether anyone reads the rest.
Curiosity Hooks
- "I was wrong about [common belief]."
- "The real reason [outcome] happens isn't what you think."
- "[Impressive result] — and it only took [surprisingly short time]."
Story Hooks
- "Last week, [unexpected thing] happened."
- "I almost [big mistake/failure]."
- "3 years ago, I [past state]. Today, [current state]."
Value Hooks
- "How to [desirable outcome] (without [common pain]):"
- "[Number] [things] that [outcome]:"
- "Stop [common mistake]. Do this instead:"
Contrarian Hooks
- "Unpopular opinion: [bold statement]"
- "[Common advice] is wrong. Here's why:"
- "I stopped [common practice] and [positive result]."
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.
Content Repurposing System
Test whether one approved source can yield several useful, distinct assets without stretching the evidence or repeating the same point.
Blog Post → Social Content
| Platform | Format |
|---|---|
| Key insight with link placement tested against current guidance and account results | |
| Carousel of main points | |
| Twitter/X | Thread of key takeaways |
| Carousel with visuals | |
| Reel summarizing the post |
Podcast / Video → Social Content
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:
- Get transcript — use Whisper, Descript, or your podcast host's transcription
- Mark timestamps — flag the 5-10 best moments while listening or scanning transcript
- Extract clips — pull video/audio clips for each moment (Descript, Opus Clip, or manual)
- Write standalone captions — each clip needs context; don't assume the viewer heard the rest
- Add subtitles — make the clip accessible without assuming a universal sound-off rate
- Plan a distribution test — choose timing from current cadence, source volume, approval capacity, and account evidence
Starting extraction hypothesis, only when the source supports enough distinct moments and the team can review them:
- 3-5 short video clips or audiograms (15-60 sec) for Reels/TikTok/Shorts
- 1-2 LinkedIn text posts from key insights
- 1 Twitter/X thread of takeaways
- 1 carousel summarizing the main framework or list
- 1 newsletter section or blog post from the best segment
Webinar / Live Event → Social Content
| 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 |
Newsletter → Social Content
| 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 |
Repurposing Workflow
- Create pillar content (blog, video, podcast, webinar, newsletter)
- Extract content atoms (5-10 per piece — quotes, stories, tips, data)
- Adapt to each platform (format, length, and tone)
- Write standalone captions (each post must work without context)
- Plan distribution from current cadence and approval capacity
- Test updates or reshares only when current relevance and account evidence support them
X: Third-Party Video + Owned Article
When promoting an owned X Article with a relevant third-party video:
- Use only the video as native media, and only with a lawful basis to reuse it. Preserve source attribution.
- Do not quote, repost, or inherit the third party's whole post, caption, replies, or engagement context.
- Create a fresh post from the approved account with the exact approved copy, then place the owned Article status URL at the end so X renders the owned Article as the quoted card.
- Before publishing, verify the identity, native video, owned Article card, exact text, audience, and reply settings.
- After publishing, verify the live post still contains both the native video 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.
Content Calendar Structure
Illustrative Planning Grid
Use this only as a worksheet shape. Fill cells from the approved platform hypotheses and production capacity; blank cells are valid.
| Slot | Twitter/X | ||
|---|---|---|---|
| 1 | Industry insight | Thread | Carousel |
| 2 | Behind-scenes | Reply draft | Story test |
| 3 | Educational | Short post | Reel test |
Batching Pilot
Set the timebox and output count from current capacity. A possible first pilot:
- Review content pillar topics.
- Draft one or two variants for each selected platform.
- Prepare only the approved asset concepts.
- Return the batch for exact-content review before scheduling or publishing.
Engagement Strategy
Participation test (15–30 minute starting estimate)
- Triage relevant comments on owned posts.
- Draft 2–5 substantive replies to approved target-account posts.
- Draft at most one share or quote post when it adds sourced context.
- Draft a direct message only when the relationship and platform norms support 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.
Quality Comments
- Add new insight, not just "Great post!"
- Share a related experience
- Ask a thoughtful follow-up question
- Respectfully disagree with nuance
Building Relationships
- Build a bounded account set with explicit audience-fit reasons
- Participate only when the post is relevant and the visible identity is approved
- Share their content with credit
- Eventually collaborate (podcasts, co-created content)
Analytics & Optimization
Metrics That Matter
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
Review Interval
- Choose an interval that contains enough comparable posts; weekly is only a starting estimate for active accounts.
- Compare a higher- and lower-performing cohort and test why they differed.
- Follower growth trend
- Engagement rate trend
- Timing patterns from current account data, with sample size and timezone
Optimization Actions
If engagement is low:
- Test new hooks
- Post at different times
- Try different formats
- Test a bounded participation routine
If reach is declining:
- Compare link and no-link posts at similar account conditions
- Test one cadence change within production capacity
- Compare comments, text, document, image, and video formats against the account baseline
Content Ideas by Situation
When You're Starting Out
- Document your journey
- Share what you're learning
- Curate and comment on industry content
- Test a capacity-bounded participation routine with relevant accounts
When You're Stuck
- Repurpose old high-performing content
- Ask your audience what they want
- Comment on industry news
- Share a failure or lesson learned
Scheduling Best Practices
When to Schedule vs. Post Live
Schedule: Core content posts, Threads, Carousels, Evergreen content
Post live: Real-time commentary, Responses to news/trends, Engagement with others
Queue Management
- Set queue depth from current news sensitivity, approval capacity, and account cadence
- Review the queue before publication and whenever material context changes
- Leave gaps for spontaneous posts
- Adjust timing based on performance data
Evidence-Based Content Pattern Analysis
Instead of guessing, analyze a lawful, recent sample from comparable accounts:
- Define comparables — Similar audience, offer, account maturity, and platform; record why each account belongs in the sample.
- Collect a bounded sample — Use only data the current platform and account access lawfully expose. Set the count from available volume and stop when another batch no longer changes the leading patterns.
- Analyze patterns — Compare hooks, formats, CTAs, reach, retention, saves, and replies only where the platform exposes those measures.
- Codify playbook — Document repeatable patterns
- Layer your voice — Apply patterns with authenticity
- Convert — Bridge attention to business results
For the complete framework: See references/reverse-engineering.md
Short-Form Video (TikTok, Reels, Shorts)
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.
Platform test specs
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 |
Opening-hook hypothesis
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.
Video Structures
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
Caption & Subtitle Best Practices
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.
- MAX 2 lines on screen at once
- 3-5 words per line
- Bold, sans-serif font with black outline
- Highlight key words in a different color
- Match timing to speech exactly
Tools: CapCut (free), Descript, Captions.ai, Premiere Pro
Content Ideas by Type
| 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 |
Common Mistakes
- Unclear opening — test whether the premise is understood in the first 1–3 seconds
- No accessible captions — provide captions independent of sound-off-rate assumptions
- Unusable audio — verify speech intelligibility on target devices
- Unsupported length — compare length bands against retention and the idea
- Missing next step — include a CTA only when the objective needs one
- Unreviewed comments — choose response priority from relevance and account evidence, not a universal first-hour rule
For video hook formulas and scripting templates: See references/short-form-video.md
Task-Specific Questions
- What platform(s) are you focusing on?
- What's your current posting frequency?
- Do you have existing content to repurpose?
- What content has performed well in the past?
- How much time can you dedicate weekly?
- Are you building personal brand, company brand, or both?
Boundaries
- Do not publish, schedule, reply, follow, message, like, repost, or otherwise act as an account without explicit approval of the exact content and visible identity.
- Do not invent performance, trends, quotes, audience sentiment, or account access; distinguish observed platform evidence from hypotheses.
- Do not impersonate people, scrape private spaces, evade platform rules, or turn sensitive personal data into engagement material.
Routing
- Use
suede-content-strategyfor the broader editorial system. - Use
suede-videofor full video generation and production. - Use
suede-ad-creativefor paid social concepts and variants. - Use
suede-analyticsfor channel measurement and performance readback.
GitHub Repository
Frequently asked questions
What is the suede-social skill?
suede-social is a Claude Skill by JasonColapietro. Skills package instructions and resources that Claude loads on demand, so Claude can perform suede-social-related tasks without extra prompting.
How do I install suede-social?
Use the install commands on this page: add suede-social to Claude Code as a plugin, or clone its repository into your skills directory, then restart Claude so it picks up the skill.
What category does suede-social belong to?
suede-social is in the Meta category, tagged ai.
Is suede-social free to use?
Yes. suede-social is listed on AIMCP and free to install.
Related Skills
This skill provides a production-tested setup for Content Collections, a TypeScript-first tool that transforms Markdown/MDX files into type-safe data collections with Zod validation. Use it when building blogs, documentation sites, or content-heavy Vite + React applications to ensure type safety and automatic content validation. It covers everything from Vite plugin configuration and MDX compilation to deployment optimization and schema validation.
This skill enables developers to build applications with the Polymarket prediction markets platform, including API integration for trading and market data. It also provides real-time data streaming via WebSocket to monitor live trades and market activity. Use it for implementing trading strategies or creating tools that process live market updates.
This skill helps developers create OpenCode plugins that hook into 25+ event types like commands, files, and LSP operations. It provides the plugin structure, event API specifications, and implementation patterns for JavaScript/TypeScript modules. Use it when you need to intercept, monitor, or extend the OpenCode AI assistant's lifecycle with custom event-driven logic.
SGLang is a high-performance LLM serving framework that specializes in fast, structured generation for JSON, regex, and agentic workflows using its RadixAttention prefix caching. It delivers significantly faster inference, especially for tasks with repeated prefixes, making it ideal for complex, structured outputs and multi-turn conversations. Choose SGLang over alternatives like vLLM when you need constrained decoding or are building applications with extensive prefix sharing.
