# Send Itinerary Carousel Post to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "itinerary-carousel-post",
    "name": "Itinerary Carousel Post",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/psyduckler/itinerary-carousel-post",
    "canonicalUrl": "https://clawhub.ai/psyduckler/itinerary-carousel-post",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/itinerary-carousel-post",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=itinerary-carousel-post",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/instagram-graph-api.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "itinerary-carousel-post",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-04T12:03:36.585Z",
      "expiresAt": "2026-05-11T12:03:36.585Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=itinerary-carousel-post",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=itinerary-carousel-post",
        "contentDisposition": "attachment; filename=\"itinerary-carousel-post-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "itinerary-carousel-post"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/itinerary-carousel-post"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/itinerary-carousel-post",
    "downloadUrl": "https://openagent3.xyz/downloads/itinerary-carousel-post",
    "agentUrl": "https://openagent3.xyz/skills/itinerary-carousel-post/agent",
    "manifestUrl": "https://openagent3.xyz/skills/itinerary-carousel-post/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/itinerary-carousel-post/agent.md"
  }
}
```
## Documentation

### Create Instagram Carousel Post

End-to-end pipeline: itinerary URL → photo sourcing → text overlays → Instagram carousel publish.

### Parameters

itinerary_url (required): tabiji.ai itinerary URL (e.g. https://tabiji.ai/i/thaw-dome/)
destination (required): City/region name (e.g. "Kuala Lumpur")
attractions (required): List of 5 attraction names + short descriptions
caption (optional): Custom caption. If omitted, generate one with destination name, attraction list, CTA to link in bio, and relevant hashtags.

### Pipeline (3 chained sub-agents recommended)

Split into 3 sub-agents for reliability. Each writes outputs to /tmp/ig-carousel/.

### Sub-agent 1: Photo Finding

Use the instagram-photo-find skill workflow for each subject (1 destination + 5 attractions = 6 total).

For each subject:

web_search: site:instagram.com/p/ "{subject}" photo (10 results)
Download top 5 candidates: curl -s -L -o /tmp/ig-carousel/raw-{slug}-{n}.jpg "https://www.instagram.com/p/{shortcode}/media/?size=l"
Vision-score each with: "Rate 1-10 as hero destination photo for {subject}. Description + score only."
Keep best per subject → /tmp/ig-carousel/{slug}-best.jpg

Output: 6 best images + JSON manifest at /tmp/ig-carousel/manifest.json:

[{"slug": "kuala-lumpur", "subject": "Kuala Lumpur", "score": 7, "path": "/tmp/ig-carousel/kuala-lumpur-best.jpg", "source": "instagram.com/p/XXX/"}]

### Sub-agent 2: Text Overlays

Read manifest from sub-agent 1. Run overlay script for each image.

Slide 1 (cover) — clean style:

python3 skills/instagram-photo-text-overlay/scripts/overlay.py \\
  --input /tmp/ig-carousel/{dest-slug}-best.jpg \\
  --output /tmp/ig-carousel/slide-1.jpg \\
  --title "{N} Day {DESTINATION} Itinerary Highlights" \\
  --style clean --watermark "tabiji.ai"

Slides 2–6 — quote style per attraction with insider tip:

python3 skills/instagram-photo-text-overlay/scripts/overlay.py \\
  --input /tmp/ig-carousel/{slug}-best.jpg \\
  --output /tmp/ig-carousel/slide-{N}.jpg \\
  --title "{ATTRACTION}" \\
  --quote "{Specific insider tip about THIS attraction — must directly reference the place in the title, not a generic travel tip}" \\
  --author "tabiji.ai" \\
  --style quote --watermark "tabiji.ai"

Output: 6 overlay images at /tmp/ig-carousel/slide-{1-6}.jpg

### Sub-agent 3: Publish to Instagram

Host images publicly — copy slides to tabiji repo (img/instagram/), git push, use raw GitHub URLs (https://raw.githubusercontent.com/psyduckler/tabiji/main/img/instagram/slide-{N}.jpg). Wait ~30s after push for GitHub CDN.


Create carousel item containers (one per slide):

curl -s -X POST "https://graph.facebook.com/v21.0/${IG_USER}/media" \\
  -d "image_url=${PUBLIC_URL}" \\
  -d "is_carousel_item=true" \\
  -d "access_token=${IG_TOKEN}"

Create carousel container with all children + caption:

curl -s -X POST "https://graph.facebook.com/v21.0/${IG_USER}/media" \\
  --data-urlencode "caption=${CAPTION}" \\
  -d "media_type=CAROUSEL" \\
  -d "children=${CHILD_IDS}" \\
  -d "access_token=${IG_TOKEN}"

Publish:

curl -s -X POST "https://graph.facebook.com/v21.0/${IG_USER}/media_publish" \\
  -d "creation_id=${CAROUSEL_ID}" \\
  -d "access_token=${IG_TOKEN}"

Get permalink (or verify publish on rate-limit error):

If media_publish returns a POST_ID, get the permalink directly:

curl -s "https://graph.facebook.com/v21.0/${POST_ID}?fields=permalink&access_token=${IG_TOKEN}"

If media_publish returns error 2207051 (rate limit / action blocked): Instagram sometimes processes the request despite returning an error. Always verify by checking the account's recent media before declaring failure:

curl -s "https://graph.facebook.com/v21.0/${IG_USER}/media?fields=id,timestamp,permalink&limit=1&access_token=${IG_TOKEN}"

If the most recent post timestamp is within the last few minutes, the publish likely succeeded — grab that permalink.

Cleanup hosted images — after publish is confirmed, delete the images from the tabiji repo and push:

cd /path/to/tabiji/repo
git rm img/instagram/slide-*.jpg
git commit -m "cleanup: remove instagram carousel images after publish"
git push

Also clean up local temp files:

rm -rf /tmp/ig-carousel/

Output: Instagram post URL

### Instagram API Auth

Keys from macOS Keychain:

instagram-access-token — Graph API token
instagram-account-id — IG user ID (17841449394591017)

### Caption Template

🇲🇾 {N} Nights in {Destination} — {Itinerary Subtitle}

{One-line hook about the trip}

📍 Swipe through our top 5 picks:
1. {Attraction 1} — {one-line reason}
2. {Attraction 2} — {one-line reason}
3. {Attraction 3} — {one-line reason}
4. {Attraction 4} — {one-line reason}
5. {Attraction 5} — {one-line reason}

Full free itinerary with tips, prices & Reddit recs 👉 {ITINERARY_URL}

💬 {PROVOCATIVE_QUESTION — e.g. "Is 5 nights enough for {Destination} or do you need more?" or "What's the one thing most tourists get wrong about {Destination}?"}

#{destination_hashtag} #{country} #travelitinerary #foodietravel #southeastasia #asiatravel #travelguide #tabiji

### Tips

Raw GitHub URLs work for IG image_url; tabiji.ai Cloudflare CDN may trigger format validation errors.
Add sleep 1 between container creation calls to avoid rate limits.
If a subject yields low photo scores (<5), broaden search: try Unsplash/Flickr or more specific landmark names.
Islamic/cultural museums tend to have fewer quality IG photos — try searching the museum's official IG handle.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: psyduckler
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-04T12:03:36.585Z
- Expires at: 2026-05-11T12:03:36.585Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/itinerary-carousel-post)
- [Send to Agent page](https://openagent3.xyz/skills/itinerary-carousel-post/agent)
- [JSON manifest](https://openagent3.xyz/skills/itinerary-carousel-post/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/itinerary-carousel-post/agent.md)
- [Download page](https://openagent3.xyz/downloads/itinerary-carousel-post)