Agent skill

Open Design

by compozy in compozy/compozy

Create or refine interfaces, sites, HTML slides, and visual documents from a short brief, existing HTML, or uiux.md.

MITAuto-check passedDocuments & Office

Install Open Design

skills CLI
$ npx skills add compozy/compozy --skill open-design -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install compozy/compozy open-design --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/compozy/compozy.git skills-src && mkdir -p .claude/skills && cp -r skills-src/extensions/open-design/skills/open-design .claude/skills/open-design && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
open-design
GitHub stars
2.8k
Token cost
~1.3k tokens
SKILL.md length
644 words
Files
3 (incl. references)
Skills in repo
47
Repo updated
First seen
Licence
MIT

At a glance

Create or refine interfaces, sites, HTML slides, and visual documents from a short brief, existing HTML, or uiux.md.

  • Directly openable workspace artifacts under docs/design
  • SKILL.md covers Bind the design to its project, Author a directly openable…, Verify and deliver and Explicit independent review
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Excludes production application implementation and automatic independent review

What it does

Open Design is an agent skill from compozy/compozy. Create or refine interfaces, sites, HTML slides, and visual documents from a short brief, existing HTML, or uiux.md. Use for directly openable workspace artifacts under docs/design; excludes production application implementation and automatic independent review.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/artifacts.md` and `references/craft.md`).

It sits in Documents & Office, covering Slides and decks. The repository describes itself as: An operating system for AI agents. Plug in the agent CLIs you already use (Claude Code, Codex, Gemini CLI, Cursor) and they become a team: they split the work, hand tasks to each… The licence is MIT.

When your agent uses it

  • Directly openable workspace artifacts under docs/design
  • Excludes production application implementation and automatic independent review

Example prompts

  • “/open-design”

What it can do on your machine

Read from SKILL.md and the folder at commit eec2ed1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Open Design loads about 1.3k tokens when it runs, and up to ~6.5k if it reads all its reference files. Until then it costs about 69 tokens; SKILL.md has 644 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~69
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from compozy/compozy at commit eec2ed1, republished under its MIT licence (© compozy). 644 words, ~1,266 tokens.

Download SKILL.mdSave it as .claude/skills/open-design/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
open-design
description
Create or refine interfaces, sites, HTML slides, and visual documents from a short brief, existing HTML, or _uiux.md. Use for directly openable workspace artifacts under docs/design; excludes production application implementation and automatic independent review.

Open design

Create the smallest complete artifact that answers the request. A short brief and a _uiux.md are equally valid inputs. Use the user's language unless the requested content specifies another. Ask only when an unresolved decision prevents useful work; otherwise state a reasonable assumption and proceed.

Bind the design to its project

Read the supplied context and the relevant existing UI, components, tokens, assets, and approved references. Current project authority governs visual choices; do not impose CompozyOS styling on another product or let a generic aesthetic rule replace the approved system. If no direction exists, choose one coherent approach suited to the audience and content.

For _uiux.md, preserve requested surfaces, states, artifact paths, component mappings, and relevant behavior from linked spec/story sections. Respect superseded entries and group related states where useful. Treat illustrative references as visual guidance, not permission to invent features. Keep unresolved product decisions visibly provisional.

Load only the reference sections needed for this artifact, relative to this skill's directory:

  • craft.md: hierarchy, composition, content, and color for a new direction; semantics, focus, and states for interactive work; language and motion when affected.
  • artifacts.md: the matching lane for an interface, site, HTML slide deck, or visual document, including its relevant delivery checks.

Use compozy__skill_view with name: open-design and file: references/craft.md or references/artifacts.md when available. If the native skill reader is unavailable or denies access, report the reference as unavailable; do not bypass the managed-session reader. Reuse already-read guidance while it remains relevant.

Author a directly openable artifact

Write docs/design/<slug>/index.html in the active workspace by default. Explicit requested paths under docs/design/ take precedence. Keep supporting assets there with ordinary relative links, or inline them. The output must open from a local file without a build, service, custom viewer, installed-extension paths, or remote runtime dependencies.

Use complete, brief-derived content and accurate assets. Label illustrative data; never invent sources, endorsements, metrics, or backend guarantees. A named real person, product, brand, artwork, or place needs its correct asset, not a fabricated look-alike. Reuse approved local assets first; disclose a necessary labeled placeholder when the correct asset is unavailable. Preserve image proportions and required attribution.

Give meaningful regions and controls stable data-od-id values for precise feedback. Implement local demonstrations of the requested interactions without calling product mutation APIs. Keep prototype or presenter controls out of the artifact unless needed by its format or requested by the user.

Refine the same files in place, preserving approved decisions and unrelated content. Do not create a version system, extra registry, or mandatory companion document. This workflow creates design artifacts; it does not edit production application code or publish them.

Show full SKILL.md (211 more words)Show less

Verify and deliver

Read back the changed HTML, check local assets and content completeness, and exercise the primary interaction when tooling permits. Invoke ext__open_design__lint_artifact with the actual workspace-relative HTML paths. Inspect its findings, fix applicable defects, and explain an intentional exception with the specific user or project authority. Report unavailable lint tooling as unverified.

When rendered inspection would resolve a visual or interaction risk, use the bundled open-design-browser skill with an isolated task-owned CLI session. Do not substitute browser-use, attach to an existing browser, or operate the user's live browsing session. Load the resulting screenshot through the harness's image-reading capability before claiming visual inspection; an accessibility snapshot or screenshot path is not visual proof. Keep checks proportional to the change. Missing browser support need not block an HTML sketch, and does not justify an automatic installation.

Link the actual HTML files and briefly describe the result, checks performed, and material limitations. Do not repeat their source in chat. Recheck affected areas after corrections and reuse valid evidence for unchanged areas.

Explicit independent review

Load open-design-review only when the user requests the independent review and refinement cycle. Routine creation, edits, or _uiux.md input alone stay in the designer conversation. When acting inside that loop, follow its supplied schema without starting another run.

© compozy, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in extensions/open-design/skills/open-design of compozy/compozy.

  • SKILL.md
  • references/artifacts.md
  • references/craft.md

Open the folder on GitHubat commit eec2ed1

Compare with similar skills

Open Design next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Open Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Open Design this skillcompozy/compozy2.8k—~1.3kAutomated safety check: PassMIT
Image To Editable Pptningzimu/image-to-editable-ppt-skill2.8k—~4.3kAutomated safety check: PassMIT
Codex Slidesnexu-io/codex-slides9241 repos~3kAutomated safety check: PassMIT
Slidesfcakyon/claude-codex-settings1.2k1 repos~1.1kAutomated safety check: PassMIT
Ppt Image FirstNyxTides/ppt-image-first1.2k—~1.6kAutomated safety check: PassApache-2.0
Vibe to Agentic Engineering Frameworkshanraisshan/claude-code-best-practice67k—~3.3kAutomated safety check: PassMIT

Similar skills

  • Image To Editable Ppt

    ningzimu/image-to-editable-ppt-skill

    Rebuild slide images, scanned or image-based PPT/PPTX files, and PDF decks into object-level editable PowerPoint (.pptx), preserving speaker notes when supplied.

    2.8k GitHub stars~4.3k tokensUpdated 21 days ago
    Documents & OfficeAuto-check passed
  • Codex Slides

    nexu-io/codex-slides

    Create, research, revise, restyle, present, inspect, and export Codex Slides slide decks from Codex, including scenario workflows, project Design Files, and always-on brand design systems.

    924 GitHub starsUsed in 1 repo~3k tokens
    Documents & OfficeAuto-check passed
  • Slides

    fcakyon/claude-codex-settings

    Create and edit presentation slide decks (.pptx) with PptxGenJS, bundled layout helpers, and render/validation utilities.

    1.2k GitHub starsUsed in 1 repo~1.1k tokens
    Documents & OfficeAuto-check passed
  • Ppt Image First

    NyxTides/ppt-image-first

    Build presentation plans for PPT / slides / decks through a conversation-first workflow, then propose multiple visual directions with preview images before writing deck specs.

    1.2k GitHub stars~1.6k tokensUpdated 5 mo ago
    Documents & OfficeAuto-check passed
  • Vibe to Agentic Engineering Framework

    shanraisshan/claude-code-best-practice

    Explains the conceptual model behind a presentation on moving from unstructured vibe coding to fully configured agentic engineering, including its 4-level scoring system and slide conventions.

    67k GitHub stars~3.3k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Gpt Image2 Ppt

    JuneYaooo/gpt-image2-ppt-skills

    Generate visually striking PPT slides via OpenAI's gpt-image-2 -- use any style in styles/<collection/STYLEID.md or mimic a user-supplied .pptx template; outputs high-res slide PNGs and a 16:9 .pptx.

    1.3k GitHub stars~8.9k tokensUpdated 1 mo ago
    Documents & OfficeAuto-check: notes

More from compozy/compozy

All 47 skills in this repo
  • Eng Real Scenario QA

    compozy/compozy

    Dogfoods Compozy through an autonomous startup scenario with live providers, cross-surface observation, and strict evidence audit.

    2.8k GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • Eng Test Conventions

    compozy/compozy

    Go test-shape discipline for Compozy. An agent skill from compozy/compozy.

    2.8k GitHub stars~467 tokensUpdated today
    Auto-check passed
  • Assistant UI

    compozy/compozy

    Guide for assistant-ui library - AI chat UI components. An agent skill from compozy/compozy.

    2.8k GitHub stars~958 tokensUpdated today
    Auto-check passed
  • Guide for assistant-ui UI primitives - ThreadPrimitive, ComposerPrimitive, MessagePrimitive.

    2.8k GitHub stars~999 tokensUpdated today
    Auto-check passed
  • Assistant UI Runtime

    compozy/compozy

    Guide for assistant-ui runtime system and state management. An agent skill from compozy/compozy.

    2.8k GitHub stars~856 tokensUpdated today
    Auto-check passed
  • Assistant UI Streaming

    compozy/compozy

    Guide for assistant-stream package and streaming protocols. An agent skill from compozy/compozy.

    2.8k GitHub stars~813 tokensUpdated today
    Auto-check passed

Questions about Open Design

What does Open Design do?

Create or refine interfaces, sites, HTML slides, and visual documents from a short brief, existing HTML, or uiux.md. Open Design is an agent skill from compozy/compozy.md.

When should I use Open Design?

Open Design fits situations like: directly openable workspace artifacts under docs/design; excludes production application implementation and automatic independent review.

How do I install Open Design in Claude Code?

Run `npx skills add compozy/compozy --skill open-design -a claude-code`. Or copy the skill folder (extensions/open-design/skills/open-design in compozy/compozy) into .claude/skills/open-design in your project. Claude Code loads it when a task matches its description.

How do I install Open Design in Codex?

Run `npx skills add compozy/compozy --skill open-design -a codex`. Or copy the skill folder (extensions/open-design/skills/open-design in compozy/compozy) into .agents/skills/open-design in your project. Codex loads it when a task matches its description.

Can I use Open Design in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add compozy/compozy --skill open-design -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/open-design, .gemini/skills/open-design, .github/skills/open-design and .opencode/skills/open-design in your project.

What does Open Design need to run?

SKILL.md names no scripts, command-line tools or credentials: Open Design is instructions for the agent only.

Does Open Design access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Open Design safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Open Design use?

Open Design is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Open Design use?

About 1.3k tokens (SKILL.md is roughly 5.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.2k tokens, read only when the agent opens those files.

What are the alternatives to Open Design?

Skills that share tags, products or a category with Open Design: Image To Editable Ppt (ningzimu/image-to-editable-ppt-skill, 2.8k stars), Codex Slides (nexu-io/codex-slides, 924 stars), Slides (fcakyon/claude-codex-settings, 1.2k stars) and Ppt Image First (NyxTides/ppt-image-first, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Open Design?

compozy (a GitHub organization) maintains it in compozy/compozy, which has 2,792 GitHub stars. The repository holds 47 skills in this directory. The repository was last updated on October 8, 2026.

Source: compozy/compozy on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.