2.13.0-beta.20). Features may change before the next stable release.Switch to stable →Skills
Create visual assets with ak:design
Route a visual-design request, generate or assemble the right artifact, and verify the files before delivery.
Use ak:design to turn a defined visual goal into a brand asset, logo, corporate
identity mockup, slide deck, banner, social image, icon, or poster prompt. The
Skill routes the request to bundled knowledge or a related Skill, then leaves
you with files and visual evidence to review.
Choose ak:design for visual artifacts
Use ak:design when
- You need a logo, icon, poster, banner, social image, presentation, or corporate identity deliverable.
- You want a brand package that connects a logo, identity mockups, and slides.
- You need a design brief or want to search the bundled style, palette, industry, layout, or deliverable data before generating anything.
- You want design-system direction and can route implementation work to the related brand, design-system, or UI-styling Skill when available.
Choose another workflow when
- You are implementing application components, Tailwind classes, or shadcn/ui.
Use
ak:ui-styling. - You need product UX reasoning, interaction rules, or an accessibility review.
Use
ak:ui-ux-pro-max. - You need a focused audit of existing web files against current external
guidelines. Use
ak:web-design-guidelines. - You need programmatic video or 3D scene code. Use
ak:remotionorak:threejs.
Prepare the brief and tools
Before you start:
- State the artifact type, audience, platform or physical format, required copy, brand assets, quantity, dimensions, and delivery format.
- Identify the existing brand source of truth and provide approved logos, fonts, colors, and image rights. Do not ask the Skill to guess official assets.
- Confirm where generated files may be written and whether intermediate HTML, reports, or prompt files should be kept.
- Install Python for bundled search scripts. Logo, CIP, and icon generation also
require
google-genaiand a provider key; CIP image handling requires Pillow. - Make a browser capture tool available for HTML-to-PNG banner or social-image workflows. Slide previews may load Chart.js, fonts, or images from the network.
| Runtime | Invocation | Evidence boundary |
|---|---|---|
| Claude Code | /ak:design ... | Native delivery supports the full Claude Hook surface when installed. Related Skills and provider tools still depend on the session. |
| Cursor | /ak:design ... | Slash invocation is user-verified. This does not prove that every related Skill, browser tool, or provider integration is present. |
| Codex | $ak:design ... | Native Skill discovery is supported. Hook projection is partial, and external generators still require their own credentials and tools. |
See Runtime adapters for target-specific delivery boundaries.
Run the Skill
The Skill has no top-level mode flags. Put the design type and context in the request; the selected built-in script may expose its own options.
/ak:design "Create three SVG settings-icon directions for a finance dashboard, inherit currentColor, include accessible titles, and save only approved files under ./assets/icons"/ak:design "Create three SVG settings-icon directions for a finance dashboard, inherit currentColor, include accessible titles, and save only approved files under ./assets/icons"$ak:design "Create three SVG settings-icon directions for a finance dashboard, inherit currentColor, include accessible titles, and save only approved files under ./assets/icons"Know which path you are starting
| Path | Typical input | Output and runtime effect |
|---|---|---|
| Logo | Brand, industry, style, optional prompt | Provider-generated PNG files; white backgrounds are required by the Skill. Batch generation makes multiple API calls. |
| CIP | Brand, approved logo, deliverables, industry, model | Provider-generated mockup PNGs; optional HTML presentation embeds images in one file. flash is the declared default and pro requests the higher-quality provider model. |
| Icon | Description, style, category, color, sizes | Provider-generated SVG text written as one file, a batch, or size variants. Inspect the XML before using it. |
| Poster | Topic, style or query, aspect, optional seed | Local bundled search and prompt text. It does not create an image until the prompt is sent to an image provider. |
| Banner or social image | Platform, dimensions, copy, brand, concepts | HTML/CSS source plus screenshot-exported PNGs; browser rendering, fonts, and images may use network and disk. |
| Slides | Audience, deck goal, content, data | HTML presentation using bundled layouts and copy guidance; Chart.js or remote assets may require network access. |
| Brand, tokens, UI | Identity or implementation request | Routes to related Skills. Availability is session-dependent and is not guaranteed by ak:design alone. |
The search-only logo, CIP, and poster commands read packaged CSV knowledge and print recommendations or prompts. Generation commands can create directories and files. Default names may be generated automatically, so provide an explicit output directory when ownership matters.
Follow the observable stages
- The Skill confirms the artifact contract. It captures the audience, format, dimensions, copy, brand constraints, source assets, and file boundary.
- It routes the work. The selected path may use bundled references, local search scripts, a related Skill, an image provider, or browser capture.
- It proposes direction before expensive work. Briefs, searches, or concept options should make style, palette, composition, and exclusions visible.
- It creates source and exports. Depending on the path, this can write SVG, PNG, HTML, Markdown, or prompt text and may make one or more provider calls.
- It verifies the artifact. Check dimensions, crop and safe zones, typography, brand fidelity, contrast, small-size legibility, and file opening.
- It reports evidence. The final report should list generated files, provider or renderer used, checks performed, failures, and remaining approvals.
Keep provider and file approval explicit
A design brief is not provider approval
Approving a concept does not authorize sending brand assets to an external model, incurring API charges, browsing third-party sites, overwriting files, or publishing the result. Approve those actions separately.
- Provider-backed logo, CIP, and icon paths transmit prompts and possibly input images to the configured provider and are subject to its billing, quota, retention, safety, and preview-model availability.
- Banner and social-image research can contact external sites; remote fonts, images, and Chart.js can also make network requests during rendering.
- Keep source logos and unrelated project files unchanged. Review the resolved output directory before batch or full-set generation.
- Treat generated words, logos, and brand marks as drafts. Check spelling, trademark conflicts, licensing, and authorized logo usage before publication.
- HTML screenshot output is RGB raster evidence, not proof of print-ready CMYK, bleed, DPI, color profile, or production tolerances.
Verify outputs and evidence
A useful completion report includes:
- The brief and selected visual direction, including rejected constraints.
- Exact artifact paths, formats, dimensions, and variation count.
- The source of design guidance: bundled data, project brand files, related Skill, or live research.
- Provider/model and number of generation calls when an external model was used, without exposing credentials.
- Visual QA for clipping, alignment, hierarchy, contrast, color-only meaning, text accuracy, safe zones, and legibility at the intended size.
- Remaining risks such as missing print proof, browser-only rendering, unverified licensing, or unavailable related Skills.
For SVG icons, verify a valid viewBox, scalable paths, currentColor when
required, an accessible title, and clarity at every requested size. For HTML
artifacts, render at the exact target viewport and inspect the exported image,
not only the source.
Troubleshoot and limits
| Symptom | Safe next step |
|---|---|
The runtime cannot find ak:design | Confirm installation target and scope, restart the runtime, then use Runtime cannot find a Skill or Agent. |
| A related Skill is unavailable | Continue with the relevant bundled path if it covers the request, or install the missing capability before claiming the routed workflow is complete. |
| A generator reports a missing package or key | Install only the named dependency, configure the provider key outside committed files, then retry one bounded output. |
| Output text or a logo is distorted | Keep the failed artifact, refine the brief, and regenerate a small variation set. Do not silently publish the draft. |
| HTML and PNG differ | Wait for fonts and images, capture at exact dimensions, inspect overflow and fallback fonts, then re-export. |
| A poster prompt looks right but no poster exists | The poster path emits text only. Obtain approval for an image provider, generate the bitmap, and record the provider separately. |
The bundled style and platform tables are packaged knowledge, not live platform
specifications. Recheck current ad sizes, brand rules, provider models, and
production requirements when freshness matters. Stable and beta contain the
same ak:design Skill and bundled resources in the documented releases.
Continue with the Engineer Kit overview, compare Runtime adapters, or use Projects, artifacts, and checkpoints to plan file ownership and recovery.
Create showcase artifacts with ak:show-off
Plan, research, design, review, capture, and optionally publish a self-contained presentation while controlling persistent workflow preferences.
Implement accessible UI with ak:ui-styling
Apply shadcn/ui, Tailwind, responsive theming, and visual checks without losing control of project files.