X (Twitter) Post
What This Agent Does
This Agent converts any URL, article, report, DataStream, or custom brief into X-ready posts that respect character limits, handle link length correctly, trim hashtags, normalize a single safe mention, and always return valid XML for reliable scheduling — even when inputs are blank, contradictory, or messy.
It’s tuned for X norms:
- Punchy hooks in the first line
- One clear idea per post (fragments allowed for punch)
- Tight character control (with link length counted at ~23 characters)
- Tasteful, optional use of emojis (off by default)
- Disciplined hashtags (0–4)
- Optional image handling (uploaded or AI-generated)
When to Use It
Perfect for:
- Breaking news updates (fast, factual, contextual)
- Driving clicks to articles/reports without getting cut off
- Announcing releases with crisp, professional framing
- Promoting events (what/when/where + urgency)
- Sparking replies with one strong, open-ended question
Use it when you need:
- Character-accurate posts that won’t get truncated
- Clean XML output for schedulers or APIs
- Smart defaults that enforce X etiquette
When Not to Use It
Avoid this Agent for:
- Other platforms (use the Facebook/Instagram/LinkedIn Agents)
- Longform essays or multi-asset campaigns beyond a 5-post thread
- Heavily visual meme/emoji styles (the Agent defaults to professional)
Inputs & Configuration
Basic Configuration
Field | Required? | Description |
---|---|---|
Input_Source | ✅ | Valid URL, article, DataStream, or custom text (≥50 words preferred). |
PostGoal | ✅ | Break news update, Drive clicks, Spark replies, Promote event, Announce release (examples). |
Target Word Count | ✅ | Short 120–180 chars • Standard 180–260 chars (default) • Long 260–400 chars. |
Advanced Configuration
Field | Required? | Description |
---|---|---|
Include Link | Optional | Default on. If a URL exists, counts as ~23 chars (X rule) and is appended properly. |
Hashtag Limit | Optional | 0–4 (default 2). If 0, omit hashtags. |
Audience Description | Optional | e.g., Tech reporters, Crypto traders, Policy wonks, PMs. Guides references, jargon, urgency. |
Mentions Toggle | Optional | Default off. If on, allows exactly one normalized @mention. |
Company Name | Optional | Used only if MentionsToggle is on. If blank, outputs @CompanyName placeholder. |
Emojis Toggle | Optional | Default off. If on, up to 2 tasteful emojis; never lead, never stack. |
CTA | Optional | Dropdown: None, Read more, Learn more, Watch now, Join the conversation, Share your take, Register today, Follow for updates, Set a reminder. |
Brand Voice | Optional | Persona to control rhythm/phrasing. |
Desired Tone | Optional | Concise, Confident, Direct (default), Friendly, Informative, Neutral, Playful, Professional, Witty. |
Brand Guidelines | Optional | Editable multitext (defaults provided). If filled, overrides Voice and Tone. |
Language Model | ✅ | Default GPT-4o. |
Image Model | Optional | Default Ideogram v3 balanced (used only if AI image enabled). |
Brand Controls (Plain-English Rule)
- If you paste rules in Brand Guidelines, the Agent follows them first (they override everything).
- If guidelines are empty, it uses Brand Voice.
- If no voice, it uses Desired Tone.
- If none are set, defaults to concise, confident, direct (X-appropriate professional style).
Composition Rules
- Hook first: lead with the key info or tension.
- One clear idea per post; fragments okay for impact.
- Structure: prefer one compact paragraph; one optional line break is allowed.
- Assembly order:
- Post text (include the single mention if enabled)
- CTA (if any)
- Link (if allowed and URL exists — counts ~23 chars)
- Hashtags (end, ≤ HashtagLimit)
Audience shaping:
- Tech reporters → headline + number;
- Policy wonks → implication + action;
- Traders → speed + clarity;
- PMs → outcome + signal.
Hard constraints:
- No invented facts, no clickbait filler
- Strictly no em/en dashes (use
-
) - Respect character targets and thread caps
Image Handling
You can either upload an image or generate one with the chosen Image Model.
Modes
Uploaded
- Attach your brand photo or graphic
- No AI image credits used
- The Agent provides a concise caption that ties the visual to the caption
AI-Generated
- The Agent creates a literal, realistic scene description for the selected Image Model
- The Agent always provides a caption
- Uses image credits and takes a little longer
Credits & Usage
- Text-only runs → lowest credit use.
- Uploaded images → no additional AI image credits.
- AI-generated images → consume image credits (slightly longer run).
Tip: Save credits on routine updates and news by uploading brand visuals; use AI images when you need fresh, campaign-specific scenes.
Output Mapping to X + XML Order
<primary_text>
→ The post body (or numbered thread content in a single block).<cta>
→ A short call-to-action line, placed before link/hashtags.<link_url>
→ A detected URL (if IncludeLink is on), counted as ~23 chars.<hashtags>
→ Up to HashtagLimit tags, appended at end.<mentions>
→ Exactly one normalized mention when enabled (or@CompanyName
placeholder).<thread_mode>
→on
oroff
.<image_description>
→ Only for AI generation (empty for uploads).<image_caption>
→ Short tie-in caption for any image mode.
Defaults (Pre-Configured for Success)
- Length: Standard 180–260 characters
- IncludeLink: On
- HashtagLimit: 2
- Mentions: Off (max one mention when on)
- Emojis: Off (enable for up to 2 tasteful emojis)
- Tone: Concise, confident, direct
Post Goal Patterns
- Break news → Lead with the update; add one line of why it matters.
- Drive clicks → Tease value; CTA + link; keep hashtags minimal.
- Announce release → State plainly; optional benefit + availability.
- Promote event → What/when/where; urgency + CTA; link if applicable.
- Spark replies → One clear, open-ended question (no multi-question lists).
Examples
Breaking news
Breaking: SEC approves first spot crypto ETF. What it means for retail liquidity and fund flows ↓
Drive clicks (Standard)
New study: SMBs cut churn by 25% with 2 onboarding tweaks and one billing change. Full breakdown and templates here 👇 [link] #SaaS #Retention
Announce release
Shipped: Real-time dashboards for all Pro plans. Cleaner signals, faster decisions — available today.
Promote event
Live Q&A this Thursday, 1pm ET — practical playbooks for scaling from 0→$10M ARR. Save your seat: [link] #SaaS #Startups
Spark replies
What’s one metric you’d retire from your weekly review — and what would you replace it with?
Smart Behaviors & Validation
- Source: If empty or <50 words → infer safe neutral context from Post Goal. If URL only → treat as link candidate (unless Include Link = false). If text contains URL → extract first valid URL.
- Length: Targets your band; if Include Link on and URL present, counts ~23 chars for link.
- Goal: If missing → Spark replies. If conflict (e.g., Drive clicks + IncludeLink off) → keep framing, omit link.
- Hashtags: Clamp 0–4; dedupe; keep relevant; append at end.
- Mentions: If enabled, exactly one normalized
@handle
or placeholder. - Emojis: If enabled, up to 2; never lead; never stack or repeat.
- Character safety: No em/en dashes; use
-
. Use...
not…
. No entities in text ("
,'
); escape<
,>
,&
properly inside XML. - Never double-escape or output malformed tags.
Troubleshooting
- “My link isn’t included.”
Include Link may be off, or no valid URL was found in the source. - “Why only one @mention?”
By design for safety and to prevent spam/abuse. Seperate mentions with a comma. - “Post exceeds the character limit.”
This is an approximation. Switch to a shorter Length Preference. The Agent will tighten phrasing to fit. - “Hashtags are fewer than I set.”
The Agent trims duplicates/irrelevancies and clamps to your Hashtag Limit (max 4). - “Emojis didn’t show up.”
Emojis Toggle is off by default. Turn it on to allow up to 2/3 subtle emojis. - “Tone doesn’t match our brand.”
Paste rules into Brand Guidelines (they override everything), or select Brand Voice / Desired Tone. - “The output has odd characters.”
The Agent sanitizes long dashes and entities. Paste clean ASCII or rely on the cleanup the Agent applies.
FAQs
Q: Can I include a link and a CTA?
Yes. CTA appears before the link; the link counts as ~23 characters.
Q: Do uploaded images consume credits?
No. Only AI-generated images use additional image credits.
Q: Will I always get valid XML?
No — Choose the format to download
Q: Can it tag people?
Yes — Separate mentions with a comma
Bottom Line
The X (Twitter) Post Generator delivers punchy, professional posts that respect character limits, handle links/mentions/hashtags correctly, and output valid XML your scheduler can trust. Whether it’s a single update or a tight 5-post thread, set your goal and tone — the Agent does the rest.