SKILL·894644

suede-social

JasonColapietro
Updated Yesterday
165
8
165
View on GitHub
Metaai

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

Recommended
Primary
npx skills add JasonColapietro/suede-creator-skills -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/JasonColapietro/suede-creator-skills
Git CloneAlternative
git clone https://github.com/JasonColapietro/suede-creator-skills.git ~/.claude/skills/suede-social

Copy 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.

PlatformCommon Fit HypothesisFormats to Test
LinkedInB2B, professional expertiseText posts, documents, stories
Twitter/XReal-time expertise and communityShort posts, threads, replies
InstagramVisual brands and creator narrativesReels, carousels, Stories
TikTokNative short-form storytellingVertical video, series, replies
FacebookCommunities and local audiencesGroups, 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

PillarStarting Share HypothesisTopics
Industry insights20–30%Trends, data, predictions
Behind-the-scenes20–30%Building the company, lessons learned
Educational20–30%How-tos, frameworks, tips
Personal10–20%Stories, values, informed opinions
Promotional0–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:

  1. What unique perspective do you have?
  2. What questions does your audience ask?
  3. What content has performed well before?
  4. What can you create consistently?
  5. 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

PlatformFormat
LinkedInKey insight with link placement tested against current guidance and account results
LinkedInCarousel of main points
Twitter/XThread of key takeaways
InstagramCarousel with visuals
InstagramReel summarizing the post

Podcast / Video → Social Content

Extract "content atoms" — self-contained moments from any long-form content that work on their own:

Atom TypeWhat to Look ForCandidate Formats to Test
Quotable momentA bold claim, hot take, or memorable line (15-60 sec)Twitter/X, LinkedIn, TikTok
Story arcA complete mini-story with setup, conflict, resolution (60-90 sec)Instagram Reels, TikTok, YouTube Shorts
Tactical tipA specific how-to or framework explained clearly (30-60 sec)LinkedIn, YouTube Shorts
Controversial takeA contrarian opinion that sparks debateTwitter/X, LinkedIn
Data/stat calloutA surprising number or research findingLinkedIn carousel, Twitter/X
Behind-the-scenesAuthentic, unpolished momentsInstagram Stories, TikTok

Podcast repurposing workflow:

  1. Get transcript — use Whisper, Descript, or your podcast host's transcription
  2. Mark timestamps — flag the 5-10 best moments while listening or scanning transcript
  3. Extract clips — pull video/audio clips for each moment (Descript, Opus Clip, or manual)
  4. Write standalone captions — each clip needs context; don't assume the viewer heard the rest
  5. Add subtitles — make the clip accessible without assuming a universal sound-off rate
  6. 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

ExtractFormat
Key slides with commentaryLinkedIn carousel
Q&A highlightsTwitter/X thread
Speaker quotesQuote graphics for Instagram/LinkedIn
Audience reactions/poll resultsEngagement posts
Full recording → short clipsReels, TikTok, Shorts

Newsletter → Social Content

ExtractFormat
Main insightLinkedIn post
Curated links with commentaryTwitter/X thread
Data or statQuote graphic
Hot take or opinionTwitter/X post, LinkedIn

Repurposing Workflow

  1. Create pillar content (blog, video, podcast, webinar, newsletter)
  2. Extract content atoms (5-10 per piece — quotes, stories, tips, data)
  3. Adapt to each platform (format, length, and tone)
  4. Write standalone captions (each post must work without context)
  5. Plan distribution from current cadence and approval capacity
  6. 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:

  1. Use only the video as native media, and only with a lawful basis to reuse it. Preserve source attribution.
  2. Do not quote, repost, or inherit the third party's whole post, caption, replies, or engagement context.
  3. 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.
  4. Before publishing, verify the identity, native video, owned Article card, exact text, audience, and reply settings.
  5. 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.

SlotLinkedInTwitter/XInstagram
1Industry insightThreadCarousel
2Behind-scenesReply draftStory test
3EducationalShort postReel test

Batching Pilot

Set the timebox and output count from current capacity. A possible first pilot:

  1. Review content pillar topics.
  2. Draft one or two variants for each selected platform.
  3. Prepare only the approved asset concepts.
  4. Return the batch for exact-content review before scheduling or publishing.

Engagement Strategy

Participation test (15–30 minute starting estimate)

  1. Triage relevant comments on owned posts.
  2. Draft 2–5 substantive replies to approved target-account posts.
  3. Draft at most one share or quote post when it adds sourced context.
  4. 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:

  1. Define comparables — Similar audience, offer, account maturity, and platform; record why each account belongs in the sample.
  2. 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.
  3. Analyze patterns — Compare hooks, formats, CTAs, reach, retention, saves, and replies only where the platform exposes those measures.
  4. Codify playbook — Document repeatable patterns
  5. Layer your voice — Apply patterns with authenticity
  6. 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:

PlatformStarting Length TestStarting CanvasEvidence to Read
TikTok15–60 seconds9:16Retention, completion, qualified actions
Reels15–45 seconds9:16Retention, saves, shares, qualified actions
Shorts20–60 seconds9:16Retention, 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 TypeVideo Ideas
SaaSFeature demos (show outcome first), before/after, "Watch me do X in Y seconds"
E-commerceUnboxing, comparisons, how it's made, customer reviews
ServicesProcess reveals, client transformations, myth-busting
Personal brandLessons learned, controversial takes, day-in-the-life

Common Mistakes

  1. Unclear opening — test whether the premise is understood in the first 1–3 seconds
  2. No accessible captions — provide captions independent of sound-off-rate assumptions
  3. Unusable audio — verify speech intelligibility on target devices
  4. Unsupported length — compare length bands against retention and the idea
  5. Missing next step — include a CTA only when the objective needs one
  6. 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

  1. What platform(s) are you focusing on?
  2. What's your current posting frequency?
  3. Do you have existing content to repurpose?
  4. What content has performed well in the past?
  5. How much time can you dedicate weekly?
  6. 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-strategy for the broader editorial system.
  • Use suede-video for full video generation and production.
  • Use suede-ad-creative for paid social concepts and variants.
  • Use suede-analytics for channel measurement and performance readback.

GitHub Repository

JasonColapietro/suede-creator-skills
Path: skills/suede-social
0
agent-orchestrationagent-skillsai-agentsai-evalanthropicci
FAQ

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

content-collections
Meta

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.

View skill
polymarket
Meta

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.

View skill
creating-opencode-plugins
Meta

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.

View skill
sglang
Meta

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.

View skill