Skip to content
SkillMedia & Content Creation

Social Caption Checker

Agent Skill that checks captions for Instagram, TikTok, Facebook, YouTube, X, Threads, LinkedIn and Pinterest against limits, hashtag caps, the 'more' fold and disclosure.

Updated Oct 30, 2026Marketplace Founder

About Social Caption Checker

A caption can fail in small ways that cost reach or trust. Instagram now allows only 5 hashtags. Some problems are easy to miss: a hook cut off before "more", #self-care quietly becoming #self, a link that isn't clickable, an X post over 280 once the link counts as 23, or a sponsored post with no disclosure.

This skill checks a batch of captions in one go. It works on a Markdown file with one section per caption or a CSV export from your planner. A bundled script checks each caption against an editable limits file: length (weighted for X), YouTube and Pinterest titles, the first line against the "more" fold, hashtag counts and duplicates, broken hashtags, @mentions, links that won't be clickable, too many capitals, and words from your own banned list. It flags sponsored captions without a clear disclosure, codes or affiliate links with no disclosure, weak tags like #sp or #collab, and disclosures buried after the fold. Then the AI rewrites the captions that fail, in your voice, and checks them again.

Inside: SKILL.md, the checker script (Node.js, no packages), an editable limits file with notes and an as-of date, a platform rules reference, and sample captions with reports and test runs.

For creators, small businesses and social media managers who post on several platforms.

Limitations: platform limits change and some are reported differently, so check the app if a post won't publish. X weighting is approximate. The disclosure check is a prompt to think, not legal advice.

Scanned: no issues found

Release v1.0.0 reviewed by AgentLoomX™ · 16 files · 24.7 KB

Signed release

This package can

  • Create, change or delete files
What's inside (16 files)
  • social-caption-checker/assets/limits.json
  • social-caption-checker/CHANGELOG.md
  • social-caption-checker/examples/captions-fixed.md
  • social-caption-checker/examples/captions.csv
  • social-caption-checker/examples/captions.md
  • social-caption-checker/examples/report-csv.md
  • social-caption-checker/examples/report-fixed.md
  • social-caption-checker/examples/report-md.md
  • social-caption-checker/examples/test-runs.md
  • social-caption-checker/examples/walkthrough.md
  • social-caption-checker/LICENSE.txt
  • social-caption-checker/README.md
  • social-caption-checker/references/platform-rules.md
  • social-caption-checker/scripts/captions.mjs
  • social-caption-checker/scripts/lib.mjs
  • social-caption-checker/SKILL.md
Read the skill's instructions social-caption-checker/SKILL.md
---
name: social-caption-checker
description: Checks social media captions before posting, for Instagram, TikTok, Facebook, YouTube (title and description), X, Threads, LinkedIn and Pinterest. It checks length (weighted for X), the first line against the "more" fold, hashtag counts (Instagram's 5-hashtag cap), duplicate and broken hashtags, @mentions, links that won't be clickable, shouting capitals and banned words. It flags sponsored or affiliate captions without a clear disclosure. Then it rewrites failing captions and checks them again. Use when the user says things like "check my captions", "is this caption too long", "how many hashtags can I use", "will this fit on X", "check these before I schedule them", "proofread my posts for Instagram", or shares a content calendar or caption file.
---

# Social Caption Checker

Check a batch of captions against each platform's rules, fix what fails, and check again.

Rules you never break:

1. **Keep the user's facts and voice.** Fixes change length, hashtags, layout and disclosure, never prices, dates, claims or tone.
2. **Never add a disclosure the user didn't confirm, and never remove one.** If a caption might be sponsored, ask.
3. **The limits file is the source.** Quote its numbers and its "checked" date. Platforms change, so say so.

## Bundled files

| File | When to use it |
|---|---|
| `scripts/captions.mjs` | Step 2 and Step 4. Checks a Markdown or CSV file of captions and prints a report. Read-only unless `--out` is pas

…

The full file is included with your purchase.

SHA-256 8f8f6d474878d199c20fd5e0a66de44bfbcf027bc86ec7a749fbda4f746e9b6a

Signed with Ed25519 key a9c62a7921065aa9. Public keys

Scans catch known risky patterns; they are not a guarantee. Report anything that looks wrong to support.

Highlights

  • Limits for 8 platforms in one editable file
  • Instagram's 5-hashtag cap and the 'more' fold
  • Catches broken and duplicate hashtags
  • X weighted length with links counted as 23
  • Flags missing or weak sponsored disclosures
  • Rewrites failing captions, then rechecks
  • captions
  • instagram
  • tiktok
  • hashtags
  • social media
  • content qa