agentleFS
xjxj71xjxj71/ai-token-usage-statistics/.claude/skills/opendesign/SKILL.md

opendesign

Skill1 starsChanged 3 months agoMITView on GitHub

Use when the user wants to design web pages, prototypes, decks, mobile app screens, dashboards, landing pages, or any visual design artifact using Open Design (open-design.ai). Triggers on requests like "design a page", "create a prototype", "make a landing page", "build a dashboard UI", "design a mobile screen", "create a pitch deck".

  • Reads credentials
  • Installs packages

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

10 rules. About 0 are common, 10 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈10

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    If not installed, choose one:

    line 23
  2. Distinctive:

    When you want to use Open Design's skill templates and design philosophy without the web UI:

    line 53
  3. Distinctive:

    Import OD's design patterns into your own project:

    line 66
  4. Distinctive:

    When the user has no brand preference, OD offers 5 curated schools:

    line 141
  5. Distinctive:

    Before emitting any artifact, the agent must verify:

    line 163
  6. Distinctive:

    No generic gradient backgrounds

    line 164
  7. Distinctive:

    No placeholder "Lorem ipsum" text

    line 165
  8. Distinctive:

    No mismatched font pairings

    line 166
  9. Distinctive:

    No accessibility violations (contrast, alt text, semantic HTML)

    line 168
  10. Distinctive:

    When used alongside Claude Code:

    line 172

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Open Design Skill

Overview

Open Design (OD) is the open-source alternative to Claude Design / Figma. It runs locally, uses your existing coding agent (Claude Code, Codex, Gemini CLI, etc.) as the design engine, and ships 132 composable Skills and 150 brand-grade Design Systems.

Core principle: The agent doesn't freestyle — it follows a structured design workflow: discovery form → direction picker → skill template → five-dimensional critique → artifact output.

Prerequisites

Open Design must be installed and running. Verify:

# Check if Open Design daemon is running
curl -s http://localhost:7456/api/health || echo "OD not running"

If not installed, choose one:

# Option 1: Desktop app (no build required)
# Download from https://open-design.ai/ or GitHub releases

# Option 2: Docker
git clone https://github.com/nexu-io/open-design.git
cd open-design/deploy
cp .env.example .env
# Generate token: openssl rand -hex 32 → paste into .env
docker compose up -d
# Open http://localhost:7456

# Option 3: From source
git clone https://github.com/nexu-io/open-design.git
cd open-design
corepack enable
pnpm install
pnpm tools-dev start

Usage Patterns

1. Design via Open Design Web UI

The primary workflow — open http://localhost:7456, pick a skill, pick a design system, type your brief. The interactive question form locks down design decisions before the agent writes code.

2. Design via Claude Code Directly

When you want to use Open Design's skill templates and design philosophy without the web UI:

# Browse available skills
ls ~/.open-design/skills/ 2>/dev/null || ls <open-design-path>/skills/

# Read a specific skill template
cat <open-design-path>/skills/web-prototype/SKILL.md
cat <open-design-path>/skills/saas-landing/SKILL.md

3. Use Open Design Skills as Reference

Import OD's design patterns into your own project:

# Copy a skill template to your project
cp -r <open-design-path>/skills/web-prototype/ .claude/skills/web-prototype/

Available Skills (132 total)

Design & Prototyping (prototype mode)

SkillDescription
web-prototypeSingle-page HTML — landings, marketing, hero pages (default)
saas-landingHero / features / pricing / CTA marketing layout
dashboardAdmin / analytics with sidebar + dense data layout
pricing-pageStandalone pricing + comparison tables
docs-page3-column documentation layout
blog-postEditorial long-form
mobile-appiPhone 15 Pro / Pixel framed app screen(s)
mobile-onboardingMulti-screen mobile onboarding flow
gamified-appThree-frame gamified mobile-app prototype
email-marketingBrand product-launch HTML email
social-carousel3-card 1080x1080 social carousel
magazine-posterSingle-page magazine-style poster
motion-framesMotion-design hero with CSS animations
sprite-animationPixel / 8-bit animated explainer slide
dating-webConsumer dating dashboard mockup
wireframe-sketchHand-drawn ideation sketch
critiqueFive-dimensional self-critique scoresheet

Deck / Presentation (deck mode)

SkillDescription
guizang-pptMagazine-style web PPT (default for deck)
simple-deckMinimal horizontal-swipe deck
replit-deckProduct-walkthrough deck
weekly-updateTeam weekly cadence as a swipe deck

Office & Operations

SkillDescription
pm-specPM specification doc with TOC + decision log
team-okrsOKR scoresheet
meeting-notesMeeting decision log
kanban-boardBoard snapshot
eng-runbookIncident runbook
finance-reportExec finance summary
invoiceSingle-page invoice
hr-onboardingRole onboarding plan

Design Systems (150 built-in)

Product-grade design systems with full token specs:

SystemStyle
LinearMinimal, monochrome, sharp
StripeClean, trustworthy, gradient-heavy
VercelBlack/white, geometric, developer-first
AirbnbWarm, rounded, photography-led
TeslaDark, cinematic, premium
NotionNeutral, content-first, wiki-style
ApplePrecise, white-space, SF Pro
AnthropicEthical, calm, earth-tones
CursorDark IDE, code-native
SupabaseGreen accent, developer dashboard
XiaohongshuPink, social, mobile-first

Plus 139 more. Each system is a 9-section DESIGN.md: color, typography, spacing, layout, components, motion, voice, brand, anti-patterns.

Five Visual Directions

When the user has no brand preference, OD offers 5 curated schools:

DirectionPaletteFont Stack
Editorial MonocleHigh-contrast, serifPlayfair Display + Inter
Modern MinimalNeutral, geometricGeist + Geist Mono
Warm SoftEarthy, roundedPlus Jakarta Sans + DM Mono
Tech UtilityMonospace, terminalJetBrains Mono + Inter
Brutalist ExperimentalRaw, high-saturationSpace Grotesk + IBM Plex Mono

Design Philosophy

OD enforces a structured workflow to prevent "AI freestyle":

  1. Discovery Form — Lock brief: surface, audience, tone, brand context, scale
  2. Direction Picker — Choose visual direction (5 curated schools)
  3. Skill Template — Agent reads SKILL.md + assets/template.html
  4. Five-Dimensional Critique — Philosophy / Hierarchy / Detail / Function / Innovation
  5. Artifact Output — Single <artifact> rendered in sandboxed iframe

Anti-AI-Slop Checklist

Before emitting any artifact, the agent must verify:

  • No generic gradient backgrounds
  • No placeholder "Lorem ipsum" text
  • No mismatched font pairings
  • No inconsistent spacing
  • No accessibility violations (contrast, alt text, semantic HTML)

Integration with Claude Code

When used alongside Claude Code:

# Claude Code acts as the design engine
# OD's daemon spawns claude CLI with:
#   cwd = .od/projects/<id>/
#   tools = Read, Write, Bash, WebFetch
#   prompt = DISCOVERY + identity + DESIGN.md + SKILL.md + project metadata

The agent reads the skill template, follows the design system tokens, and produces a single HTML artifact with inline assets.

Export Formats

FormatMethod
HTMLInline assets, single file
PDFBrowser print, deck-aware
PPTXAgent-driven via skill
ZIPArchiver (HTML + assets)
MarkdownText extraction

Common Workflows

Landing Page

User: "Design a SaaS landing page for our AI analytics product"
→ OD: discovery form → direction picker → saas-landing skill → artifact

Mobile Prototype

User: "Create a mobile app prototype for a fitness tracker"
→ OD: discovery form → mobile-app skill → iPhone frame → artifact

Pitch Deck

User: "Make a seed round pitch deck"
→ OD: discovery form → guizang-ppt skill → magazine-style slides → artifact

Dashboard

User: "Design an admin dashboard for user management"
→ OD: discovery form → dashboard skill → sidebar + data layout → artifact

Troubleshooting

IssueSolution
Daemon not respondingpnpm tools-dev status or docker compose logs -f
Agent not detectedVerify CLI is on PATH: which claude
Skill not appearingRestart daemon after adding skill folder
Export failsCheck browser console; try HTML export first
Port conflictpnpm tools-dev start --daemon-port 7457

Resources

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.