Skip to content

Add cloudscape-design-system skill#237

Open
r33drichards wants to merge 1 commit intovercel-labs:mainfrom
r33drichards:add-cloudscape-design-system
Open

Add cloudscape-design-system skill#237
r33drichards wants to merge 1 commit intovercel-labs:mainfrom
r33drichards:add-cloudscape-design-system

Conversation

@r33drichards
Copy link
Copy Markdown

Summary

  • Adds a new skill, skills/cloudscape-design-system/, bundling the full AWS Cloudscape Design System documentation as markdown references.
  • Ingests from cloudscape.design's own llms.txt index — no scraping of SPA JavaScript required because cloudscape publishes <page>/index.html.md for every page.
  • ~215 pages, ~2.8 MB, grouped by URL section: components/ (104), patterns/ (74), foundation/ (19), get-started/ (18). Every page has source_url frontmatter for precise citation.
  • Includes scripts/refresh.py (~170 LOC, only httpx + pyyaml) so maintainers can regenerate on upstream changes.

Why

Agents frequently need accurate Cloudscape component props, accessibility rules, and design-pattern guidance when building AWS-console-style UIs. Grounding responses in the authoritative docs markedly improves output quality vs. relying on training-data recall.

Layout

skills/cloudscape-design-system/
├── SKILL.md                       # frontmatter + agent usage instructions
├── README.md                      # human install / refresh docs
├── metadata.json                  # version + references
├── LICENSE                        # MIT (skill wrapper)
├── NOTICE                         # AWS attribution for excerpted content
├── references/
│   ├── index.md                   # generated TOC
│   ├── components/*.md            # 104 files
│   ├── patterns/*.md              # 74 files
│   ├── foundation/*.md            # 19 files
│   └── get-started/*.md           # 18 files
└── scripts/
    ├── refresh.py                 # re-ingest from llms.txt
    └── requirements.txt

Test plan

  • Symlink into ~/.claude/skills/ and verify the skill auto-activates on Cloudscape-related prompts.
  • Open references/index.md and navigate to a component (e.g. components/table.md), confirm frontmatter source_url points at cloudscape.design.
  • Run python scripts/refresh.py on a fresh checkout and confirm references/ is reproduced byte-for-byte (modulo scraped_at timestamps).

Attribution

Content under references/ is excerpted from the public, AWS-maintained Cloudscape docs; see NOTICE in the skill folder. The skill wrapper is MIT.

🤖 Generated with Claude Code

Bundles the full AWS Cloudscape Design System documentation (~215 pages,
~2.8MB) as markdown references, ingested from cloudscape.design's
own llms.txt index. Use when building, reviewing, or refactoring UIs
that follow Cloudscape conventions.

Layout:
- SKILL.md: frontmatter + agent usage instructions
- references/: scraped markdown per page (components/, patterns/,
  foundation/, get-started/), grouped by URL section, with
  source_url frontmatter for precise citation
- references/index.md: generated TOC
- scripts/refresh.py: httpx-based re-ingester (~170 LOC; no headless
  browser needed — cloudscape serves */index.html.md directly)

Co-Authored-By: Claude Opus 4 (1M context) <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 20, 2026

@r33drichards is attempting to deploy a commit to the Vercel Team on Vercel.

A member of the Team first needs to authorize it.

@socket-security
Copy link
Copy Markdown

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff Package Supply Chain
Security
Vulnerability Quality Maintenance License
Addedpypi/​pyyaml@​6.0.3100100100100100
Addedpypi/​httpx@​0.28.1100100100100100

View full report

- `patterns/` — one file per design pattern (general, form, table, flashbar, split-panel, wizard, etc.).
- `foundation/` — visual foundation (typography, color, iconography, layout).
- `get-started/` — developer and designer onboarding, including testing, CSP, i18n, state management, responsive development.
- `guidelines/` — design principles and writing guidelines.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

SKILL.md and README.md document references/guidelines/ and references/examples/ directories that don't exist, misleading agents into looking for non-existent content.

Fix on Vercel

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant