Communitygithub.com

brainzcode/premium-landing

建立完整的優質著陸頁面,可依據參考截圖/網址複製或根據書面簡報設計,支援 HTML、React、Next.js 或 Astro。

premium-landing 是什麼?

這是一個專為開發者與 AI 代理設計的技能,用於打造高品質的著陸頁面。它支援兩種模式:一是「參考模式」,當使用者提供截圖、PDF、網址或要求複製時,以精確還原為目標;二是「簡報模式」,當使用者僅用文字描述商業、受眾或氛圍時,由 AI 自行決定佈局。技能涵蓋設計 Token、區段模式、以及那些會悄悄破壞網格與跑馬燈的佈局陷阱。平台方面,支援 HTML、React、Next.js 與 Astro,並提供從 `templates/<stack>/` 起始的範本。建構流程依序為:設計 Token、英雄區塊、各區段、頁尾,最後必須執行驗證。驗證工具 `scripts/verify.sh` 可掃描 320px 到 1920px 的溢位,並針對真實裝置的視窗寬度拍照確認。技能強調「高品質」並非指漸層與玻璃效果,而是流暢的響應式字體、僅使用 transform 與 opacity 的動畫、以軸線為基礎的間距,以及經過設計而非從桌機版繼承的行動版佈局。所有規則皆可檢查,確保最終產出無任何意外。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/brainzcode/premium-landing/tree/HEAD/plugins/premium-landing/skills/landing-page

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

優質著陸頁面

一個著陸頁面完成的定義是通過三項檢查:與參考或簡報相符、在 320 到 1920 之間的所有寬度保持一致、以及沒有任何元素是隨意的。大部分的工作在第三項。

先決定模式

參考模式 — 使用者提供了截圖、PDF、網址,或要求「複製這個」。精準是目標,「差不多」就是失敗。在撰寫任何 CSS 之前,先以數值衡量參考。載入 reference-replication。

簡報模式 — 使用者描述了商業、受眾或感受,沒有任何圖片。你可以自行決定佈局;內部規則與區段庫設定了品質基礎。

如果兩者都存在,參考優先涵蓋其範圍,簡報則填補缺口。如果兩者都不明確,請提問 — 為錯誤模式建立的著陸頁面只是浪費時間。

只問會改變建構的問題

不要反覆盤問。真正會改變輸出的只有四件事:

  1. 技術棧 — HTML / React / Next / Astro。從 templates/<stack>/ 建立起始結構。
  2. 品牌基礎 — 名稱,以及色板或「從參考中擷取」。
  3. 地區設定 — 影響貨幣、日期格式、英式與美式拼寫。提問一次,保持一致性。
  4. 區段 — 僅當參考或明確的頁面類型無法暗示它們時才需要。

其他所有事項都有合理的預設值。使用預設值並說明你的假設。

建構順序

不按照順序工作會導致重工,因為英雄區塊的高度限制了折頁以上的所有內容,而設計 Token 則限制了每個區段。

  1. Token — 表面、文字、線條、強調色、圓角、緩動函數、一個流暢的字體階層。 references/design-system.md。
  2. 英雄區塊 — 每次建構中最常修正的元素。100svh,以 vh 為單位的節奏。 references/house-rules.md。
  3. 區段,按照參考的順序。references/sections.md。 任何需要照片的插槽:立即取得來源,不要留下灰色方框 — ../stock-imagery/SKILL.md。
  4. 頁尾,接著是下方的完成序列。
  5. 驗證。 非選項 — 請見下方。

陷阱

在撰寫網格、跑馬燈、SVG 圖示或滿版影像程式碼之前,請閱讀 references/traps.md。其中有六個失敗是無聲的:有效的 CSS,沒有錯誤,但在其他地方產生了錯誤的佈局。第一次遇到時耗費數小時,而有了參考文件後只需幾分鐘。

驗證是建構的一部分

未經實際寬度截圖的著陸頁面尚未完成。執行隨附的測試工具:

scripts/verify.sh <url> --sweep          # 掃描 320→1920 溢位 + 英雄區塊適應性
scripts/verify.sh <url> --shot 390x844   # 單一視窗尺寸

它處理了 macOS 500px 視窗寬度限制的問題,該限制會悄悄偽造所有行動裝置截圖。詳細資訊及手動備份方案:references/verification.md。

必須通過三項檢查:

  • 無水平溢位 在 320 到 1920 之間的任何寬度。
  • 英雄區塊符合一畫面 在 390×844、414×896 和 1600×900 下,或者刻意增長。
  • 減少動畫 仍能呈現所有區段 — 沒有任何元素停留在動畫中途。

完成序列

每個真實建構都必須執行。這是「完成」的定義,而非「可有可無」:

  1. lenis-smooth-scroll
  2. premium-mobile-menu
  3. social-share-favicons
  4. build-credit
  5. README.md 描述該頁面 — 其區段、Token、斷點、部署步驟 — 而非關於製作它的工具
  6. .gitignore;提交訊息不包含 AI 共同作者行,除非要求
  7. 部署注意事項(若任何路徑以 _ 開頭,GitHub Pages 需要 .nojekyll)

「優質」在此的真正意義

它不是指漸層與玻璃效果。而是:能夠流暢縮放而非在斷點處跳動的字體;僅作用於 transform 和 opacity 的動畫;根據所在軸線測量的間距;無死區;以及經過設計而非從桌機版繼承的行動版佈局。以上每一項都是可檢查的,這就是為什麼它們是標準。

參考資料

檔案何時閱讀
references/house-rules.md總是 — 每次建構都會重複的修正
references/traps.md在網格、跑馬燈、SVG 圖示、滿版影像之前
references/design-system.md設定 Token 與字體階層
references/sections.md建構英雄區塊、跑馬燈、手風琴、卡片軌道、頁尾
references/verification.md驗證,或截圖看起來有問題時
../reference-replication/SKILL.md提供了參考圖片或網址
../stock-imagery/SKILL.md頁面需要照片但未提供資源

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

brainzcode/premium-landing

Add a studio or agency build credit to a website footer — "Site by <Studio>" linking to the studio's site. Use when finishing or shipping a site, adding a footer, or when asked for an agency credit, build credit, designed-by line, or attribution. Covers wording, placement opposite the client's copyright, markup for each stack, styling from the host site's tokens, and the sitewide-footer-link SEO footprint when the same credit runs across many client sites.

brainzcode/premium-landing

Add Lenis smooth scrolling to a site correctly — setup, anchor offsets for sticky headers, scroll locking for modals and menus, reduced-motion handling. Use when asked for smooth scroll, Lenis, momentum/eased scrolling, or when smooth scroll broke a sticky header, a modal lock, or anchor links. Includes the sticky-position trap that only appears at non-zero scroll.

brainzcode/premium-landing

Build true Apple-style liquid glass in the browser — real refraction via SVG displacement maps, chromatic dispersion, specular edges. Use when asked for liquid glass, glassmorphism, frosted/glass cards, glass navbars, or when a blur-based "glass" effect looks flat. Includes the performance trap that makes backdrop-filter stutter on scroll and the contrast trap that makes text unreadable on glass.

brainzcode/premium-landing

Build a premium mobile nav — a hamburger button that morphs into a close X, a full-screen overlay panel with staggered link reveal, scroll lock, focus trap, and reduced-motion handling. Use when asked for a mobile menu, hamburger/burger button, nav drawer, off-canvas menu, or when a menu loses scroll position, still scrolls behind on iOS, leaks Tab focus to the page underneath, or the close button stops responding. Includes the z-index trap that swallows the close button and the iOS rubber-band trap.

brainzcode/premium-landing

Rebuild a design accurately from a supplied reference — a screenshot, PDF page, mockup or live URL — by measuring it numerically instead of eyeballing it. Use when asked to replicate, clone, match or rebuild a design "exactly", "1 to 1" or "with no mistakes", or when a build drifts from its reference. Covers extracting the true content box from a padded screenshot, deriving element positions as percentages, solving object-fit framing, and knowing when a reference cannot be matched.

brainzcode/premium-landing

Ship link previews and favicons that actually work - Open Graph and Twitter card tags, a correctly framed 1200x630 share image, and a full favicon set (SVG, ICO, apple-touch, maskable manifest icons). Use when asked for social sharing, OG image, open graph, twitter card, link preview, share image, favicon, app icon, apple touch icon, or web manifest. Also use when a shared link previews blank, shows the wrong image, or a favicon will not appear. Includes the absolute-URL trap that silently blanks every preview and the font trap that breaks SVG favicons on other machines.

brainzcode/premium-landing

Source free, licence-clear photography for a site from Unsplash — searching by mood rather than noun, sizing and cropping for the slot, honouring the API's hotlink and download-tracking requirements, and writing real alt text. Use when a page needs a hero image, section photography, avatars or card art and none was supplied; when placeholder greys need replacing with real imagery; or when asked to find, pick or swap photos for a design.

相關技能