Skip to content
Back to search

silk-design

A Claude Code skill for building web interfaces that move well. Motion, smooth scroll, and design tokens by default.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/bendrape1-byte--silk-design/badge.svg)](/listings/bendrape1-byte--silk-design)

HTML

<a href="/listings/bendrape1-byte--silk-design"><img src="/api/listings/bendrape1-byte--silk-design/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

git clone https://github.com/bendrape1-byte/silk-design ~/.claude/skills/silk-design

Then ask your coding agent to build a website using the /silk-design skill and give it additional information such as: - Who you are (who this website is for) - What the use case of the website is - Add any additional information, photos or videos for it to use

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 97 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: silk-design
  3. description: >-
  4. Build websites and web UI with smooth, polished, high-end motion by default —
  5. the buttery feel of premium sites, not static slop. Use when building or
  6. restyling any website, landing page, hero, marketing page, portfolio, or web
  7. UI; when adding scroll animations, reveals, parallax, marquees, hover effects,
  8. page transitions, smooth scrolling, or micro-interactions; or when a page feels
  9. flat, generic, or unrefined and needs to feel alive. A capability catalog of
  10. proven motion + smoothness + design-token techniques (Lenis, Framer Motion,
  11. GSAP, Tailwind v4) for interfaces that feel crafted rather than assembled.
  12. ---
  13. # silk — your web-craft toolbox
  14. This is a reminder of what you can do. Like an artist who knows their tools: when you build
  15. for the web, you are not limited to static sections and default scrollbars. You have a full
  16. palette of motion and smoothness that reads as "expensive." **Reach for it by default.**
  17. The rule: **never ship a static page.** A smooth-scroll root + a reveal-on-scroll + one
  18. signature effect is ~15 lines and turns generic output into something that feels crafted.
  19. The trick behind these sites isn't exotic code — it's a *small, consistent* set of levers
  20. applied everywhere. Consistency is what reads as clean.
  21. ## Stack this assumes
  22. React + Vite + **Tailwind v4** + **`motion`** (Framer Motion, `motion/react`) + **GSAP**
  23. (`gsap` + `@gsap/react`; plugins used: ScrollTrigger, Draggable, DrawSVGPlugin — all free) +
  24. **Lenis** (smooth scroll). Each technique below names its principle so it transfers to other
  25. stacks. `cls()`/`cn()` helpers → `assets/utils.ts`.
  26. ## The non-negotiable foundation (apply on EVERY build)
  27. This is the baseline that makes everything feel smooth. Four things, always:
  28. 1. **Lenis smooth scroll at the root.** Wrap the app once. Do **not** use CSS `scroll-behavior`.
  29. ```tsx
  30. import { ReactLenis } from 'lenis/react'
  31. <ReactLenis root>{app}</ReactLenis>
  32. ```
  33. Anchor links scroll via `useLenis().scrollTo(el)` — see `assets/useButtonClick.ts`.
  34. 2. **Kill scroll bounce + thin the scrollbar** in global CSS:
  35. ```css
  36. html, body { overscroll-behavior: none; }
  37. * { scrollbar-width: thin; scrollbar-color: rgb(0 0 0 / 0.3) transparent; }
  38. ```
  39. 3. **Token architecture** — ~9 CSS custom properties on `:root`, exposed to Tailwind via
  40. `@theme inline`, with ONE `--radius` driving the whole radius scale. Full recipe +
  41. verbatim example in `assets/foundation.css` and `references/design-system.md`.
  42. 4. **Fluid typography** — every font size is a `clamp(min, vw, max)`, not a fixed px. This
  43. is why the type scales smoothly across viewports. Scale in `assets/foundation.css`.
  44. **The one reveal config, used everywhere** (this consistency is the "clean" feel):
  45. ```tsx
  46. initial="hidden" whileInView="visible"
  47. viewport={{ once: true, margin: "-20%" }}
  48. transition={{ duration: 0.6, ease: "easeOut" }} // text: staggerChildren 0.04, per-word 0.6
  49. ```
  50. Drop-in components: `assets/ScrollReveal.tsx` (blocks), `assets/TextAnimation.tsx` (word-stagger headings).
  51. ## The toolbox map — reach for these
  52. Each points to a reference file (loaded only when you need it) and/or a drop-in `assets/` file.
  53. - **Entrance reveals** — word-stagger headings, slide-up / fade-blur blocks. → `references/effects.md`, `assets/{TextAnimation,ScrollReveal}.tsx`
  54. - **Scroll-driven effects** — parallax (`useScroll`/`useTransform`), hero exit-parallax, pinned + scrubbed sections, scroll-scrubbed video, tilt-flatten billboard, stack-to-grid (FLIP), reading word-fill, footer reveal-from-behind. → `references/effects.md`, `assets/{HeroVideoScroll,AboutTextFill,FooterBrandReveal}.tsx`
  55. - **Cursor & pointer** — GSAP cursor image-trail, magnetic buttons (spring `150/15`), pointer-tracked border glow, cursor-mask character pattern, draggable stickers. → `references/effects.md`, `assets/{AboutCursorTrail,ButtonMagnetic,BorderGlow,HoverPattern}.tsx`
  56. - **Hover micro-interactions** — 12 button styles (expand, elastic, flip, slide, bounce…), the grid-fr expand-to-auto trick, image reveal cards, 3D flip cards, staged hover scenes. → `references/effects.md`
  57. - **Marquees & carousels** — infinite CSS scroll with edge-mask fade, deck carousel, focus loop, filter-swap. → `references/effects.md`, `assets/{animations,masks}.css`
  58. - **Navigation & page transitions** — fullscreen curtain menu, DrawSVG swirl page transition, brand panel loader. → `references/effects.md`, `assets/{NavbarFullscreen,PageTransitionSwirl}.tsx`
  59. - **Animated backgrounds** — 13 of them: aurora, light rays, gradient bars, noise, grids, floating gradients. → `references/backgrounds.md`, `assets/{AuroraBackground,NoiseBackground,GradientBarsBackground}.tsx`
  60. - **The design system** — token architecture, fluid type, `--radius` scale, font pairings + the accent-font slot, full-width wordmarks (`assets/AutoFillText.tsx`), and **10 instant "style" skins** (glass, minimal, neon, elegant, bold…) = swap only card CSS + button CSS + radius + font. → `references/design-system.md`
  61. - **Page composition** — section archetypes (hero/features/testimonial/pricing/faq/CTA), the canonical section-header pattern, **bento live-widget menu**, navbar archetypes, responsive-padding scale, how to assemble a page. → `references/composition.md`
  62. ## Reference a worked example — `/silk-design <name>`
  63. The catalog carries **23 worked reference compositions** built from this exact toolbox. When the
  64. user names one (`/silk-design Reference15`, `/silk-design Reference1`, or "build it
  65. like the coffee one"), pull it from `references/templates.md` — palette, font, section rhythm, and the signature
  66. effects it used. A number resolves directly; a described mood resolves against each row's vibe line.
  67. **A referenced composition is a mood-board + wireframe, not a source file:** take its **skin**
  68. (palette, font, radius, card/button style, effects) and its **skeleton** (section rhythm,
  69. loosely) — **never its flesh** (copy, images, brand, or a 1:1 layout). The new site has its own
  70. subject; build for that. The non-negotiable foundation above still applies underneath.
  71. ## Using the `assets/` files
  72. They are **drop-in reference implementations** — copy and adapt. Simple
  73. primitives (`ScrollReveal`, `TextAnimation`, `ButtonMagnetic`, `AutoFillText`, `BorderGlow`,
  74. `HoverPattern`, `PageTransitionSwirl`, `useButtonClick`, `utils`, the `.css`) drop in cleanly.
  75. The section showpieces (`AboutCursorTrail`, `HeroVideoScroll`, `AboutTextFill`,
  76. `FooterBrandReveal`, `NavbarFullscreen`) are self-contained and take an `actions` slot — pass your
  77. own buttons in as children rather than wiring a component import. Backgrounds need the `--color-*`
  78. tokens from `foundation.css`. (`FooterBrandReveal` needs `AutoFillText` — both are here.)
  79. ## How this fits with your other skills
  80. This is a **capability layer, not a builder.** For *aesthetic direction* (palette, layout,
  81. personality) reach for **`taste-skill`** (landing/marketing/portfolio) or **`ui-ux-pro-max`**
  82. (apps/dashboards/data UI). `silk` is what you apply on top — or to any hand-built page — to
  83. make it *move* and *feel* right. The three compose: builder picks the look, silk makes it silk.
README.md · README · 78 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # silk-design
  2. A Claude Code skill for building web interfaces that move well.
  3. Most generated pages come out static. Default scrollbars, sections that just appear,
  4. hover states that do nothing. This is a catalog of motion and design-token techniques,
  5. and it tells the agent to reach for them by default rather than only when asked.
  6. ## Results
  7. Ten sites built with this skill, they are all in German tho:
  8. [Car-Shop](https://turbo-mottorss.bendrape1.workers.dev/)
  9. [Bakery](https://kronberger-website.bendrape1.workers.dev/)
  10. [Car-Shop](https://a-z-autoservice.bendrape1.workers.dev/)
  11. [Physio-Therapy](https://physio-plus.bendrape1.workers.dev/)
  12. [Cafe](https://a-z-autoservice.bendrape1.workers.dev/)
  13. [Physio-Therapy](https://orthotrain-frankfurt.bendrape1.workers.dev/)
  14. [Hair-Salon](https://the-hair-house.bendrape1.workers.dev/)
  15. [Cafe](https://mina-cafe.com/)
  16. [Cafe](https://cafe-opitz.bendrape1.workers.dev/)
  17. [Cafe](https://uni-cafe.bendrape1.workers.dev/)
  18. ## Install
  19. ```
  20. git clone https://github.com/bendrape1-byte/silk-design ~/.claude/skills/silk-design
  21. ```
  22. Then ask your coding agent to build a website using the /silk-design skill and give it additional information such as:
  23. - Who you are (who this website is for)
  24. - What the use case of the website is
  25. - Add any additional information, photos or videos for it to use
  26. ## What's in it
  27. A foundation to apply on every build: Lenis smooth scroll at the root, scroll bounce
  28. killed, a nine-token color system exposed to Tailwind, and fluid `clamp()` type. Four
  29. things, about fifteen lines, and they do most of the work.
  30. Then an effects catalog with the actual numbers in it. Spring constants, easing curves,
  31. stagger intervals, scroll offsets. Word-stagger headings, parallax, pinned and scrubbed
  32. sections, scroll-scrubbed video, cursor image-trails, magnetic buttons, curtain menus,
  33. marquees. The five larger components in `assets/` are written out in full; the rest are
  34. recipes precise enough to type from, which keeps the files small enough to load only
  35. when they are needed.
  36. Thirteen animated backgrounds. Three ship as components.
  37. A design system built on one `--radius` knob that drives the whole scale, with font
  38. pairings and ten style skins you switch by swapping three CSS blocks.
  39. Twenty-three reference compositions, each with a palette, a type choice, a section rhythm
  40. and an effect set. They are starting points, not templates to fill in.
  41. ## Stack
  42. React + Vite, Tailwind v4, `motion` (Framer Motion), GSAP with ScrollTrigger, Draggable
  43. and DrawSVG (all free plugins), and Lenis. Each technique names the principle behind it, so the
  44. snippets are portable even when the stack is not.
  45. ## Notes
  46. Written from scratch. The components in `assets/` are original implementations of publicly
  47. documented techniques (GSAP ScrollTrigger, CSS clip-path, SVG filters) and contain no
  48. third-party code, assets, or branding. The palettes and type values under `templates/` are
  49. plain CSS custom properties.
  50. MIT licensed. See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.