fix-failed-posts
Installation
SKILL.md
Fix failed posts
Find what failed, explain why in plain words, fix the cause, and retry only when a retry can work.
Steps
- Find the failures. Call
list_posts_advancedwithstatus: "failed"(and"partially_failed"), newest first. For one post the user named, callget_post_resultswith its id. - Read the reason. Each failed destination carries an error. Sort it into one of these:
- The account needs reconnecting (expired or revoked login, missing permission). Call
get_account_healthfor that account to confirm, thencreate_reconnect_linkand give the user the link. They open it and sign in again. - The post broke a platform rule (too long, wrong media, missing media). Fix it with
update_post, then retry. - A temporary problem at the platform (rate limit, timeout, the platform was down). Retry.
- Something the user must change on the platform itself (for example, an Instagram account that isn't a Business or Creator account). Tell them exactly what to change.
- The account needs reconnecting (expired or revoked login, missing permission). Call
- Retry. For one post, call
retry_failed_post. For many, callretry_failed_postswith the post ids, or filter byaccount_idorplatform. Don't retry a failure that needs the user to act first; it will fail the same way. - Confirm. Call
get_post_resultsagain after a short wait and tell the user what published.
Be careful
- Never retry the same post in a loop. One retry after a fix is enough.
- Retrying a post that already published on some platforms only retries the failed ones.