Skill instructions
orshot13.6 KB
View saved version →
---
name: orshot
description: "Image, PDF and video generation from Orshot templates, through the hosted MCP server (OAuth, no API key) or the REST API. Covers connecting, finding a template and its parameter keys, render options (formats, sizes, Smart Resize, batch, async), dynamic image URLs, utility templates (tweet and website screenshots, charts, mockups), posting a render to connected social accounts, wiring it into n8n, Make, Zapier or cron, and the gotchas that break renders (parameterId keys, page1@ prefixes, public image URLs). Use when: \"render my Orshot template\", \"connect Orshot to Claude\", \"call the Orshot API\", \"my modification is ignored\", \"automate this render in n8n\", \"screenshot this tweet\". One job end to end: load its skill (orshot-blog-images, orshot-pdf-generator, orshot-video-generator, orshot-ad-creative, orshot-carousel, orshot-youtube-thumbnail, orshot-social-media-content or orshot-social-media-scheduler). NOT for template design craft (use orshot-design)."
license: MIT
metadata:
author: Orshot
version: "1.6.3"
---
# Orshot: generate images, PDFs and videos from templates through the API
Orshot is an API for automated image, PDF and video generation from templates. A template is designed once (in the Orshot studio, imported, or built by an agent), then rendered with new data on every call. The output can be posted to connected social accounts in the same request.
This skill is the flow: which tool or endpoint to call, in what order, and what to check. Parameters, allowed values, limits and response fields live in the docs. Every docs page is readable as markdown at `https://orshot.com/docs/<path>.md`; the docs map at the end lists the pages for each job.
- MCP server: `https://mcp.orshot.com/mcp`
- REST base: `https://api.orshot.com/v1`
Three things hold in every flow below:
- No API key over the hosted MCP server. It signs in with OAuth. A key is only for cron jobs, servers and n8n.
- The credit cost comes first. Say it before a bulk render.
- Nothing is posted, run or deleted without the user's yes.
## One job end to end? Load its skill
This skill is Orshot itself: connecting, rendering and the gotchas. A whole job has its own skill with the flow and worked examples:
| The job | Skill |
| --- | --- |
| Featured images and OG images for blog posts, in-article images | `orshot-blog-images` |
| Invoices, certificates, reports and other PDFs from rows of data | `orshot-pdf-generator` |
| Reels, Shorts, product and listing videos, animated charts and brand films | `orshot-video-generator` |
| Ads in every Meta, Google and LinkedIn size, A/B variants | `orshot-ad-creative` |
| TikTok, Instagram and LinkedIn carousels | `orshot-carousel` |
| YouTube thumbnails | `orshot-youtube-thumbnail` |
| On-brand social posts and stories | `orshot-social-media-content` |
| Scheduling, posting and analytics across platforms | `orshot-social-media-scheduler` |
| Designing or refining a template | `orshot-design` |
## Connect first
The hosted MCP server is the fastest route and the only one that returns inline previews and design checks. Added from an app directory (Claude, ChatGPT), the server is already connected: go straight to the account check below.
Confirm with `orshot_get_account`. It returns the plan, credits and which features the plan includes (video, workflows, embed). If it reports an inactive subscription or a used-up limit, that is a billing state, not an auth error. Send the user to https://orshot.com/pricing and stop retrying.
**Headless fallback: REST with an API key.** Use it only when the agent cannot run MCP (a cron job, a server script, n8n). Read the key from the environment.
```bash
curl -s https://api.orshot.com/v1/me -H "Authorization: Bearer $ORSHOT_API_KEY"
```
Do not go on until one of the two works.
## Core workflow
1. **Connect** (above).
2. **Find the template.** `orshot_list_studio_templates` (search by name or tags) or `GET /v1/studio/templates/all`. N
Preview of the first 4,000 characters. Read full instructions →
Referenced files: 1 — file references are metadata, not package contents.
orshot-ad-creative23.9 KB
View saved version →
---
name: orshot-ad-creative
description: "Static ad creative generator with Orshot: Facebook and Instagram ad creatives, Meta story ads, catalog ads and display banners rendered from one template with real headlines, offers, prices, logos and product photos, so every test variation is on brand and spelled right. Smart Resize makes every placement size in one call, a batch render makes hook and angle variants, catalog ads render one image per product from a sheet, a CSV or the Orshot Shopify app, plus short GIF or MP4 banners. Use when: \"static ad creatives for Meta\", \"ad variations to test\", \"our ads have creative fatigue\", \"15 ad variants from this product photo\", \"facebook ad maker\", \"catalog ads for my store\", \"banner ads in every size\", \"AI ad generator\". NOT for organic social posts (use orshot-social-media-content), carousels (use orshot-carousel), video ads with footage or voiceover (use orshot-video-generator), YouTube thumbnails (use orshot-youtube-thumbnail) or posting and scheduling (use orshot-social-media-scheduler)."
license: MIT
metadata:
author: Orshot
version: "1.2.0"
---
# Orshot Ad Creative: one template, every ad size, every variant
An ad campaign is one design repeated many times: three Meta sizes, five display sizes, four headline tests, a new price every week. Drawing each one is slow, and image models cannot be trusted with prices, logos or the word "40%". So this skill builds an ad **template** once and **renders** it with Orshot, an API for automated image, PDF and video generation from templates. The price is real text, the logo is the real logo, and the 300th ad matches the first.
Writing ad copy is your job. Rendering it into pixel-exact ads in every size is Orshot's.
The layouts come from the ad formats `orshot_plan_design` returns for the job: the formats advertisers actually run, built from 60 static ads that were live in October 2026, most of them running 30 days or longer: 40 from the Meta Ad Library (picked from the ad pages of 23 direct-to-consumer brands and about 230 SaaS, B2B and local service ads), 11 from the LinkedIn Ad Library (240 cards from 10 B2B advertisers) and 9 from the Google Ads Transparency Center (about 4,000 creatives searched). Plan before you design.
## What people ask for
- "Our Meta statics are fatiguing after a week. Make 10 new variations of our winning ad. Only the hook changes." (Refresh before the ad fatigues.)
- "Here's a product photo of the Tidewell bottle. Give me 15 static ad variations to test, feed and story sizes." (Product photo on a busy background, then Variants.)
- "I already make product scenes with an AI image model. Put our headline, price and logo on top so the text is never wrong."
- "Make catalog ads for every product in this Shopify store, with the sale price struck through when there is one." (Catalog and feed ads.)
- "I run Meta ads for six HVAC and roofing clients. Set up one ad template per client so I can push a new offer every week." (Agencies.)
- "Our recruiters at Hirebright send job details every day. Turn each one into a static job ad from our approved template in n8n."
## Where the facts live
This skill is the flow. Field shapes, allowed values and limits are in the docs. Read the page instead of guessing.
- Smart Resize over the API (`size`, `extraSizes`, preset list with sizes, response shape, limits): https://orshot.com/docs/api-reference/render-from-studio-template.md
- Smart Resize in the editor (adjust and save a size): https://orshot.com/docs/orshot-studio/smart-resize.md
- Style overrides per render (for example `opacity`): https://orshot.com/docs/orshot-studio/style-parameters.md
- Canvas background per render: https://orshot.com/docs/orshot-studio/api-specs.md
- Template JSON: `orshot_get_design_spec` topic `template-json`, or https://orshot.com/docs/definitions/template-json.md
- Credits: https://orshot.com/docs/definitions/credits-usage.md
- Shopify app: https://orshot.com/docs/integrations/sh
Preview of the first 4,000 characters. Read full instructions →
Referenced files: 1 — file references are metadata, not package contents.
orshot-blog-images19.2 KB
View saved version →
---
name: orshot-blog-images
description: "Featured image and OG image generator for blog posts with Orshot: an on-brand cover for every post (WordPress featured image, Open Graph image) plus 3 to 6 in-article images, rendered from templates with the post's real title, logos and numbers. Works with WordPress (the Orshot plugin sets the featured image on publish), Webflow, Ghost, Next.js, Astro and MDX blogs. Sets a cover on each new post through n8n, Make, Zapier or a webhook, fills old posts that have no featured image, gives each page an og:image URL, and resizes the cover for LinkedIn, X and Instagram. Use when: \"make a featured image for this post\", \"generate OG images for my blog\", \"auto-generate featured images in WordPress\", \"add featured images to my old posts\", \"OG image for every page\", \"blog cover image\", \"images for my article\". NOT for carousels (use orshot-carousel), ad creatives (use orshot-ad-creative), YouTube thumbnails (use orshot-youtube-thumbnail) or a one-off illustration or photo (use an image model)."
license: MIT
metadata:
author: Orshot
version: "1.1.2"
---
# Orshot Blog Images: featured images, OG images and in-article images for every post
Give this skill a blog post (a draft, a file or a URL). It returns a cover image and 3 to 6 images that sit inside the article, all on the user's brand, as PNG files ready to drop into the post.
Image models draw pictures; they cannot be trusted with words, numbers, logos or a layout that matches the last 40 posts. Blog images are mostly words, numbers and logos. So this skill designs **templates** once and **renders** them per post with Orshot: the text is real text, the logos are real logos, and post 41 looks like post 1.
- No API key over the hosted MCP server or the Orshot WordPress plugin. Both sign in with OAuth.
- The credit cost comes first. Say it before rendering more than 10 pages.
- Nothing goes live without a yes. Ask before publishing a post or setting a cover on a live one.
## This skill or another?
| The job | Use |
|---|---|
| Featured image, OG image or in-article images for a post or page | This skill |
| Turn the post into Instagram, LinkedIn or TikTok slides | `orshot-carousel` |
| A thumbnail for the video version of the post | `orshot-youtube-thumbnail` |
| Ads in every size from the post | `orshot-ad-creative` |
| A one-off illustration or photo | An image model |
## Example prompts
- "Make a featured image for this post: https://blog.fernleafcoffee.com/cold-brew-ratio"
- "Every time we publish on our Ghost blog, set an OG image with the post title. Build it in n8n."
- "Our WordPress site has 140 posts with no featured image. Make covers for all of them in our brand colors, and show me five before you do the rest."
- "The Tallyhop docs run on Next.js. Give every page its own OG image in the same style as the blog."
- "This post compares three payroll tools. Make the cover and an in-article image for the comparison table."
- "We changed our brand color to green. Re-render every cover and keep the file names."
## What you get per post
| Output | Size | How |
|---|---|---|
| Cover (featured image, OG image) | 1200x630 PNG | One page of the user's Blog Cover System template, rendered with the post's title |
| In-article images | 1200x960 PNG, 3 to 6 | One template per post, one page per image, built from the layouts in `references/blueprints/` |
| Social sizes of the cover (optional) | wide sizes such as `twitter-post`; a page of its own for a Pinterest pin, a square or a story | `extraSizes` for wide sizes, a designed page for tall or square ones |
| Alt text and file names | text | Written by you from the image content |
## Setup
1. Connect the Orshot MCP server at `https://mcp.orshot.com/mcp` (OAuth in the browser, no key). Setup per client: https://orshot.com/docs/integrations/mcp-server.md. Headless or scheduled jobs use REST with `ORSHOT_API_KEY` (example below). The `orshot` skill covers both.
2. Get the bra
Preview of the first 4,000 characters. Read full instructions →
Referenced files: 15 — file references are metadata, not package contents.
orshot-carousel14 KB
View saved version →
---
name: orshot-carousel
description: "TikTok slideshow and carousel generator with Orshot: faceless TikTok photo-mode slideshows, Instagram carousels and LinkedIn carousels from a template, hook on slide one and CTA on the last, brand fonts and colors set once and text sized to fit, rendered in one call. Turns a blog post, a sheet row or a list of hooks into slides, posts them as drafts through Orshot (with TikTok's recommended music) or hands them to Postiz, and learns from views. Use when: \"make a tiktok slideshow about this\", \"automate tiktok slideshows\", \"faceless tiktok carousel\", \"instagram carousel from this blog post\", \"turn this post into slides\", \"carousel generator\", \"linkedin carousel\". NOT for single posts (use orshot-social-media-content) or video reels and MP4 slideshows with a song (use orshot-video-generator)."
license: MIT
metadata:
author: Orshot
version: "1.3.0"
---
# Orshot Carousel: six slides, one call
A carousel is six images with the same layout and different words. That is a template render, not an image-editing job. The template holds the fonts, colors and text sizing once. Every post only sends six lines of copy and six background images. No canvas code, no font files.
## What people ask for
- "Make a faceless TikTok slideshow for our habit app Loopday: 6 slides, a hook on the first, the app only on the last."
- "Turn this blog post into an Instagram carousel."
- "Write 30 slideshow hooks for a plant-care account and render the first 10 as drafts."
- "'Layout 1 or layout 2?' Make that slideshow with photos from our brand kit."
- "Which hooks got the most views this week? Write the next five from the winners."
- "Take the photos in my Drive folder and make a slideshow video with our track." This one is a video: see Slideshow as a video.
## Setup
1. Connect the Orshot MCP server at `https://mcp.orshot.com/mcp` (OAuth, no key): https://orshot.com/docs/integrations/mcp-server.md. Headless jobs use `ORSHOT_API_KEY` over REST. The `orshot` skill covers both.
2. Find a carousel template: `orshot_list_studio_templates` with a search for "carousel". None? Create one (below). Already have it in Canva? The user imports it in Orshot Studio from a public share link, and each page comes in with `pageN@` keys: https://orshot.com/docs/importing-templates/import-from-canva.md.
3. Do not look up social accounts yet. Where it posts (Orshot social accounts or Postiz) is decided after the slides are rendered: see Post it.
## Music
- **TikTok:** `tiktokSettings: { autoAddMusic: true }` asks TikTok to add its recommended music to the photo post, so no one has to open the app to add a sound. Over MCP it goes on `orshot_publish_social_post` (see Post it). Field: https://orshot.com/docs/publish/publish-from-api.md.
- **Instagram:** Orshot has no music option for Instagram posts. Tell the user before you post instead of trying. If the post needs sound, make it a video (see Slideshow as a video).
## The 6-slide formula
```
Slide 1 Hook, full sentence, biggest text, never split across slides
Slide 2 The problem the viewer has
Slide 3 The discovery or the turn
Slide 4 Proof 1 (number, screenshot, quote)
Slide 5 Proof 2 or the how
Slide 6 CTA (follow, link in bio, app name)
```
Hook rule: person + doubt or conflict + specific detail beats a feature line. "my trainer asked me to log a week of meals, she wasn't ready" beats "track calories in seconds". Do not name the product on slide 1.
Six is the default. A list gets one slide per point plus the cover and the CTA (5 mistakes is 7 slides), and a data update gets one number per slide. Two other formulas that keep working, each as its own template with its own page count:
- Question hook, 3 to 5 tips, CTA (5 to 7 slides).
- This or that: two options, and the viewer picks ("layout 1 or layout 2?").
## Create the template once
1. Load the `orshot-design` skill for type, color and layout rules. `orshot_plan_design` with the brief, `job` ("tiktokPreview of the first 4,000 characters. Read full instructions →
orshot-design9.61 KB
View saved version →
---
name: orshot-design
description: "Design craft for Orshot studio templates: one focal point, a 2-font type system, 60-30-10 color, copy that still fits when the data changes, restrained motion, the brand kit when the design should be on-brand, layouts that do not repeat, and a create-then-critique loop over the hosted Orshot MCP server. The shared craft base that every Orshot use-case skill loads when it creates or refines a template (posts, stories, carousels, ads, banners, thumbnails, video). Use when: \"design a template for this\", \"make this template look less generic\", \"refine this design\", \"build an on-brand post template\", \"why does this look AI-made\". NOT for rendering, batches or posting (use orshot) or for a whole job end to end (use its use-case skill, for example orshot-blog-images or orshot-ad-creative)."
license: MIT
metadata:
author: Orshot
version: "1.3.1"
mcp-server: orshot
---
# Orshot Design: the craft layer
Make Orshot studio templates that look designed, not like the generic centered-text "AI" look. This skill is judgement: layout, hierarchy, type, color, copy fit and motion taste. It works on top of the MCP design tools (`orshot_create_template_design`, `orshot_update_template_design`, `orshot_patch_template_elements`, `orshot_get_brand_kit`). Use the `orshot` skill to render.
## Where the facts live
This skill does not restate field names, style keys, value types, units, animation schema, audio fields, canvas sizes or the craft systems. Read them from the source, through one MCP tool, `orshot_get_design_spec`, by topic:
- `template-json`: pages, elements, styles, text rules, shapes, SVG, animation, audio, subtitles. Also https://orshot.com/docs/definitions/template-json.md.
- `craft`: the systems every template follows (hierarchy, two fonts, text fit and its floors, 60-30-10 colour, composition, imagery), the brand mapping, the compatibility rules that break renders, the anti-patterns.
- `social-pack`: posts, stories and carousels: formats and safe areas, drawn graphics, a concrete element tree.
- `layout`: computed layouts (rows, stacks, grids, anchors instead of hand-set x/y).
- `video-pack`, `film`, `film-pack`: motion and video. Also https://orshot.com/docs/definitions/film.md, https://orshot.com/docs/orshot-studio/animations.md, https://orshot.com/docs/orshot-studio/motion.md, https://orshot.com/docs/video-generation/video-options.md, https://orshot.com/docs/video-generation/adding-subtitles.md.
- `formats-catalogue`, `post-formats`, `ad-formats`, `video-post-formats`, `youtube-thumbnail-layouts`: the formats real brands run, to browse; `orshot_plan_design` returns the ones that fit a job.
- Text fit modes: https://orshot.com/docs/orshot-studio/text-modes.md.
## Operating principle
**Design serves the task.** Decide the one thing the viewer must take away, then make everything support it. Respect the brand and the platform over generic prettiness.
## Workflow (in order)
1. **Shape.** Restate the goal, the audience and the single key message before placing anything.
2. **Plan.** `orshot_plan_design` with the brief, `job` (what the user is making, in their words), the canvas size and `on_brand: true` when the design should be on-brand. It returns the formats real brands run for that job (skeleton, size, fields, what makes each work) and the plan: palette, font pair, type scale, material. Pick the format whose fields match what changes per render and name it. With no matching format (a document, an unusual job) the plan carries a slot layout and a ready skeleton: build that.
3. **Gather, in parallel.** `orshot_get_design_spec` topic `template-json` once per session, plus the pack for the medium (`social-pack`; `video-pack` and `film` for anything that moves). If the design should be on-brand, `orshot_get_brand_kit` (filter with its per-type tag arguments, such as `imageTags: "logo"`, only when the kit is tagged); its colours and fonts win over the plan's.
4. **Build the comp
Preview of the first 4,000 characters. Read full instructions →
orshot-pdf-generator18.7 KB
View saved version →
---
name: orshot-pdf-generator
description: "Invoice and certificate PDF generator with the Orshot API: design an invoice, receipt, quote, certificate, report, proposal, ticket or offer letter once, then render one designed PDF per row or event from Google Sheets, Airtable, Notion, HubSpot, Stripe or a webhook, through n8n, Make, Zapier, REST or an Orshot Workflow, and pass the PDF URL to Gmail, Google Drive or the CRM. Selectable text, line items, page numbers on long documents and clickable pay links. Use when: \"generate invoice PDFs automatically\", \"make certificates for this list of names\", \"bulk certificates from a spreadsheet\", \"turn each row into a PDF\", \"send a PDF receipt when someone pays\", \"PDF from a template via API\". NOT for pulling data out of invoices or PDFs (use an OCR or parsing tool), editing, merging or filling a PDF you already have, or a one-off document (use a local pdf or docx skill). Blog images, ads and social posts: orshot-blog-images, orshot-ad-creative, orshot-social-media-content."
license: MIT
metadata:
author: Orshot
version: "1.1.1"
---
# Orshot PDF Generator: invoices, certificates and documents from a template and data
Give this skill a document type and a source of rows: a sheet, a CRM or a payment webhook. It returns one designed PDF per row, as a URL ready for email, Drive or the CRM.
Orshot is an API for automated image, PDF and video generation from templates. The invoice, certificate or report is designed once. The layout, fonts and logo live in the template. Each render sends only the values that change.
- No API key over the hosted MCP server. It signs in with OAuth. Only recurring jobs need a key, kept in the environment.
- The credit cost comes first. Say it before rendering more than 10 pages.
- Nothing is emailed without a yes. Orshot makes the PDF; the user's email step sends it, after they confirm the recipients.
The Orshot docs are the reference for every parameter, value and limit. Each docs page has a markdown version at `https://orshot.com/docs/<path>.md`. This skill gives the order of steps and worked examples, and links the page to read at each step.
## This skill or a local PDF tool?
| The job | Use |
|---|---|
| Edit, merge, split, fill or read a PDF file you already have | A local PDF or DOCX tool |
| Pull data out of invoices or other PDFs (OCR) | An OCR or PDF parsing tool |
| One-off document you will never make again | A local PDF or DOCX tool |
| Same designed layout, new data each time, often from a sheet, CRM or app | This skill |
| Must run without you: every new order, signup, deal or course completion | This skill |
Pick this skill when the document is designed, repeats, and is filled from data. The output is a PDF URL, so it drops straight into an email step, a CRM field or storage.
## Example prompts
- "Make certificates for everyone in this sheet who finished Data Basics at Brightpath Academy. Name each file after the student."
- "When a Stripe invoice is paid, render our invoice PDF and put the link on the customer's Airtable record."
- "Every row in the Orders sheet with status READY should become a PDF invoice and a Gmail draft to the client. Mark the row SENT after."
- "Design a quote for Halden Joinery with line items, a total and a Pay now link, then show me one filled with test data."
- "Our certificate is designed in Canva. Bring it in and make 180 certificates from this CSV."
- "A monthly report PDF for each client in this Airtable view, with page numbers in the footer."
## Setup
1. Connect the Orshot MCP server: https://orshot.com/docs/integrations/mcp-server.md has the steps for each client.
2. Confirm with `orshot_get_account`. A billing or plan message is not an auth error. Send the user to https://orshot.com/pricing and stop retrying.
3. Recurring jobs (cron, n8n, Make, Zapier, your server) use REST with an API key: https://orshot.com/docs/quick-start/get-api-key.md. Keep the key in an environment variable.
## Doc
Preview of the first 4,000 characters. Read full instructions →
orshot-social-media-content15.7 KB
View saved version →
---
name: orshot-social-media-content
description: "Social media post generator with Orshot: on-brand Instagram, LinkedIn, Facebook, X, Pinterest and TikTok posts and stories (events, launches, hiring, stats, quotes, menus, listings, deals, match scores) from a template you design once, then render with new copy for every post. Built on formats brands post every week. A Canva alternative agents drive by API: brand kit fonts, colors and logo, rotating layouts so posts don't all look the same, every platform size from one design. Imports existing Canva designs. Runs over the Orshot MCP server or REST, from a chat or a sheet. Use when: \"make an instagram post for this\", \"social media post generator\", \"turn this sheet into posts\", \"on-brand posts for this week\", \"announcement post\", \"quote post\", \"linkedin post image\". NOT for carousels or TikTok slideshows (use orshot-carousel), ads (use orshot-ad-creative), blog covers (use orshot-blog-images), thumbnails (use orshot-youtube-thumbnail) or posting and scheduling (use orshot-social-media-scheduler)."
license: MIT
metadata:
author: Orshot
version: "1.6.0"
mcp-server: orshot
---
# Orshot Social Media Content: design the template once, post from it forever
A social post from Orshot is a designed template plus fresh copy, not a new AI image every time. This skill is the flow for making one post template that a brand can run every week, and rendering it for every post after that.
The layouts come from the post formats `orshot_plan_design` returns for the job, built from 93 real posts brands published in 2026: the formats brands, clubs, shops and studios actually publish again and again (place-and-date event cards, changelog cards, one big number, split speaker cards, edge rails on match day, row tables for menus). Read it before you design. Design craft (hierarchy, type, color) is in the `orshot-design` skill. Field names and rules live in the docs.
## What people ask for
- "Make an Instagram post for the Fernhill Farm Market on Saturday: date, time, entry price and address, in our brand colors."
- "Here's a post that did well last month. Make five more for next week with the same layout and new copy."
- "Every Monday I'll paste five quotes. Turn them into posts that don't all look the same."
- "Build a final-score graphic for the Riverside Otters so I can drop in the score after each game."
- "We post a feature update every Friday. Make the card so I only change the headline and the screenshot."
- "Turn each row of this sheet into a LinkedIn image and a story version."
- "I'll send this week's six specials from a sheet. Make the menu post."
- "Our posts look like generic AI. Redo the template so it looks like us."
## Before you start
- Connect the Orshot MCP server at `https://mcp.orshot.com/mcp` (OAuth, no key). Setup per client: https://orshot.com/docs/integrations/mcp-server.md. The `orshot` skill covers connection and REST.
- Load the `orshot-design` skill. It holds the design rules this flow relies on.
- Template design runs over MCP. The REST create endpoint is Enterprise only: https://orshot.com/docs/api-reference/enterprise-template-create.md.
## Flow
1. **Look for an existing template.** `orshot_list_studio_templates` with a search for the post type. If one fits, skip to step 8.
**Already designed in Canva?** Do not rebuild it. The user imports it in Orshot Studio from a public share link, so no Canva API access is needed: https://orshot.com/docs/importing-templates/import-from-canva.md. Text and image layers come in as parameters. After the import, go to step 7 and rename the keys that change per post.
2. **Pick the size.** 4:5 portrait is the default for Instagram and LinkedIn feed posts; 16:9 for X announcements; 9:16 for stories. One image for both LinkedIn and X: 1:1. When the format and this line disagree, this line wins. Create takes `canvas_width` and `canvas_height` in pixels. Preset names and sizes: https://orshot.com/docs/api-referen
Preview of the first 4,000 characters. Read full instructions →
orshot-social-media-scheduler15 KB
View saved version →
---
name: orshot-social-media-scheduler
description: "Social media scheduler and auto-poster with Orshot: schedule posts or auto-post to Instagram, TikTok, LinkedIn, X, Facebook, YouTube, Pinterest, Threads, Bluesky, Reddit, Telegram, Snapchat and Google Business, with the image, carousel or video rendered from a template in the same call, so the queue never runs empty. Plans a week of posts as drafts you approve once, cross-posts, schedules at the best time and reads post analytics, from Claude, Codex or any MCP client over the hosted Orshot MCP server (OAuth, no key), or REST for n8n, Make and cron jobs. Use when: \"schedule this week's posts\", \"auto-post to instagram and tiktok\", \"schedule posts from claude\", \"cross-post to every platform\", \"let me approve before it posts\", \"social media scheduler\", \"best time to post\". NOT for designing the image or video itself (use orshot-social-media-content, orshot-carousel or orshot-video-generator)."
license: MIT
metadata:
author: Orshot
version: "1.3.2"
---
# Orshot Social Media Scheduler: render, post, schedule, learn
Orshot renders an image, carousel or video from a template and posts it to the user's connected accounts in the same request. It also holds drafts, schedules, edits and reports analytics, so an agent can run a content calendar without a second tool. It can post any public media URL too, so it works with images made elsewhere.
Most schedulers hold posts someone already made, so the queue runs empty on the days nobody made one. Here the post is rendered and scheduled in the same call: one template and a list of topics become a week of posts.
Supported platforms, pricing and per-platform limits are in the docs. Do not guess them:
- Platforms and how publishing works: https://orshot.com/docs/publish/introduction.md
- Pricing (paid add-on per connected account): https://orshot.com/docs/publish/pricing.md
- Caption, image and video limits per platform: https://orshot.com/docs/publish/social-posting-guidelines.md
## What people ask for
- "Schedule this week's posts for Bloomfield Bakery on Instagram and Facebook, one a day around lunch. Show me them before anything goes out."
- "Codex made five images for our launch. Post them to LinkedIn and X tomorrow at 9, with the link in the first comment on LinkedIn."
- "Auto-post a new quote card to TikTok every morning from my Google Sheet."
- "Cross-post this announcement to every account we have connected."
- "Which posts did best last month, and when should I post next week?"
- "The Instagram post didn't go out. What happened?"
## Step 1: connect
Connect the Orshot MCP server at `https://mcp.orshot.com/mcp` (OAuth, no key). Setup per client: https://orshot.com/docs/integrations/mcp-server.md. Headless jobs (cron, n8n, a server script) call REST with `ORSHOT_API_KEY`. The `orshot` skill covers both.
## Step 2: check the accounts
`orshot_list_social_accounts` (REST: https://orshot.com/docs/api-reference/social-accounts-list.md). Note each account's numeric `id`. You publish by id, never by platform name.
- Check that the accounts belong to the brand the user named. If the only connected accounts are someone's personal profile or another brand, say so before you draft anything.
- If a brand has two accounts on one platform (two Facebook Pages, say), ask which one. Do not guess.
- Accounts belong to the active workspace. If the user keeps each brand or client in its own workspace, switch with `orshot_set_active_workspace` before you list accounts.
Over REST, `include_health=true` adds a `requires_reconnect` flag per account. If it is `true`, the user must reconnect that account before you post to it. Check it before you schedule a batch, not after a post fails.
**An empty list means a human has to connect accounts.** The API cannot do it. A draft or scheduled post can still be saved now with `platforms` instead of `accounts` (any plan); once an account on that platform is connected, add it with `orshot_u
Preview of the first 4,000 characters. Read full instructions →
orshot-video-generator29.4 KB
View saved version →
---
name: orshot-video-generator
description: "Faceless video and YouTube Shorts maker with Orshot: product and promo reels, real estate listing reels, tips and listicle reels, launch teasers, animated chart and stat explainers, testimonial and brand films, rendered to one MP4 from a film template (scenes, transitions, motion, drawn SVG charts and icons that animate part by part, stock footage, music), by hand or on a schedule from n8n, Make, Zapier or cron. Also voiceover shorts and talking-head clips with word-by-word captions. Use when: \"automate my faceless YouTube channel\", \"make a reel for this product\", \"turn this listing into a reel\", \"animate this chart\", \"make a launch video for my app\", \"make a 15 second video ad\", \"n8n video automation\". Pairs with orshot-social-media-content, orshot-carousel and orshot-ad-creative for video versions of their work. NOT for photo carousels posted as slides (use orshot-carousel), YouTube thumbnails (use orshot-youtube-thumbnail), static ads or 3 to 6 second animated banners (use orshot-ad-creative)."
license: MIT
metadata:
author: Orshot
version: "1.2.0"
---
# Orshot Video Generator: reels, Shorts and explainer films from one template
A reel, a Short or a TikTok is the same video every time with new words, new pictures and new numbers. That is a template render. An Orshot video template holds the scenes, the cuts between them, the fonts, the motion and the music. Each new video sends only its own text and media and gets one MP4 back.
Most videos are **films**: one template whose pages are scenes, played end to end with a transition into each scene, rendered as one MP4. Inside a scene, layers enter, move on keyframes, count up and reveal word by word, and a drawn SVG (a chart, an icon, a mascot, a logo) animates part by part: lines draw themselves, bars fill, a pin drops. This is how a chart from a post or a product launch becomes a video that looks edited, not generated.
The formats, pacing and motion rules come from 83 real videos: 46 brand videos timed frame by frame and 37 Reels compared by views on the same accounts. `orshot_plan_design` returns the video post format for the job.
This is not a model that invents footage. You write the script and draw or pick the pictures: drawn SVG, stock clips and photos, or the user's own media. The template stays editable in Orshot Studio, so someone who does not code can change a line, a clip or a color later.
## Works in a pair
This skill is the motion layer. When the video is a version of something another skill makes, load that skill too and let each do its half:
| The video | Load with this skill | That skill decides | This skill adds |
|---|---|---|---|
| A post as a video: event, launch, match day, stat, speaker, listing, menu, quote | `orshot-social-media-content` | the format, the copy, the fields, the palette and fonts, the static post | the scenes that build to the post, motion, cuts, pacing, the ground and the layer that runs start to end (the video post format `orshot_plan_design` returns) |
| A carousel as a video: a slideshow with a song, a listicle or tips reel | `orshot-carousel` | the hook slide, the slides, the CTA slide | one scene per slide, a segmented progress rail, one cut family (same file, "Carousel as a video") |
| A video ad over 6 s, or with footage or more than one scene | `orshot-ad-creative` | the offer, the hook, the product photo, the sizes, the CTA | the scenes, the motion and the end card (same file, "Video ad") |
| Posting it | `orshot-social-media-scheduler`, after the render | accounts, captions, times | |
How a pair runs:
1. The paired skill makes the static version first, or finds the brand's existing image template. That static design is the film's last scene and its cover frame: same palette, same fonts, same field names.
2. This skill writes the beat sheet that builds to it, lays every scene out natively for the video's frame (a 4:5 post is re-laid for 9:16, never pasted),
Preview of the first 4,000 characters. Read full instructions →
Referenced files: 3 — file references are metadata, not package contents.
orshot-youtube-thumbnail16.4 KB
View saved version →
---
name: orshot-youtube-thumbnail
description: "YouTube thumbnail maker with Orshot: thumbnails built from a frame of the video, the host's face cutout and the hook words, rendered from one template per channel style so every video in a series matches. No generated faces or scenes, and the words are real text, sharp and spelled right. 2 to 3 A/B variants for YouTube Test & Compare render in one batch, a back catalogue gets new thumbnails from a sheet, and an n8n, Make or Zapier job renders one for every new upload. Use when: \"make a YouTube thumbnail\", \"youtube thumbnail maker\", \"thumbnail template for my channel\", \"match my thumbnail style\", \"A/B test my thumbnails\", \"automate a thumbnail for every upload\", \"redo thumbnails on my old videos\", \"AI thumbnail maker\". NOT for the video itself (use orshot-video-generator), blog covers (use orshot-blog-images), ad creatives (use orshot-ad-creative) or social posts (use orshot-social-media-content)."
license: MIT
metadata:
author: Orshot
version: "1.1.1"
---
# Orshot YouTube Thumbnail: one template per channel, one render per video
A channel's thumbnails share a look: the same font, the same color box, the face in the same place. Only the words and the picture change. That is a template render. Design the channel's thumbnail template once in Orshot, then render it per video with the hook words, the subject image and the accent color. Video 40 looks like video 1, and the text is real text, so it is sharp and spelled right.
## What people ask for
- "Make a thumbnail for my new video: a frame at 1:23, my face cutout, and the words 'I QUIT MY JOB'. Same style as my last ones."
- "Here are my last 6 thumbnails. Turn the style into a template so I only swap the face and the words each week." (Match the current style first.)
- "Give me 3 variants for Test & Compare: same picture, different words." (A/B variants.)
- "Every time I upload, make the thumbnail from the title and set it on the video automatically. I use n8n." (A thumbnail for every new video.)
- "Redo the thumbnails for my 40 old tutorials from this sheet of titles and timestamps." (Redo thumbnails on old videos.)
- "No AI art. A gameplay screenshot of my Glasswing Rogue build and the build name, big and readable." (Screenshot + name layout.)
The Orshot docs are the reference for every parameter, value and limit. Each docs page has a markdown version at `https://orshot.com/docs/<path>.md`. This skill gives the order of steps, the thumbnail craft and worked examples.
## What you get per video
| Output | How |
|---|---|
| Thumbnail, 1280x720 JPG or PNG | One render of the channel's thumbnail template |
| A/B variants (optional), 2 to 3 thumbnails | One `orshot_batch_render_template` call, one item per variant |
| Shorts cover (optional), 9:16 | A second 1080x1920 page in the same template, with the same field names |
## Setup
1. Connect the Orshot MCP server: https://orshot.com/docs/integrations/mcp-server.md has the steps for each client. Headless or scheduled jobs use REST with an API key: https://orshot.com/docs/quick-start/get-api-key.md
2. Get the brand: `orshot_get_brand_kit` (colors, fonts, logo, and any photos of the host). Empty kit and a website? `orshot_scan_brand_website` with the URL, and ask before importing with `orshot_import_brand_website`. No brand at all? Load the orshot-design skill to pick a palette and a font pair.
3. `orshot_plan_design` with the brief, `job: "youtube thumbnail for <the video>"`, 1280x720 and `on_brand: true` when the channel has a brand kit. It returns the layouts that fit (geometry and a full `pages_data` example each) and the palette and type. Read `orshot_get_design_spec` topic `template-json` once per session; the same content is at https://orshot.com/docs/definitions/template-json.md
## Thumbnail rules
- **Real over generated.** Use the video's own frames and the host's real photos. Many viewers say they skip or block channels whose thumbnails look AI-ma
Preview of the first 4,000 characters. Read full instructions →