codia-design-skills

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:

command -v codia-design

Windows PowerShell:

Get-Command codia-design -ErrorAction SilentlyContinue

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

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

Then verify:

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:

codia-design auth status

If disconnected, prefer browser login:

codia-design auth login --platform codex

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

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.

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:

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.