Agent skill

Optimization Advisor Sms

by blacktwist in blacktwist/social-media-skills

When the user wants concrete recommendations on how to improve their social media performance.

MITAuto-check passedWriting & Content

Install Optimization Advisor Sms

skills CLI
$ npx skills add blacktwist/social-media-skills --skill optimization-advisor-sms -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install blacktwist/social-media-skills optimization-advisor-sms --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/blacktwist/social-media-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/optimization-advisor-sms .claude/skills/optimization-advisor-sms && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
optimization-advisor-sms
GitHub stars
560
Used in
1 other repo
Token cost
~3.1k tokens
SKILL.md length
1,415 words
Files
2
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

When the user wants concrete recommendations on how to improve their social media performance.

  • Works in 4 steps: list_posts — retrieve the last 30 posts… → get_post_analytics — pull engagement… → get_follower_growth — check the growth… → …
  • Wants concrete recommendations on how to improve their social media performance
  • SKILL.md covers When to Use, Role, Context Check and Data Synthesis, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Optimization Advisor Sms is an agent skill from blacktwist/social-media-skills. When the user wants concrete recommendations on how to improve their social media performance. Also use when the user mentions 'what should I do next,' 'how do I improve,' 'optimize my social media,' 'recommendations,' 'suggestions,' 'next steps,' 'what's my biggest opportunity,' or 'help me grow.' Synthesizes insights from performance, audience, and pattern analysis into prioritized actions. For raw analytics, see performance-analyzer-sms. For growth tracking, see audience-growth-tracker-sms. For pattern…

Its SKILL.md is about 3.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files.

It sits in Writing & Content. The repository describes itself as: AI agent skills for social media content strategy, creation, and analysis across text-first platforms. The licence is MIT.

When your agent uses it

  • Wants concrete recommendations on how to improve their social media performance
  • The user mentions what should I do next
  • How do I improve
  • Optimize my social media

Example prompts

  • “what should I do next,”
  • “how do I improve,”
  • “optimize my social media,”
  • “/optimization-advisor-sms”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. list_posts — retrieve the last 30 posts to establish a baseline
  2. get_post_analytics — pull engagement rate, impressions, saves, and reposts per post
  3. get_follower_growth — check the growth trend over the last 30 days
  4. get_recommendations — retrieve platform-generated suggestions from BlackTwist

What it can do on your machine

Read from SKILL.md and the folder at commit 4f85b07. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Optimization Advisor Sms loads about 3.1k tokens when it runs. Until then it costs about 145 tokens; SKILL.md has 1,415 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~145
When it runs · the whole SKILL.md, loaded when a task matches
~3.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from blacktwist/social-media-skills at commit 4f85b07, republished under its MIT licence (© blacktwist). 1,415 words, ~3,088 tokens.

Download SKILL.mdSave it as .claude/skills/optimization-advisor-sms/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
optimization-advisor-sms
description
When the user wants concrete recommendations on how to improve their social media performance. Also use when the user mentions 'what should I do next,' 'how do I improve,' 'optimize my social media,' 'recommendations,' 'suggestions,' 'next steps,' 'what's my biggest opportunity,' or 'help me grow.' Synthesizes insights from performance, audience, and pattern analysis into prioritized actions. For raw analytics, see performance-analyzer-sms. For growth tracking, see audience-growth-tracker-sms. For pattern detection, see content-pattern-analyzer-sms.
metadata.version
1.0.0

Optimization Advisor

When to Use

  • User asks what to do next or how to improve their social media performance
  • User mentions "optimize my social media," "recommendations," or "suggestions"
  • User says "next steps," "what's my biggest opportunity," or "help me grow"
  • User wants a prioritized action plan based on their data
  • User asks "how do I improve" or wants concrete improvement recommendations
  • User has completed an analysis and wants actionable takeaways

Role

You are an expert social media optimization advisor. Your job is to synthesize everything known about a user's performance — metrics, audience growth, content patterns, and goals — into a prioritized, evidence-backed action plan. You do not stop at diagnosis. Every recommendation ends with a specific action the user can take this week, a reason grounded in their own data, and a way to measure success.

Context Check

Before generating any recommendations, read .agents/social-media-context-sms.md (if it exists). This file contains the user's niche, voice, platforms, goals, and audience. Use it to filter every recommendation through their specific situation — a recommendation that is correct for a B2B SaaS founder is wrong for a personal finance creator.

Also check whether any recent analysis exists from sibling skills. If the user has already run performance-analyzer-sms, audience-growth-tracker-sms, or content-pattern-analyzer-sms in this session, incorporate those findings directly rather than re-pulling data.


Data Synthesis

Path A — Prior Analysis Available

If the user has already completed one or more of the following, build on those findings:

  • performance-analyzer-sms findings — top and bottom posts, engagement trends, posting patterns
  • audience-growth-tracker-sms findings — growth rate, growth drivers, spike correlations, milestone progress
  • content-pattern-analyzer-sms findings — Do More / Do Less patterns, untested combinations, format and topic performance

Pull these together into a unified picture. Look for convergence: if performance-analyzer-sms says Tuesday educational threads win AND content-pattern-analyzer-sms confirms the list format outperforms, that is a high-confidence signal worth a top-priority recommendation.

Path B — No Prior Analysis

If no prior analysis exists, run a quick assessment using BlackTwist data before generating recommendations.

Pull in this order:

  1. list_posts — retrieve the last 30 posts to establish a baseline
  2. get_post_analytics — pull engagement rate, impressions, saves, and reposts per post
  3. get_follower_growth — check the growth trend over the last 30 days
  4. get_recommendations — retrieve platform-generated suggestions from BlackTwist

Do not present raw numbers. Interpret them directly into the recommendation framework below.

Path C — No BlackTwist

If BlackTwist is unavailable and no prior analysis exists, ask the user to share what they know:

"To give you the most useful recommendations, I need a quick picture of what's working. Can you share:

  • Your 2–3 best-performing posts (what you posted, approximate engagement)
  • Your 2–3 worst-performing posts
  • Your current posting frequency
  • Your primary goal right now (growth, engagement, conversions, other)

Even rough answers unlock much better recommendations than starting blind."

Work with whatever the user provides and flag confidence levels accordingly.


Recommendation Framework

Organize every recommendation into one of four tiers, ordered by implementation effort. Present them in this order — quick wins first.

Tier 1 — Quick Wins

Changes under one hour that are likely to improve results immediately.

These are execution adjustments, not strategic overhauls. They require no new content creation or platform changes — just applying what the data already shows.

Examples:

  • "Start every post with a specific number — your top 3 posts all open with a stat and average 3× your baseline engagement rate"
  • "Shift your Friday posts to Wednesday — Friday averages 1.8% ER vs. 5.1% on Wednesday"
  • "Add 'Save this for later' to the end of your educational posts — your how-to content gets high impressions but 60% fewer saves than your average"

Each quick win must cite a specific data point, not a general principle.

Example quick win:

Quick Win #1: Start every educational post with a specific number

Why: Your top 3 posts all open with a stat (avg 7.8% ER vs. 3.2% baseline)
Expected impact: 2-3x engagement rate on educational content
Measure: Track ER on next 5 educational posts with stat hooks vs. previous 5 without
Tier 2 — Strategic Shifts

Bigger changes to content mix, platform focus, or cadence that require 2–4 weeks to implement and measure.

These are the recommendations that compound over time. They address misalignments between what the user is currently producing and what their data shows drives results.

Examples:

  • "Shift 20% of your motivational content to storytelling — your personal story posts outperform motivational posts by 40% on engagement rate and drive 3× more comments"
  • "Reduce LinkedIn posting from daily to 4× per week and invest the saved time into longer-form threads — your engagement rate drops on days when you post twice, suggesting quality dilution"
  • "Move from a 60/40 educational/personal split to 50/50 — personal content drives your follower spikes but currently makes up less than a quarter of your output"

Each strategic shift must explain the trade-off, not just the upside.

Tier 3 — Experiments to Run

Specific tests with a hypothesis, a duration, and success criteria.

These are for areas where the data is promising but not conclusive — the user needs more signal before committing to a strategic shift.

Structure each experiment as:

  • Hypothesis: "If I [specific action], then [expected outcome] because [reason from data]"
  • Test: What to do, how many posts, over what time period
  • Success criteria: What result confirms the hypothesis
  • Failure criteria: What result tells you to drop it

Examples:

  • Hypothesis: Posting LinkedIn carousels on Tuesday drives more engagement than text-only posts because your top carousel got 4× your average saves. Test: Publish 3 carousels on Tuesdays over the next 3 weeks. Success: Average ER ≥ 2× your text-post baseline. Failure: ER under 1.5× after 3 tries — move on.
  • Hypothesis: Ending threads with a direct question increases comments because your two most-commented threads both ended with a question. Test: Add a specific question CTA to your next 5 threads. Success: Comments per thread increase by 30%+.

Example experiment card:

Experiment: Tuesday carousel test
Hypothesis: If I post LinkedIn carousels on Tuesdays, then saves increase 2x
  because my top carousel (4x avg saves) was posted on a Tuesday.
Test: Publish 3 carousels on Tuesdays over the next 3 weeks
Success: Average ER >= 2x text-post baseline
Failure: ER under 1.5x after 3 tries — move on
Show full SKILL.md (501 more words)Show less
Tier 4 — Things to Stop

Content types, habits, or behaviors that actively drain time or hurt performance.

These are evidence-based cuts, not opinions. Every "stop" must be backed by data and framed constructively — the user should understand not just what to stop, but what to do instead.

Examples:

  • "Stop posting promotional content without a value hook — your direct promotion posts average 0.9% ER vs. 4.3% for posts that lead with a useful insight before mentioning the offer"
  • "Stop cross-posting identical content to LinkedIn and Threads without adaptation — your cross-posted content underperforms native Threads content by 55% on every metric"
  • "Stop posting on Sundays — you have 6 months of Sunday data and no Sunday post has ever hit your average engagement rate. That time is better spent writing for Monday"

BlackTwist Integration

When BlackTwist is available, always include get_recommendations in the data pull. Treat platform-generated recommendations as one input among many — they may surface patterns the data analysis missed, or they may confirm your own findings.

When a BlackTwist recommendation aligns with a finding from your analysis, that alignment increases confidence. Call it out explicitly: "BlackTwist also flags this pattern — the signal is consistent."

When a BlackTwist recommendation contradicts your analysis, note both views and explain the discrepancy. The user should understand when recommendations conflict.


Output: Action Plan

Deliver recommendations as a numbered, prioritized action plan. Maximum 10 items. Do not pad the list — 7 strong recommendations beat 10 diluted ones.

Recommendation Format

For each item:

  1. What to do — one clear, specific action (not a category, not a vague suggestion)
  2. Why — the evidence from their own data (engagement rates, specific posts, growth spikes)
  3. Expected impact — what should improve and by approximately how much
  4. How to measure — what metric to track and over what time window

Report Template

## Your Optimization Plan — [Date]

**Based on:** [What data/analysis was used]
**Primary opportunity:** [One-sentence summary of the highest-leverage change]

---

### Quick Wins (Do This Week)

1. **[Action]**
   - Why: [Evidence]
   - Expected impact: [Specific improvement]
   - Measure: [Metric + window]

2. **[Action]**
   ...

---

### Strategic Shifts (Do This Month)

3. **[Action]**
   - Why: [Evidence]
   - Expected impact: [Specific improvement]
   - Measure: [Metric + window]

...

---

### Experiments to Run

N. **[Experiment name]**
   - Hypothesis: [If/then/because]
   - Test: [Specific action, N posts, X weeks]
   - Success: [Threshold]

---

### Stop Doing

N. **Stop [behavior]**
   - Why: [Evidence]
   - Do instead: [Replacement behavior]

---

### Your #1 Priority

[One paragraph. The single most important thing this user should change based on everything above. Be direct. If they do nothing else on this list, they should do this.]

Confidence Calibration

State confidence levels when the data is thin. If fewer than 15 posts were analyzed, or if the user provided data rather than pulled it from BlackTwist, flag it:

"This recommendation is based on a limited sample (8 posts). It is directionally useful but treat it as an experiment, not a confirmed pattern."

Do not manufacture confidence. A calibrated "this looks promising, test it" is more valuable than a false certainty.


Boundaries

  • Does not pull raw metrics or build analytics dashboards — see performance-analyzer-sms for data collection
  • Does not track follower growth or audience demographics — see audience-growth-tracker-sms for growth data
  • Does not detect content patterns from scratch — see content-pattern-analyzer-sms for pattern analysis
  • Does not write or draft content — see post-writer-sms, thread-writer-sms, or carousel-writer-sms for creation
  • Does not execute code or access external APIs unless BlackTwist MCP is connected
  • Does not provide generic advice — every recommendation must reference the user's own data or stated context
  • performance-analyzer-sms — get raw post metrics and per-post diagnoses before advising
  • audience-growth-tracker-sms — understand follower growth patterns before advising on growth tactics
  • content-pattern-analyzer-sms — identify Do More / Do Less patterns before advising on content mix
  • social-media-context-sms — establish niche, voice, and goals as the foundation for any recommendation

© blacktwist, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/optimization-advisor-sms of blacktwist/social-media-skills.

  • SKILL.md
  • evals/.gitkeep

Open the folder on GitHubat commit 4f85b07

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in blacktwist/social-media-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Optimization Advisor Sms next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Optimization Advisor Sms compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Optimization Advisor Sms this skillblacktwist/social-media-skills5601 repos~3.1kAutomated safety check: PassMIT
Socialcoreyhaines31/marketingskills54k4 repos~4.5kAutomated safety check: PassMIT
HumanizerAzure-Samples/interview-coach-agent-framework17237 repos~5.8kAutomated safety check: PassMIT
Avoid AI Writingconorbronsdon/avoid-ai-writing4.9k3 repos~8.1kAutomated safety check: PassMIT
JavaScript Concept Fact Checkerleonardomso/33-js-concepts67k1 repos~5kAutomated safety check: PassMIT
User-Facing Text Cleanupguillaumemeyer/watermarks-remover24k—~3.5kAutomated safety check: PassMIT

Similar skills

  • Social

    coreyhaines31/marketingskills

    When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, or Facebook, or wants to do social listening and engagement triage.

    54k GitHub starsUsed in 4 repos~4.5k tokens
    Writing & ContentAuto-check passed
  • Humanizer

    Azure-Samples/interview-coach-agent-framework

    Official

    Remove signs of AI-generated writing from text. An agent skill from Azure-Samples/interview-coach-agent-framework.

    172 GitHub starsUsed in 37 repos~5.8k tokens
    Writing & ContentAuto-check passed
  • Avoid AI Writing

    conorbronsdon/avoid-ai-writing

    Audit and rewrite content to remove AI writing patterns ("AI-isms").

    4.9k GitHub starsUsed in 3 repos~8.1k tokens
    Writing & ContentAuto-check passed
  • JavaScript Concept Fact Checker

    leonardomso/33-js-concepts

    Verifies the technical accuracy of JavaScript concept pages by checking code examples, MDN and ECMAScript claims and external links through a five-phase method.

    67k GitHub starsUsed in 1 repo~5k tokens
    Writing & ContentAuto-check passed
  • User-Facing Text Cleanup

    guillaumemeyer/watermarks-remover

    Audits prose for invisible Unicode characters and rewrites it while keeping facts, citations, code and required disclosures unchanged and the writer's voice intact.

    24k GitHub stars~3.5k tokensUpdated 2 days ago
    Writing & ContentAuto-check passed
  • Social Content

    freekmurze/dotfiles

    When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms.

    1k GitHub starsUsed in 23 repos~2.1k tokens
    Writing & ContentAuto-check passed

More from blacktwist/social-media-skills

All 14 skills in this repo
  • Content Pattern Analyzer Sms

    blacktwist/social-media-skills

    When the user wants to find patterns in what content works and what doesn't.

    560 GitHub starsUsed in 1 repo~3k tokens
    Auto-check passed
  • Performance Analyzer Sms

    blacktwist/social-media-skills

    When the user wants to analyze how their social media posts are performing.

    560 GitHub starsUsed in 1 repo~2.6k tokens
    Auto-check passed
  • Audience Growth Tracker Sms

    blacktwist/social-media-skills

    When the user wants to track follower growth, understand what drives new followers, or analyze audience development.

    560 GitHub stars~3.6k tokensUpdated 5 mo ago
    Auto-check passed
  • Carousel Writer Sms

    blacktwist/social-media-skills

    When the user wants to write content for a LinkedIn carousel, Instagram carousel, Facebook carousel, TikTok photo carousel, Pinterest Idea Pin, or any swipeable multi-slide format.

    560 GitHub stars~4.1k tokensUpdated 5 mo ago
    Auto-check passed
  • Content Calendar Sms

    blacktwist/social-media-skills

    When the user wants to plan a posting schedule, create a content calendar, or organize when and what to post.

    560 GitHub stars~2.8k tokensUpdated 5 mo ago
    Auto-check passed
  • Content Repurposer Sms

    blacktwist/social-media-skills

    When the user wants to turn one piece of content into multiple formats or adapt content across text-first and visual-first platforms (LinkedIn, Twitter/X, Threads, Bluesky, Facebook, Instagram…

    560 GitHub stars~3.7k tokensUpdated 5 mo ago
    Auto-check passed

Questions about Optimization Advisor Sms

What does Optimization Advisor Sms do?

When the user wants concrete recommendations on how to improve their social media performance. Optimization Advisor Sms is an agent skill from blacktwist/social-media-skills. When the user wants concrete recommendations on how to improve their social media performance.

When should I use Optimization Advisor Sms?

Optimization Advisor Sms fits situations like: wants concrete recommendations on how to improve their social media performance; the user mentions what should I do next; how do I improve; optimize my social media.

How do I install Optimization Advisor Sms in Claude Code?

Run `npx skills add blacktwist/social-media-skills --skill optimization-advisor-sms -a claude-code`. Or copy the skill folder (skills/optimization-advisor-sms in blacktwist/social-media-skills) into .claude/skills/optimization-advisor-sms in your project. Claude Code loads it when a task matches its description.

How do I install Optimization Advisor Sms in Codex?

Run `npx skills add blacktwist/social-media-skills --skill optimization-advisor-sms -a codex`. Or copy the skill folder (skills/optimization-advisor-sms in blacktwist/social-media-skills) into .agents/skills/optimization-advisor-sms in your project. Codex loads it when a task matches its description.

Can I use Optimization Advisor Sms in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add blacktwist/social-media-skills --skill optimization-advisor-sms -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/optimization-advisor-sms, .gemini/skills/optimization-advisor-sms, .github/skills/optimization-advisor-sms and .opencode/skills/optimization-advisor-sms in your project.

What does Optimization Advisor Sms need to run?

SKILL.md names no scripts, command-line tools or credentials: Optimization Advisor Sms is instructions for the agent only.

Does Optimization Advisor Sms access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Optimization Advisor Sms safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Optimization Advisor Sms use?

Optimization Advisor Sms is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Optimization Advisor Sms use?

About 3.1k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Optimization Advisor Sms?

Skills that share tags, products or a category with Optimization Advisor Sms: Social (coreyhaines31/marketingskills, 54k stars), Humanizer (Azure-Samples/interview-coach-agent-framework, 172 stars), Avoid AI Writing (conorbronsdon/avoid-ai-writing, 4.9k stars) and JavaScript Concept Fact Checker (leonardomso/33-js-concepts, 67k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Optimization Advisor Sms?

blacktwist (a GitHub organization) maintains it in blacktwist/social-media-skills, which has 560 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on May 1, 2026.

Source: blacktwist/social-media-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.