# Send Itinerary Carousel Post Topaz 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-topaz", "name": "Itinerary Carousel Post Topaz", "source": "tencent", "type": "skill", "category": "AI 智能", "sourceUrl": "https://clawhub.ai/psyduckler/itinerary-carousel-post-topaz", "canonicalUrl": "https://clawhub.ai/psyduckler/itinerary-carousel-post-topaz", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/itinerary-carousel-post-topaz", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=itinerary-carousel-post-topaz", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "references/instagram-graph-api.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/itinerary-carousel-post-topaz" }, "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-topaz", "downloadUrl": "https://openagent3.xyz/downloads/itinerary-carousel-post-topaz", "agentUrl": "https://openagent3.xyz/skills/itinerary-carousel-post-topaz/agent", "manifestUrl": "https://openagent3.xyz/skills/itinerary-carousel-post-topaz/agent.json", "briefUrl": "https://openagent3.xyz/skills/itinerary-carousel-post-topaz/agent.md" } } ``` ## Documentation ### Create Instagram Carousel Post (Topaz Enhanced) End-to-end pipeline: itinerary URL → photo sourcing → Topaz AI enhance → text overlays → Instagram carousel publish. Identical to itinerary-carousel-post except Sub-agent 1 includes a Topaz enhancement step after selecting the best photo for each subject. ### 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 + Topaz Enhancement 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 5. Topaz Enhance each best image: TOPAZ_API_KEY=$(security find-generic-password -s "topaz-api-key" -w) curl --request POST \\ --url https://api.topazlabs.com/image/v1/enhance \\ --header "X-API-Key: ${TOPAZ_API_KEY}" \\ --header 'accept: image/jpeg' \\ --header 'content-type: multipart/form-data' \\ --form 'model=Low Resolution V2' \\ --form 'output_scale_factor=2' \\ --form 'output_format=jpeg' \\ --form "image=@/tmp/ig-carousel/${slug}-best.jpg" \\ --output "/tmp/ig-carousel/${slug}-enhanced.jpg" If the sync endpoint times out or returns a process_id instead of image bytes, use the async flow: # Async: submit RESPONSE=$(curl -s --request POST \\ --url https://api.topazlabs.com/image/v1/enhance/async \\ --header "X-API-Key: ${TOPAZ_API_KEY}" \\ --header 'content-type: multipart/form-data' \\ --form 'model=Low Resolution V2' \\ --form 'output_scale_factor=2' \\ --form 'output_format=jpeg' \\ --form "image=@/tmp/ig-carousel/${slug}-best.jpg") PROCESS_ID=$(echo "$RESPONSE" | jq -r '.process_id') # Poll status until Completed while true; do STATUS=$(curl -s --header "X-API-Key: ${TOPAZ_API_KEY}" \\ "https://api.topazlabs.com/image/v1/status/${PROCESS_ID}" | jq -r '.status') [ "$STATUS" = "Completed" ] && break sleep 3 done # Download result curl -s --header "X-API-Key: ${TOPAZ_API_KEY}" \\ "https://api.topazlabs.com/image/v1/download/${PROCESS_ID}" \\ --output "/tmp/ig-carousel/${slug}-enhanced.jpg" Model choice: Low Resolution V2 — designed for web-sourced images (exactly our use case). Handles JPEG compression artifacts, low resolution, and general softness. Fast and cheap. Parameters explained: output_scale_factor=2 — doubles the input resolution (2x upscale). For typical IG-sourced images (~1080px), this produces ~2160px which gives the overlay step plenty of resolution to work with. output_format=jpeg — keeps file size reasonable for IG's 8MB limit Output: 6 enhanced images at /tmp/ig-carousel/{slug}-enhanced.jpg + JSON manifest at /tmp/ig-carousel/manifest.json: [{"slug": "kuala-lumpur", "subject": "Kuala Lumpur", "score": 7, "path": "/tmp/ig-carousel/kuala-lumpur-enhanced.jpg", "original": "/tmp/ig-carousel/kuala-lumpur-best.jpg", "source": "instagram.com/p/XXX/", "topaz_enhanced": true}] ### Sub-agent 2: Text Overlays Read manifest from sub-agent 1. Run overlay script for each enhanced image. Slide 1 (cover) — clean style: python3 skills/instagram-photo-text-overlay/scripts/overlay.py \\ --input /tmp/ig-carousel/{dest-slug}-enhanced.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}-enhanced.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) ### Topaz API Auth Key from macOS Keychain: topaz-api-key — Topaz Labs API key ### 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. Topaz sync endpoint may return image bytes directly (check Content-Type header). If it returns JSON with process_id, switch to async flow. Topaz rate limits: If you get HTTP 429, use exponential backoff. Processing 6 images sequentially should be fine. Keep originals: The manifest stores both path (enhanced) and original so you can compare quality or fall back if Topaz fails on a specific image. ## Trust - Source: tencent - Verification: Indexed source record - Publisher: psyduckler - Version: 1.0.0 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-30T16:55:25.780Z - Expires at: 2026-05-07T16:55:25.780Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/itinerary-carousel-post-topaz) - [Send to Agent page](https://openagent3.xyz/skills/itinerary-carousel-post-topaz/agent) - [JSON manifest](https://openagent3.xyz/skills/itinerary-carousel-post-topaz/agent.json) - [Markdown brief](https://openagent3.xyz/skills/itinerary-carousel-post-topaz/agent.md) - [Download page](https://openagent3.xyz/downloads/itinerary-carousel-post-topaz)