Star200+

Roast My Design System

REVIEW · 66
Community indexed

v3.11.0 · Try it: npx roast-my-design-system · Roasts your design system with real data: a health score, the receipts, the first fixes ranked by payoff, and with --rules the agent rules file that stops the mess coming back. Benchmarked against 30 public repos and 10 reputable systems. Also a Claude Code + Codex skill.

Verified installs0
Stars10
Version1.0.0
Quality68/100 · Promising
Trust66/100 · Sandbox only
Audit80/100 · Needs review

Supply asset profile

Design and creative production

Design assets, images, video, audio, multimodal media, presentation, and creative production skills.

Browse track

Scenario

Design and creative

I need my agent to produce design assets, UI directions, presentations, or creative media workflows.

Agent fit

Claude Code + OpenAI Agents + Cursor

Codex, Claude Code, Cursor, CLI, or custom agents.

Install

Ready

npx skills add pencilrebel/roast-my-design-system

Maintenance

fresh

9d since push

Risk

Needs review

Permission surface may require sandboxing

GitHub quality

10

68/100 Quality · 74/100 Trust

Coverage tags

DesignDesign and creativedesign-creativedesign-systemclaude-code

Review notes

Permission surface may require sandboxing · Low GitHub adoption signal

Agent adoption scorecard

Trust, audit, and install readiness at a glance

These scores combine public repository metadata, OpenAgentSkill review signals, maintenance freshness, and install readiness. They are a shortlist signal, not a replacement for human review.

Quality

Promising
68

Useful candidate, but compare it with alternatives before adopting.

Trust

Sandbox only
66

Useful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.

Audit

Needs review
80

A machine-readable review of install readiness, security metadata, maintenance, and adoption risk.

OpenAgentSkill Trust Score v5

Human review before install

Run only in a sandbox and compare close alternatives before using it for real work.

JavaScriptCodexClaude CodeCursorOpenAgentSkill CLI

Stars

10 GitHub stars

Repo activity

10 stars, 0 forks

Maintenance

9d since push

License

MIT

Install

npx skills add pencilrebel/roast-my-design-system

Install safety

standard package or runtime install path

Permission surface

secrets or environment access, filesystem or document access

Agent outcomes

No agent outcome data yet

Docs

Strong README/SKILL.md context

Risk summary

Review before production

  • Low GitHub adoption signal
  • Quality score needs review
  • Permission surface needs review: secrets or environment access, filesystem or document access
  • GitHub adoption: 10 GitHub stars

Install readiness

Install path available

  • Install path is available
  • Repository evidence is available
  • License is declared
  • No Agent Proven outcome evidence yet

Agent-readable metadata

Machine-readable decision data for this skill.

Use this block or the embedded JSON to decide whether an agent should install this skill, choose an alternative, or ask for human review first.

Open JSON

Suited tasks

  • Design and creative workflows
  • Claude Code teams
  • builders willing to evaluate younger projects
  • Inspect visual requirements

Suited agents

JavaScriptCodexClaude CodeCursorOpenAgentSkill CLIOpenAI AgentsCLI

Install decision

Command
npx skills add pencilrebel/roast-my-design-system
Policy
review
Human review
yes

Trust and risk

Trust
66/100
Audit
80/100
Risk level
Needs review

Outcome loop

Endpoint
/api/agent/outcome
Event ID
resolve
Outcomes
5

Install command

npx skills add pencilrebel/roast-my-design-system
Public auditEval reportResolve APIInstall handoff

Do not use when

  • teams that need a vendor-supported SLA
  • production agents without a repository review
  • Low GitHub adoption signal
  • No OpenAgentSkill engagement data yet
  • High-risk permission hints: Secrets or environment access
No close alternatives indexed yet.

Agent safety v2

52/100 · Avoid automatic install

Experimentalreview

Sparse or mixed signals. Useful for discovery, but not for autonomous installation.

Test manually in an isolated workspace and compare against safer alternatives.

Resolve via API

medium

Network access

Skill likely fetches remote pages, APIs, repositories, or external services.

medium

Filesystem access

Skill may read or write project files, documents, generated artifacts, or local workspace state.

high

Secrets or environment access

Skill metadata references credentials, tokens, environment variables, or secret-bearing workflows.

  • High-risk permission hints: Secrets or environment access
  • Permission surface may require sandboxing

Install targets

Install this skill in your agent workflow

Use the public install endpoint to fetch the command, safety checklist, target prompts, and canonical links for this skill.

skill install

OpenAgentSkill CLI

Resolve policy, run the source installer safely, and report a verified install receipt.

$ npx --yes https://github.com/Leon-Drq/openagentskill/releases/download/cli-v0.2.1/openagentskill-0.2.1.tgz install pencilrebel-roast-my-design-system

Agent resolve plan

Let an agent verify fit before installing.

The Resolve API returns the selected skill, alternatives, safety policy, audit notes, install target, and copy-paste prompt an agent can follow without scraping this page.

Open text plan

Open JSON

/api/agent/resolve?task=Use%20Roast%20My%20Design%20System%20for%20an%20agent%20workflow&agent=codex&max_risk=medium

Resolve text

/api/agent/resolve?task=Use%20Roast%20My%20Design%20System%20for%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text

Install handoff

/api/skills/pencilrebel-roast-my-design-system/install

Agent should check

  • Task fit and alternatives from Resolve API.
  • Audit score, trust score, and safety policy warnings.
  • Install target compatibility for Codex, Claude Code, Cursor, or CLI.

Copy prompt

Task: Use Roast My Design System in this workspace.
Resolve first: https://www.openagentskill.com/api/agent/resolve?task=Use%20Roast%20My%20Design%20System%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Review install handoff: https://www.openagentskill.com/api/skills/pencilrebel-roast-my-design-system/install
Install command: npx skills add pencilrebel/roast-my-design-system
Before running it, summarize audit warnings, required permissions, and the fallback skill if install is risky.

Agent handoff

Give an agent the install path, not another directory page.

Use the public install endpoint to fetch the command, safety checklist, target prompts, and canonical links for this skill.

Open install API

Install handoff

/api/skills/pencilrebel-roast-my-design-system/install

LLM text format

/api/skills/pencilrebel-roast-my-design-system/install?format=text

Find alternatives

/api/skills/search?q=Roast%20My%20Design%20System&limit=3

Agent prompt

Use Roast My Design System for this task. Review https://www.openagentskill.com/api/skills/pencilrebel-roast-my-design-system/install, then install with: npx skills add pencilrebel/roast-my-design-system

Registry metadata

Agent-readable profile for automatic skill selection.

This page exposes the same decision, trust, audit, use-case, and install signals through the Registry API, so agents can rank this skill without scraping the UI.

Open manifest

Manifest

/api/registry/manifest/pencilrebel-roast-my-design-system

LLM text

/api/registry/manifest/pencilrebel-roast-my-design-system?format=text

Install alias

/api/registry/install/pencilrebel-roast-my-design-system

Recommend

/api/registry/recommend?task=Use%20Roast%20My%20Design%20System%20in%20an%20agent%20workflow&limit=3

Agent fit

67/100

Design and creative

Use-case tags

Design and creativeResearch agentsWorkflow automation

Platforms

JavaScript, Claude Code, OpenAI Agents, Cursor

Audit report

Needs review · 80/100

A machine-readable review of install readiness, security metadata, maintenance, and adoption risk.

View audit reportView eval report

Agent decision cockpit

Fallback candidate for Design and creative

Prototype with this skill first; keep a fallback candidate ready.

67
Readiness
Prototype
Stage

Role in stack

Fallback candidate

Primary fit

Design and creative

Trust label

Prototype first

Install path

Command ready

Use when

  • Design and creative workflows
  • Claude Code teams
  • builders willing to evaluate younger projects

Evidence

  • recent repository activity
  • install command or GitHub repo available
  • 68/100 quality profile

review first

  • Low GitHub adoption signal
  • No OpenAgentSkill engagement data yet

Implementation path

  1. 1Install it in a sandbox agent and run one Design and creative task end to end.
  2. 2Compare output quality, latency, and failure behavior against at least one alternative.
  3. 3Promote it into production only after reviewing repository permissions, license, and maintenance signals.

Trust profile

Sandbox only

Useful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.

66
OpenAgentSkill Trust Score

GitHub adoption

FIX

10 GitHub stars

Stars/forks activity

FIX

10 stars, 0 forks; issue activity unavailable in current metadata

Recent maintenance

PASS

9d since push

License clarity

PASS

MIT

Good signals

  • AI review approved
  • Install path is available
  • Repository evidence is available
  • Recently maintained repository
  • Install command has no obvious high-risk pattern
  • Outcome loop is ready but needs first real agent run

Review before install

  • Low GitHub adoption signal
  • Quality score needs review
  • Permission surface needs review: secrets or environment access, filesystem or document access
  • GitHub adoption: 10 GitHub stars
  • Stars/forks activity: 10 stars, 0 forks; issue activity unavailable in current metadata
  • Permission surface: secrets or environment access, filesystem or document access
  • No real agent outcome reports yet
  • Human review required before unattended installation

Recommended action

Run only in a sandbox and compare close alternatives before using it for real work.

Quality profile

Promising candidate for agent workflows

Useful candidate, but compare it with alternatives before adopting.

68
GitHub stars
10
Freshness
9d ago
Install ready
Yes
License
MIT
Review before install: Low GitHub adoption signal

Workflow fit

Use this skill in these scenarios

Create assets

Design and creative

I need my agent to produce design assets, UI directions, presentations, or creative media workflows.

Investigate faster

Research agents

I need my agent to research a topic, compare sources, and produce a concise report.

Automate repeated work

Workflow automation

I need my agent to automate a repeated workflow across tools and files.

Workflow fit

Add it to a complete workflow

Design, build, test, and ship interfaces

Frontend and UI

A practical workflow for agents that turn product briefs or Figma designs into polished frontend code, review the result, test it in a browser, and prepare a safe deployment.

Scrape, clean, and reuse web data

Web data pipeline

A practical workflow for agents that crawl public pages, extract clean content, normalize data, and hand it to downstream research or RAG workflows.

Find, compare, and synthesize

Research report agent

A workflow for agents that gather sources, compare claims, summarize long material, and draft useful research briefs.

Overview

# roast-my-design-system

[![npm](https://img.shields.io/npm/v/roast-my-design-system?color=2dd4bf&label=npm)](https://www.npmjs.com/package/roast-my-design-system) [![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)

## A Claude Code skill that roasts your repo's design system with real data.

Run this skill on your codebase and get, in about a second:

- **A health score you can defend in a meeting.** 0-100, deterministic, benchmarked against Ideal Design System norms, 30 scanned public repos and 10 reputable design systems (Primer, Polaris, Carbon, shadcn/ui…). - **Per-package scores for monorepos.** One blended number hides which package is the problem: `packages/ui` scores 80 while `apps/web` scores 40, and now you can see it. - **The receipts behind it.** Every colour and its near-identical twin, every spacing value, typeface, duplicated or never-imported component, inline style and !important, with real file paths, in one self-contained HTML report you can open, Slack or email. - **The first fixes ranked by payoff.** A "Where to start" list derived from your own numbers: keep the report as the audit, or hand it to Claude as the punch list for the fix. - **Rules that stop the mess coming back.** A generated `design-system-rules.md` for your CLAUDE.md or .cursor/rules: canonical components, your token file, known duplicates to avoid, so your AI agent follows your system instead of guessing at it.

## Why this exists

Your AI agent (Claude, Cursor, Copilot) builds UI by imitating what's already in your repo. If your repo has 112 colours and four Button implementations, your agent guesses which one is canonical, and it picks wrong half the time. That's why AI-generated UI looks *almost-but-not-quite* right. The first step to fixing it is seeing the mess measured.

## Example use cases

- **Pre-refactor audit.** Run `/roast-my-design-system` before a design-system cleanup to get the measured baseline: every colour, spacing value, duplicated compon

Platform compatibility

javascriptFULL

Technical details

Version
1.0.0
License
MIT
Last updated
Aug 18, 2026
Published
Aug 13, 2026

Frameworks & tools

JavaScript

Decision snapshot

Fallback candidate

67
Ready
Prototype
Stage

recent repository activity

Audit

Install review

Install and adoption review

80
Needs review
Security
83/100
Maintenance
100/100
Install
92/100
Open full auditView eval report

Agent-proven evidence

Agent-proven evidence

Outcome reports after resolve, review, install, and one narrow run.

0
Proven
Needs first agent runAuto-install: review firstLast: Unknown
Success rate
—
Recent failure
—
Outcomes
0
Output quality
—
Failed
0
Not relevant
0
Installs
0
Risk blocked
0
Setup needed
0
Production
0

No agent outcome data yet. The first agent run can report success, setup needs, risk blocks, failure, or not-relevant through /api/agent/outcome.

Agent-Proven rankingOutcome contract

Install

Add to agent workflow

Free and open source. Review the report before installing into production agents.

Compare AlternativesAuto-resolve PlanView on GitHubDocumentation

Growth loop

Share kit

X

Scenario-led draft for Roast My Design System, ready for a manual X post.

Curator note
Roast My Design System: A Claude Code/Codex skill that audits design systems with a health score, receipts, prioritiz...

10 stars

https://www.openagentskill.com/skills/pencilrebel-roast-my-design-system?ref=x
Open X draft
Optional reply with install command
Listing + install path for Roast My Design System:
https://www.openagentskill.com/skills/pencilrebel-roast-my-design-system?ref=x

Install: npx skills add pencilrebel/roast-my-design-system
Open reply draft

Listing source

Community indexed

Claimable

This listing was indexed from public sources and is not marked official until a maintainer claim is approved.

Indexed by
OpenAgentSkill community index

Attribution links to the public repository or creator profile. Creators can claim the listing to update ownership signals.

Claim this skill

Owner claim

Claim this skill listing

This Community indexed listing is attributed to pencilrebel but is not marked official yet. Claim it to add a verified owner signal and make future launch, install, and audit updates easier to trust.

Creator backlink kit

Add the evidence badges to your README

Show the canonical listing, current trust and audit signals, and real Agent-Proven evidence where developers evaluate the repository.

[![Listed on OpenAgentSkill](https://www.openagentskill.com/api/badge/pencilrebel-roast-my-design-system?metric=listed&label=Listed)](https://www.openagentskill.com/skills/pencilrebel-roast-my-design-system)
[![OpenAgentSkill Trust](https://www.openagentskill.com/api/badge/pencilrebel-roast-my-design-system?metric=trust&label=Trust)](https://www.openagentskill.com/skills/pencilrebel-roast-my-design-system)
[![OpenAgentSkill Audit](https://www.openagentskill.com/api/badge/pencilrebel-roast-my-design-system?metric=audit&label=Audit)](https://www.openagentskill.com/skills/pencilrebel-roast-my-design-system/audit)
[![Agent Proven](https://www.openagentskill.com/api/badge/pencilrebel-roast-my-design-system?metric=proven&label=Agent%20Proven)](https://www.openagentskill.com/skills/pencilrebel-roast-my-design-system)
Preview badge Open audit Creator kit

Author

P

pencilrebel

@pencilrebel

Tags

design-systemclaude-codecodexcode-analysishealth-score

Platform fit

Claude CodeOpenAI AgentsCursor

Health signals

GitHub stars
10
Quality score
42/100
Last GitHub push
Aug 12, 2026
Framework hints
1
OpenAgentSkill views
0
Install copies
0
Outbound clicks
0

Community signal

Share whether this skill looks useful for your agent workflow. Aggregated feedback improves rankings over time.

Trust & safety

Sandbox only

66
  • GitHub adoption10 GitHub starsFIX
  • Stars/forks activity10 stars, 0 forks; issue activity unavailable in current metadataFIX
  • Recent maintenance9d since pushPASS
  • License clarityMITPASS
  • README/SKILL.md completenessMetadata includes enough usage and workflow contextPASS
  • Dependency/runtime riskcredential or environment accessINFO
InstallView on GitHub