mcpField
M
muapi-social-pack

muapi-social-pack

github.com/samuraigptMarketing & growth864 installsUpdated 4w ago
Repository

About muapi-social-pack

A muapi skill that reframes a supplied hero image into selected aspect ratios for social platforms. It processes formats in parallel, preserves the subject and original look, and skips a format when the source already matches it.

Key features

  1. 01Reframe an existing source image
  2. 02Process requested formats in parallel
  3. 03Keep subject centred and uncropped
  4. 04Match original lighting and palette
  5. 05Optional caption headroom
  6. 06Skip formats already matched

Use cases

  1. 01Prepare one image for several social platforms
  2. 02Create square, portrait, and landscape versions
  3. 03Add space above the subject for a caption

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/samuraigpt/muapi-skills --skill muapi-social-pack

After installing, type/muapi-social-packin Claude Code to confirm it loaded.

Details

From the project README

Social Media Pack

Re-render a hero image into Instagram, TikTok, YouTube-shorts and Twitter/X aspect ratios.

Inputs

NameTypeRequiredDefaultDescription
source_imageimage_urlyes—URL of the hero image (or asset_id from this session).
caption_ideatextno—Optional caption / overlay direction (kept short).
formatslistno1:1, 9:16, 4:5, 16:9Aspect ratios to produce.

Steps

Use the plan to fan out one node per format.

  1. For each requested aspect ratio in {{formats}}:
    • Call muapi image edit (model=nano-banana-2-edit) with the source image.
    • Prompt: "Reframe the composition to {{aspect_ratio}} for social media. Keep the subject centred and uncropped. Match the original lighting and palette. {{caption_idea_hint}}".
    • Where {{caption_idea_hint}} = "Leave headroom at the top for a caption: '<caption_idea>'." (only if caption_idea is non-empty).
  2. All formats run in parallel (no inter-node dependencies).
  3. Return one asset id per format, labelled with the platform it suits:
    • 1:1 → Instagram feed
    • 9:16 → TikTok / IG Reels / YT Shorts
    • 4:5 → Instagram portrait
    • 16:9 → Twitter / X / YouTube
    • 21:9 → cinematic banner

Notes

  • Don't generate fresh images — only reframe / re-edit the source.
  • If the source already matches a format, skip that node and surface the original asset id for it.

Trigger Keywords

social pack, resize for social, cross-post, multi-platform

Notes for the Executing Agent

  • This recipe is LLM-orchestrated: read each phase, gather any missing inputs from the user, then call muapi CLI commands. Use muapi auth configure first if MUAPI_API_KEY is unset.
  • For model IDs without a CLI alias yet, fall back to the raw endpoint via curl -X POST https://api.muapi.ai/api/v1/<endpoint> -H "x-api-key: $MUAPI_API_KEY" -H 'content-type: application/json' -d '{...}' and poll with muapi predict wait <request_id>.
  • Substitute {{input_name}} placeholders with the user's actual inputs before issuing each call.

Comments

Markdown supported