OverviewHistoryStatsSecurity
npx skills add ...
Documentation
SKILL.md
npx skills add terminalskills/skills --skill instagram-marketing
Create, optimize, and automate Instagram content including Reels, Stories, carousels, and feed posts. Use when someone asks to "grow on Instagram", "create Instagram Reels", "Instagram content strategy", "Instagram API integration", "automate Instagram posting", "Instagram analytics", or "Instagram marketing". Covers Reels-first strategy, visual content guidelines, Instagram Graph API, and growth tactics.
npx skills add terminalskills/skills --skill instagram-marketing
This skill helps AI agents create high-performing Instagram content and integrate with the Instagram Graph API. It covers content formats (Reels, Stories, carousels, feed posts), visual guidelines, caption writing, hashtag strategy, API publishing, analytics, and growth strategies for Instagram's visual-first, Reels-dominated algorithm.
Instagram algorithm (2025-2026):
What kills reach:
Reel types that work:
Carousel types:
Caption rules:
Posting schedule: 1 Reel/day + 2-3 carousels/week + daily Stories
Content mix:
Hashtag strategy:
User prompt: "I'm a personal trainer in Austin, TX with 1,200 followers. Plan a 2-week Instagram content strategy to grow my audience and book more coaching clients."
The agent will create a 14-day content calendar mixing Reels, carousels, and Stories. Week 1: Monday — Reel "3 exercises you're doing wrong at the gym" (trending audio, 30s, text overlays showing correct form), Wednesday — carousel "Meal prep guide: 5 high-protein lunches under $8" (10 slides, 4:5 ratio, swipe cue on slide 1), Friday — Reel "Client transformation: Sarah lost 22 lbs in 12 weeks" (before/after with voiceover). Week 2 follows the same pattern with fresh topics. Each day includes 3-5 Stories (morning workout clip, midday poll "What should I post next?", afternoon carousel teaser). Captions include keyword-rich hooks like "Stop wasting time on crunches for abs" with CTAs like "Save this for your next gym session." Hashtags: 5 niche (#AustinFitness #PersonalTrainerAustin), 5 medium (#FitnessTips #GymMotivation), 3 broad (#Fitness #Workout).
User prompt: "Write a Node.js script to publish a 5-image carousel to my Instagram business account using the Graph API. The images are hosted on my CDN at cdn.brightbody.co/posts/."
The agent will create a Node.js script that uses the Instagram Graph API with a long-lived Facebook access token. It loops through 5 image URLs (e.g., https://cdn.brightbody.co/posts/slide-1.jpg through slide-5.jpg), creates individual media containers via POST /{ig-account-id}/media with is_carousel_item: true, collects the returned container IDs, then creates the carousel container with media_type: CAROUSEL, the children array, and a caption including hashtags. Finally it publishes via POST /{ig-account-id}/media_publish with the carousel container ID. The script includes error handling for each API call and a 3-second delay between container creation requests to avoid rate limits.
// Instagram Graph API uses Facebook's OAuth
// Requires: Facebook Page + Instagram Professional account linked
// Step 1: Get Facebook User Access Token via Facebook Login
const FB_AUTH_URL = 'https://www.facebook.com/v19.0/dialog/oauth';
const params = new URLSearchParams({
client_id: process.env.FB_APP_ID,
redirect_uri: process.env.REDIRECT_URI,
scope: 'instagram_basic,instagram_content_publish,instagram_manage_insights,pages_show_list,pages_read_engagement',
response_type: 'code',
});
// Redirect to: FB_AUTH_URL + '?' + params
// Step 2: Exchange code for token
const tokenRes = await fetch(`https://graph.facebook.com/v19.0/oauth/access_token?client_id=${FB_APP_ID}&client_secret=${FB_APP_SECRET}&redirect_uri=${REDIRECT_URI}&code=${code}`);
const { access_token } = await tokenRes.json();
// Step 3: Get long-lived token (60 days)
const longLivedRes = await fetch(`https://graph.facebook.com/v19.0/oauth/access_token?grant_type=fb_exchange_token&client_id=${FB_APP_ID}&client_secret=${FB_APP_SECRET}&fb_exchange_token=${access_token}`);
const { access_token: longLivedToken } = await longLivedRes.json();
// Step 4: Get Instagram Business Account ID
const pagesRes = await fetch(`https://graph.facebook.com/v19.0/me/accounts?access_token=${longLivedToken}`);
const { data: pages } = await pagesRes.json();
const pageId = pages[0].id;
const igRes = await fetch(`https://graph.facebook.com/v19.0/${pageId}?fields=instagram_business_account&access_token=${longLivedToken}`);
const { instagram_business_account: { id: igAccountId } } = await igRes.json();// Publish single image
// Step 1: Create media container
const containerRes = await fetch(`https://graph.facebook.com/v19.0/${igAccountId}/media`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
image_url: 'https://example.com/image.jpg', // Must be public URL
caption: 'Your caption here\n\n#hashtag1 #hashtag2',
access_token: longLivedToken,
}),
});
const { id: containerId } = await containerRes.json();
// Step 2: Publish
await fetch(`https://graph.facebook.com/v19.0/${igAccountId}/media_publish`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
creation_id: containerId,
access_token: longLivedToken,
}),
});
// Publish carousel
const mediaIds = [];
for (const imageUrl of imageUrls) {
const res = await fetch(`https://graph.facebook.com/v19.0/${igAccountId}/media`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
image_url: imageUrl,
is_carousel_item: true,
access_token: longLivedToken,
}),
});
const { id } = await res.json();
mediaIds.push(id);
}
const carouselRes = await fetch(`https://graph.facebook.com/v19.0/${igAccountId}/media`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
media_type: 'CAROUSEL',
children: mediaIds,
caption: 'Carousel caption...',
access_token: longLivedToken,
}),
});
const { id: carouselId } = await carouselRes.json();
await fetch(`https://graph.facebook.com/v19.0/${igAccountId}/media_publish`, {
method: 'POST',
body: JSON.stringify({ creation_id: carouselId, access_token: longLivedToken }),
});
// Publish Reel
const reelContainer = await fetch(`https://graph.facebook.com/v19.0/${igAccountId}/media`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
media_type: 'REELS',
video_url: 'https://example.com/reel.mp4', // Public URL, mp4, H.264
caption: 'Reel caption...',
share_to_feed: true,
cover_url: 'https://example.com/cover.jpg', // Optional custom cover
access_token: longLivedToken,
}),
});// Account insights
const insightsRes = await fetch(
`https://graph.facebook.com/v19.0/${igAccountId}/insights?metric=impressions,reach,profile_views,follower_count&period=day&since=${startDate}&until=${endDate}&access_token=${longLivedToken}`
);
// Media insights
const mediaInsightsRes = await fetch(
`https://graph.facebook.com/v19.0/${mediaId}/insights?metric=impressions,reach,engagement,saved,shares&access_token=${longLivedToken}`
);
// Reel insights
const reelInsightsRes = await fetch(
`https://graph.facebook.com/v19.0/${reelId}/insights?metric=plays,reach,likes,comments,shares,saved,total_interactions&access_token=${longLivedToken}`
);