Codia Design Skills#

This is the root router skill for the Codia Design Skills pack. In the normal npx skills add install flow, agents load this top-level skill first. The feature and workflow skills under skills/ are supporting instructions that this router reads when the request needs a specific capability.

Use Codia through the local codia-design CLI. The CLI performs authenticated requests to Codia Open API and writes local downloads when commands return files.

Runtime Setup#

Before running a Codia command, check whether the CLI is available.

macOS / Linux:

bash

command -v codia-design

Windows PowerShell:

powershell

Get-Command codia-design -ErrorAction SilentlyContinue

If codia-design is missing and the user allows global npm installs, install the runtime:

bash

npm install -g @codia-ai/codia-design-cli

Then verify:

bash

codia-design --help
codia-design auth status

If global npm install is blocked, tell the user to run the same install command manually, then continue after they confirm it is installed.

Authentication#

Check auth before billable work:

bash

codia-design auth status

If disconnected, prefer browser login:

bash

codia-design auth login --platform codex

If browser login is unavailable and the user provides an API key, bind it without echoing the value:

bash

codia-design auth set --api-key api_key_xxx

The CLI stores auth state in ~/.codia/design-skills/config.json. Never print this file or API keys.

Routing Rules#

Read the matching child skill before running commands that need parameters, model choices, polling behavior, or multi-step sequencing. Resolve paths relative to this root SKILL.md.

User intentReadBroad Codia setup, auth, account checks, or fallback routingskills/codia-design/SKILL.mdProduct launch packs, ecommerce listing assets, marketplace visualsskills/codia-product-assets/SKILL.mdCampaign posters, launch visuals, social creative sets, multi-size adaptationsskills/codia-campaign-assets/SKILL.mdPDF/report/document to editable design data, PPTX deck, or bothskills/codia-document-deck/SKILL.mdText-to-image generation, posters, campaign visuals, backgroundsskills/codia-image-generate/SKILL.mdImage-to-image generation from one or more referencesskills/codia-image-image-to-image/SKILL.mdControlled visual variations from an existing imageskills/codia-image-remix/SKILL.mdReframe or adapt images to new aspect ratiosskills/codia-image-reframe/SKILL.mdUpscale or improve final image qualityskills/codia-image-upscale/SKILL.mdRemove image backgrounds or create transparent PNG cutoutsskills/codia-remove-bg/SKILL.mdReplace backgrounds with studio, lifestyle, or campaign scenesskills/codia-image-replace-bg/SKILL.mdErase unwanted objects, clutter, or defects from authorized imagesskills/codia-image-object-erase/SKILL.mdRemove watermarks or overlays from authorized imagesskills/codia-image-watermark-remove/SKILL.mdDescribe, inspect, caption, or analyze an imageskills/codia-image-describe/SKILL.mdConvert screenshots, UI mockups, posters, or images into editable design dataskills/codia-image-to-design/SKILL.mdConvert images into Codia layering DSLskills/codia-image-layering/SKILL.mdConvert selected PDF pages into editable design dataskills/codia-pdf-to-design/SKILL.mdConvert selected PDF pages into a downloadable PPTX deckskills/codia-pdf-to-ppt/SKILL.mdVectorize logos, icons, or images into SVGskills/codia-svg/SKILL.mdCheck credit balanceskills/codia-credits/SKILL.mdInspect usage records and recent task costsskills/codia-usage/SKILL.mdRead or update automatic recharge settingsskills/codia-auto-recharge/SKILL.md

Prefer a workflow skill when the user asks for a real outcome with multiple deliverables. Prefer a feature skill when the request is a single clear operation.

Common Workflow Choices#

Use skills/codia-product-assets/SKILL.md when the user wants a product or ecommerce deliverable such as a listing image set, product launch asset pack, store banner, white-background product tile, or lifestyle scene variants.

Use skills/codia-campaign-assets/SKILL.md when the user wants campaign or social creative, such as a poster plus adapted 1:1, 4:5, 9:16, banner, or thumbnail versions.

Use skills/codia-document-deck/SKILL.md when the user wants to turn PDFs, reports, screenshots, or existing design files into editable design data, a PPTX deck, or both.

Command Rules#

• Prefer local file paths when the user provides local assets.
• Use --out for large JSON responses.
• Use --download-dir DIR when the user asks where outputs should go.
• Use --no-download only when the user explicitly wants JSON-only behavior.
• For PDFs, Codia page numbers are zero-based: page 0 is the first page.
• For pdf-to-ppt, use the CLI polling/download flow and validate the returned PPTX. Do not rasterize the PDF locally or create a substitute deck unless the user explicitly asks for a local fallback.
• For image generation, keep the first call simple when the user has not specified model or size. The CLI default is seedream_5 at 2560x1440.
• For watermark or object removal, proceed only when the image is user-owned or otherwise authorized.

Account And Cost Checks#

The CLI uses the public Open API v2 surface ( /v2/open/*) and estimates billable credit cost before paid operations. After a billable command, it may query credits and warn if the remaining balance is low. That warning should not block the requested work unless the API itself rejects the request.

Useful commands:

bash

codia-design credits
codia-design usage --page 1 --page_size 20
codia-design limits

Output Expectations#

Report the concrete result: local output file paths, downloaded PPTX path, image files, returned URLs, task IDs, and any API error messages. Do not include secrets, raw auth config, or unnecessary full JSON when a compact summary is enough.