Skip to content
Skills Library
Marketing & content · Automation

fix-failed-posts

/fix-failed-posts

Find out why a Reelspan post failed on some networks, fix it, and retry only those networks. Use when a post shows failed networks, the user says a post didn't go out, a status shows errors, or history has failed rows.

Licence
MIT
Last repository change
12.11.2026

Assessment and security

96/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content31 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 12.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Find out why a Reelspan post failed on some networks, fix it, and retry only those networks. Use when a post shows failed networks, the user says a post didn't go out, a status shows errors, or history has failed rows.

Original author description

Find out why a Reelspan post failed on some networks, fix it, and retry only those networks. Use when a post shows failed networks, the user says a post didn't go out, a status shows errors, or history has failed rows.

How it works

SKILL.md has no level-two headings · 25 lines, 214 words

SKILL.md preview
---
name: fix-failed-posts
description: Find out why a Reelspan post failed on some networks, fix it, and retry only those networks. Use when a post shows failed networks, the user says a post didn't go out, a status shows errors, or history has failed rows.
---

# Fix failed posts

1. **Find what failed.** With a request id: `GET /v1/posts/status?request_id=…`. Without one:
   `GET /v1/posts?status=failed&limit=20` (add `profile_username`). Group the failures by `error_code`.
2. **Read the cause** from `error` / `error_code` and the table in the `reelspan` skill's
   [errors reference](../reelspan/references/errors.md). The usual ones:
   - not connected, or the token expired: the user reconnects that network (send a connect link if it is a client's
     account: `POST /v1/connect-links`);
   - the media doesn't fit (ratio, size, duration): re-export it; for Bluesky over 100 MB set `bluesky_compress=true`;
   - the caption is too long, or a duplicate: shorten or vary it for that network;
   - a required setting is missing (Pinterest board, subreddit, a TikTok privacy level the account allows).
3. **Explain it in one line per network**, with the fix you propose. Ask before changing the caption or media.
4. **Retry only those networks**, with the changed fields:

```bash
curl -s "$API/posts/retry" -H "$AUTH" -H 'Content-Type: application/json' \
  -d '{"request_id":"REQ","platforms":["instagram","pinterest"],"fields":{"instagram_title":"Shorter caption","pinterest_board_id":"123"}}'
```

5. **Poll status** again and report the result. If the same error comes back, stop and say what the user needs to do
   (reconnect, add a scope, change the media); don't loop.

A failure that needs the network's own app review or a missing permission can't be fixed by retrying: say so plainly.

Versions

RepositoryScoreLicence
This page · Reelspan/reelspan-skills96MIT
bulkpublish/hermes-bulkpublish90MIT

Database snapshot: 13.11.2026 · package version f223f07d36f9 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100reelspan
    Publish, schedule and track social media posts with the Reelspan API (TikTok, YouTube, Instagram, Facebook, X, Threads, LinkedIn, Pinterest, Bluesky, Reddit and more). Use when the user wants to post or schedule a video, photos, a carousel, text or a PDF to social networks,…
  • 90analyze-performance
    Analyze how a profile's social posts performed with Reelspan analytics and turn it into a short report - what to post more of, when to post, and what to drop. Use when the user asks how their posts or accounts are doing, which posts worked best, follower growth, the best time to…
  • 100using-bulkpublish
    Schedule, publish and analyse social media posts across 15 networks through BulkPublish. Use whenever the user wants to draft, queue, cross-post, retry or measure social content, or asks about their channels, queue or posting quota.
  • 90solmarrow-social
    Draft, schedule and check social media posts across 19 networks through the SolMarrow MCP server. Use when the user wants to plan, write, schedule or review posts for X, LinkedIn, Facebook, Instagram, Threads, Bluesky, TikTok, YouTube, Pinterest, Telegram, Discord and more.
  • 90studio
    Operate a self-hosted Studio deployment — write, publish, schedule and edit posts and short-form video, read publication and audience analytics, and diagnose a post that did not reach a platform. Use whenever the request is about publishing, a channel, a draft, a scheduled post,…
  • 100queue-status
    Shows the publishing queue and helps cancel, reschedule or restore a post. Use when asked for "queue status", "what is scheduled", "a post failed", "cancel post X", "move post X to Friday", "restore post X", or in Portuguese "status da fila", "cancela o post", "adia o post", "o post falhou".

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.