Run any Skill in Manus with one click

known-errors

Stars0

Forks0

UpdatedJuly 16, 2026 at 07:20

Use when a Creatify tool call fails or returns an error — auth/access problems, wrong brand space, quota/plan gating, not-found ids, long-running jobs, or missing source media. Covers how to recover for each without blind retries or repo debugging.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

creatify-ai

creatify-ai/Creatify-agent-plugin

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

name	known-errors
description	Use when a Creatify tool call fails or returns an error — auth/access problems, wrong brand space, quota/plan gating, not-found ids, long-running jobs, or missing source media. Covers how to recover for each without blind retries or repo debugging.

Known Errors & Recovery

When a Creatify tool call errors, match it to one of these and recover accordingly. Do not blindly retry, and do not start debugging the repo or local services — these are access/state/quota conditions, not code bugs.

Auth / access

Symptom: unauthorized, or a tool says it needs authentication.
Recover: run codex mcp login creatify and retry. Confirm the account is the one that owns the target brand/product.

Wrong brand space

Symptom: a product/brand/folder "not found" even though the user says it exists.
Recover: the data likely lives in another brand space. brand_list, then brand_switch to the right one, and retry with the correct id. See product-and-brand.

Quota / plan gating

Symptom: voice-slot full or a creation-time cap (voice cloning); a model rejected by plan_level (asset generation).
Recover: surface the limit to the user (they may need to free a slot or upgrade) instead of retrying. Offer a lower-tier model when one fits.

Not-found / bad id

Symptom: an id-scoped call fails.
Recover: use ids returned by list/get tools (avatar_list, voice_list, product_list, asset_list_models, session results); never guess ids.

Long-running / "still processing"

Symptom: a *_get poll isn't done yet.
Recover: keep polling the matching status tool; a not-yet-done state is not a failure. Only conclude failure on a terminal failed state. See verification.

Missing source media

Symptom: a workflow needs a photo/video/audio the agent doesn't have.
Recover: check whether it already exists (e.g. in the brand/product or project) before asking. If genuinely missing, get it in via media-upload or ask the user to provide it. If a host policy blocks the upload, tell the user to upload directly in the Creatify web app.

More from this repository

same repository

creatify-basics

creatify-ai/Creatify-agent-plugin

Use for AI video/avatar/voice/asset creation work that should run in Creatify, even when the user does not explicitly mention Creatify. Covers AI avatar videos, voice cloning and voiceover, image/video asset generation, the Creatify creative agent for ad creatives, product/brand setup, media upload, long-running generation polling, and identifying the resulting asset/preview URL.

2026-07-200

asset-generation

creatify-ai/Creatify-agent-plugin

Use to generate images or videos with Creatify's model catalog (~90 image/video models: Veo, Kling, Seedance, Nano Banana, Flux, GPT-image, etc.). Covers model discovery (asset_list_models, asset_get_model_schema), asset_generate, asset_get, and picking the right model and task variant (text-to-video, image-to-video, reference-to-video, edit).

2026-07-160

avatar-create

creatify-ai/Creatify-agent-plugin

Use to build a reusable custom avatar identity in Creatify from the user's own media — a talking video (bring-your-own-avatar, needs a consent clip), a single face photo, or a text description. Covers avatar_create_video / avatar_create_image / avatar_create_text, avatar_choose_photo, avatar_create_get, and the upload widget. This makes an avatar IDENTITY, not a talking video.

2026-07-160

avatar-video

creatify-ai/Creatify-agent-plugin

Use to generate a talking-avatar video in Creatify (Aurora) — make an avatar or a face image speak a script, optionally with a cloned or catalog voice. Covers aurora_generate, aurora_get, choosing an avatar and voice, and script/format alignment. Use this for 'make an avatar say X' / 'talking head from this photo + script'.

2026-07-160

creative-agent

creatify-ai/Creatify-agent-plugin

Use for a full brief-to-ad creative flow in Creatify — hand a creative brief to the Creatify creative agent and let it plan and produce a multi-scene ad, rather than assembling assets tool-by-tool. Covers creative_create_session, creative_send_turn, creative_get_session, creative_stop_turn, and the turn/polling model.

2026-07-160

media-upload

creatify-ai/Creatify-agent-plugin

Use to get local or attached media into Creatify so it can be used by generation and creative tools. Covers upload_file and when the widget upload path applies. Use before referencing a user's own image/video/audio in avatar, aurora, asset, or voice-clone workflows.

2026-07-160

name	known-errors
description	Use when a Creatify tool call fails or returns an error — auth/access problems, wrong brand space, quota/plan gating, not-found ids, long-running jobs, or missing source media. Covers how to recover for each without blind retries or repo debugging.

Known Errors & Recovery

Auth / access

Symptom: unauthorized, or a tool says it needs authentication.
Recover: run codex mcp login creatify and retry. Confirm the account is the one that owns the target brand/product.

Wrong brand space

Symptom: a product/brand/folder "not found" even though the user says it exists.
Recover: the data likely lives in another brand space. brand_list, then brand_switch to the right one, and retry with the correct id. See product-and-brand.

Quota / plan gating

Symptom: voice-slot full or a creation-time cap (voice cloning); a model rejected by plan_level (asset generation).
Recover: surface the limit to the user (they may need to free a slot or upgrade) instead of retrying. Offer a lower-tier model when one fits.

Not-found / bad id

Symptom: an id-scoped call fails.
Recover: use ids returned by list/get tools (avatar_list, voice_list, product_list, asset_list_models, session results); never guess ids.

Long-running / "still processing"

Symptom: a *_get poll isn't done yet.
Recover: keep polling the matching status tool; a not-yet-done state is not a failure. Only conclude failure on a terminal failed state. See verification.

Missing source media

Symptom: a workflow needs a photo/video/audio the agent doesn't have.
Recover: check whether it already exists (e.g. in the brand/product or project) before asking. If genuinely missing, get it in via media-upload or ask the user to provide it. If a host policy blocks the upload, tell the user to upload directly in the Creatify web app.