Documents
thirds-reuse-template
Fill a saved thirds.ai template with new data and make a branded PDF, PNG, JPEG, or WebP through MCP.
thirdsai · Static checks on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add thirdsai/skills --skill thirds-reuse-templateAbout this skill
name: thirds-reuse-template description: Fill a saved thirds.ai template with new data and make a branded PDF, PNG, JPEG, or WebP through MCP.
Make a new file from a saved template
Use this skill when the user already has a design and wants another file from it. Connect the thirds.ai MCP server first. If it is absent, use that guide to connect it with a private API key. Keep the key and signed download links out of shared chats and source code.
- Get the saved template ID. If it is missing, call
list_templateswithqortag, then let the user choose if several designs match. The list gives IDs, names, and versions. It does not give the template's source or data fields. - Gather the values the design needs. Ask for a missing client name, date, price, or other field. Do not guess a real person's details. Use
versionwhen the user needs an exact saved design. If you omit it, thirds.ai pins the latest version when it accepts the render. - Show the output format and cost before the paid call. One successful file costs one credit. Call
renderwithoutputset topdf,png,jpeg, orwebp; a newidempotency_key; andrequest.template_idplusrequest.data. For an image, setrequest.image.widthandrequest.image.heightas the live tool schema requires.viewportis for PDF only. - Keep the returned render ID. Poll
get_statusunder a time deadline while the job is queued or running. Stop when it succeeds, fails, or is cancelled. ReadisErrorand stable error codes. If the first response is lost, retry the same call with the same key and exact arguments. - On success, give the user the file or private download link. Download before
download.expires_at. If it expires, callget_statusfor a fresh link. Check the finished file before you call the task done.
For many rows from one design, use the batch-files skill. The MCP guide has a full render request and status example.