muapi-instagram-post — Claude Code skill: install and usage
Generates Instagram visuals along with matching captions and hashtags via the muapi CLI. Useful for feed posts and Reels covers.
npx skills add SamurAIGPT/Generative-Media-Skills --skill muapi-instagram-post -a claude-codeWhat muapi-instagram-post does
This skill takes a brief, an optional brand style guide, and an aspect ratio (1:1, 4:5, or 9:16). It writes an image prompt specifying lighting direction and focal points, then triggers muapi image generate on the nano-banana-2 model. When an existing product image is provided in the conversation, it runs muapi image edit instead to maintain visual consistency.
Once the image is ready, the agent composes a caption of two to four lines. It begins with an opening hook before adding the brand message and a call to action, followed by 15 to 20 hashtags. For 9:16 formats, it includes advice on overlay text placement. The process fails if MUAPI_API_KEY is not set: configure credentials beforehand using muapi auth configure.
What it helps with
- generate feed visuals or Reels covers matching brand style
- draft focused two-to-four-line captions with hooks and CTAs
- assemble targeted blocks of 15 to 20 hashtags
- edit existing product images to preserve brand consistency
Example prompts for the agent
- Create an Instagram post: summer coffee launch at our cafe, warm golden vibes
- Generate a 9:16 Reels cover and caption for our new ceramic collection
- Draft a 4:5 portrait post with hashtags announcing a weekend workshop
How to install muapi-instagram-post
1Skills CLI (Vercel)
npx skills add SamurAIGPT/Generative-Media-Skills --skill muapi-instagram-post -a claude-code2Manually: put the files in place
~/.claude/skills/muapi-instagram-post/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/muapi-instagram-post/
1Skills CLI (Vercel)
npx skills add SamurAIGPT/Generative-Media-Skills --skill muapi-instagram-post -a codex2Manually: put the files in place
.agents/skills/muapi-instagram-post/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add SamurAIGPT/Generative-Media-Skills --skill muapi-instagram-post -a cursor2Manually: put the files in place
.cursor/skills/muapi-instagram-post/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install SamurAIGPT/Generative-Media-Skills muapi-instagram-post2Manually: put the files in place
.github/skills/muapi-instagram-post/SKILL.md1Skills CLI (Vercel)
npx skills add SamurAIGPT/Generative-Media-Skills --skill muapi-instagram-post -a gemini-cli2Platform CLI
gemini skills install https://github.com/SamurAIGPT/Generative-Media-Skills --path .opencode/skills/muapi-instagram-postManually: put the files in place
.devin/skills/muapi-instagram-post/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add SamurAIGPT/Generative-Media-Skills --skill muapi-instagram-post -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about muapi-instagram-post
How to install muapi-instagram-post in Claude Code?
Run npx skills add SamurAIGPT/Generative-Media-Skills --skill muapi-instagram-post -a claude-code in your terminal.
What does muapi-instagram-post do?
It orchestrates the muapi CLI to generate a post image, drafts a short caption with a hook, and generates relevant hashtags.
What credentials are required to use this skill?
You need the muapi CLI installed and an active MUAPI_API_KEY configured via muapi auth configure.
Source text
SKILL.md · MIT
---
slug: muapi-instagram-post
name: muapi-instagram-post
version: "1.0.0"
description: Create a polished, on-brand Instagram post — square or portrait hero image with matching caption and hashtags.
acceptLicenseTerms: true
---
# Instagram Post
**Create a polished, on-brand Instagram post — square or portrait hero image with matching caption and hashtags.**
## Inputs
| Name | Type | Required | Default | Description |
|:---|:---|:---|:---|:---|
| `brief` | text | yes | — | What the post is about (e.g. "summer coffee launch at our café, warm golden vibes"). |
| `brand_style` | text | no | modern, vibrant, clean typography, lifestyle photography aesthetic | Brand personality and visual style tags. |
| `format` | text | no | 1:1 | Post format — "1:1" for feed square, "4:5" for portrait feed, "9:16" for Reels. |
## Steps
This skill produces one polished Instagram-ready visual + caption. Use the plan if generating more than one variant.
### Phase A — Generate the hero image
1. Write a detailed, atmosphere-rich image prompt based on `{{brief}}` and `{{brand_style}}`:
- Include lighting direction, color palette, mood, subject placement, and lens feel.
- Optimize for Instagram aesthetics: clean, punchy, single focal point.
- Append style tags: `{{brand_style}}, social media photography, highly detailed`.
2. Call `muapi image generate` (model=nano-banana-2, aspect_ratio=`{{format}}`).
3. If the user provided a product or subject image in the session, prefer `muapi image edit` instead to maintain visual consistency.
### Phase B — Caption & Hashtags
After the image is generated, compose and return:
- **Caption**: 2–4 lines. Hook line first (punchy, curiosity-driving), then brand message, then CTA.
- **Hashtags**: 15–20 targeted hashtags (mix of niche, mid-tier, and broad). Format as a separate block.
## Notes
- Prioritize scroll-stopping first impressions — the image must visually communicate the brief within 2 seconds.
- If `format` is `9:16` (Reels cover), note that text overlays are common; include a suggestion for on-screen text placement.
- Do NOT generate multiple variants unless the user explicitly asks.
## Trigger Keywords
`instagram post`, `ig post`, `instagram`, `feed post`, `instagram creative`
---
## 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.
© SamurAIGPT · MIT · SamurAIGPT/Generative-Media-Skills