| name | publish-content |
| description | Publish an existing draft to one or more platform accounts. Wraps `postall-agent publish`. Activates when the user wish says "publish", "send it out", "post to LinkedIn", or comes at the end of a publishing pipeline. |
Publish Content Skill
Push a draft to its configured platforms via PostAll's publishers.
Inputs
draft_id (required) — the draft to publish.platforms (optional) — subset of platforms to publish to. Default: all platforms the draft was generated for.
If draft_id is missing, return an error final message immediately.
Execution
postall-agent publish --draft "<DRAFT_ID>" [--platforms "<PLATFORMS>"]
Output handling
Parse the JSON. The response includes per-platform success/failure status. Return:
draft_idpublished_to — list of {platform, url, success} entries.
Final message — list each platform on its own line:
Published draft <ID>.
twitter: https://x.com/... ✅
linkedin: https://www.linkedin.com/posts/... ✅
wechat: <error message> ❌
If ANY platform failed, the overall skill should still return success (others may have published). Report mixed results plainly.
If success: false at the top level (catastrophic failure), surface the error.
Composability notes
This is usually the final skill in a publish pipeline. After this step, the wish is complete.
Common failure modes
- Rate limit (Twitter): user must wait and retry tomorrow. Surface the rate-limit message verbatim.
- Auth expired (LinkedIn): user needs to refresh token. Surface and link to the auth refresh script if known.
- Platform refusal (content too long, banned terms): surface the platform's exact reason.
Prerequisite
Same as generate-content — postall-agent must be installed and platform credentials must be configured in the postall environment.
