Sandbox
@MohtashamMurshid/getdesign

Portable design system skill for Claude Code and Cursor

getdesign is a portable skill that tells your agent how to inspect a site and write out a design system in `design.md`. It uses the agent’s own browser, fetch, and write tools, and the repo also includes the current web surface plus scaffolding for future API, CLI, and SDK surfaces.

49 stars4 forksTypeScriptUpdated 11d ago
Who it's for

Builders who want an agent to extract design tokens, components, and layout rules from a URL into a reusable file.

What it delivers

You can turn a live site into a design reference your agent can reuse instead of re-deriving the same patterns.

What it does

Design system extraction from a URL

Produces a `design.md` with palette, typography, components, layout, depth, motion, and responsive rules grounded in the site’s CSS.

Portable agent skill

Installs as a skill through `skills.sh` and can run inside Claude Code, Codex, Cursor, and other supported agents.

Web surface for the product

Includes the implemented Next.js web app in `apps/web`, with the landing page, `/design` showcase, and waitlist flow.

Backend-backed waitlist

Uses `convex/` for the waitlist data and run artifacts used by the web app.

Future CLI and SDK surfaces

Contains placeholder packages in `packages/cli` and `packages/sdk` for planned command-line and TypeScript access.

How to get it

  1. 1Run
    bun install
    cd apps/web && bun run dev   # http://localhost:3000

README

getdesign

On-demand design systems from any URL. One implemented web app, four planned surfaces.

License: MIT Skill: skills.sh PRs Welcome

Paste a URL. Get a production-grade design.md — palette, typography, components, layout, depth, motion, responsive rules, and an agent prompt guide — grounded in the site's actual CSS, not hallucinated.

Demo Video

https://github.com/user-attachments/assets/b88a05db-a5cb-4d0e-ae8f-cd143b3fad7d

Watch or download the MP4

SurfaceCurrent state
WebImplemented in apps/web as the landing page, /design showcase, and waitlist API route
HTTP APIPlanned product surface; not implemented in this repo yet
CLIPlaceholder package in packages/cli; not a full product surface yet
TypeScript SDKPlaceholder package in packages/sdk; not a full client implementation yet
Agent skillImplemented in skills/getdesign and installable via npx skills add MohtashamMurshid/getdesign

See:

  • prd.md — product requirements (what and why)
  • architecture.md — technical architecture (how)
  • skills/ — the portable agent skill (fifth surface)

Status

Current repo state:

  • apps/web is the main implemented surface.
  • convex/ backs the waitlist flow used by the web app.
  • packages/sdk and packages/cli are intentional placeholders for future public packages.
  • The agent skill in skills/getdesign is implemented and documented.

The fuller multi-surface product architecture still lives in architecture.md, but parts of that document describe the target system rather than the code already in this repository.

Layout

apps/
  web/        Next.js 16 landing page, /design showcase, waitlist route
packages/
  cli/        Placeholder npm CLI package
  config/     Shared tsconfig package
  sdk/        Placeholder npm SDK package
  tools/      Placeholder tools package
  types/      Placeholder shared types package
convex/       Convex backend (initialized)
skills/       Agent skills (distributed via skills.sh)

Planned surfaces such as apps/api, a richer CLI, and the full SDK described in architecture.md are future work and are intentionally not scaffolded in this repo yet.

Prerequisites

  • Bun ≥ 1.3
  • Node ≥ 20

Install & dev

bun install
cd apps/web && bun run dev   # http://localhost:3000

Quickstarts

SDK placeholder

import { getDesign } from "@getdesign/sdk";

await getDesign("https://cursor.com");
// Throws today: the published SDK package is a private-beta placeholder.

Agent skill

Install into Claude Code, Codex, Cursor, or any of the 40+ supported agents:

npx skills add MohtashamMurshid/getdesign

Then prompt your agent:

extract the design system from cursor.com into design.md

The skill drives your agent's own WebFetch / browser / Write tools — zero infrastructure, same 9-section output.

Contributing

PRs welcome. Start with CONTRIBUTING.md. By participating you agree to the Code of Conduct.

For security issues, use GitHub private vulnerability reporting — see SECURITY.md.

License

MIT © 2026 Mohtasham Murshid Madani

Files in the repo

Repository payload24 top-level entries
  • .cursor
  • .github
  • apps
  • convex
  • docs
  • getdesign-runs
  • media
  • packages
  • scripts
  • skills
  • .gitignore
  • AGENTS.md
  • architecture.md
  • bun.lock
  • CHANGELOG.md
  • CODE_OF_CONDUCT.md
  • CONTEXT-MAP.md
  • CONTRIBUTING.md
  • LICENSE
  • package.json
  • prd.md
  • README.md
  • SECURITY.md
  • turbo.json

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More skills

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

117k
1 add
Vincentwei1021/
anything2explainer

Topic in, narrated explainer video out. A Claude Code / Codex skill that turns any topic into a black-canvas motion-graphics explainer video with TTS voiceover, subtitles and a chapter progress bar. Chinese or English; every frame drawn in code with Remotion.

666

Taste-Skill - gives your AI good taste. stops the AI from generating boring, generic slop

86k

Agent skill for beautiful, verifiable architecture, workflow, sequence, data-flow, and lifecycle diagrams—self-contained HTML with motion and crisp export.

57k