Brand website
Claude Code agent skills by Arova AI
npx -y skills add arova-ai/agent-skills --skill brand-websiteAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Build and maintain brand/corporate websites using the Astro + Tailwind CSS + React islands stack. Use this skill whenever the user wants to: create a new page for the website, modify existing page content or layout, update translations/locale content, add new sections or components to a page, change the design system tokens, or restructure the site navigation. Also trigger when the user mentions: 品牌網站, 官網, landing page, 新增頁面, 修改頁面, 網站內容, page content, website section, add a page, update the homepage, or any task involving the Astro brand website codebase.
SKILL.md
7.2 KB, ~1.6k tokens by cl100k_base, as published. Nobody here has run it
Brand Website Builder
This skill guides you through creating and maintaining brand/corporate websites built with Astro 5.x, Tailwind CSS v4, and React islands for interactivity. The architecture is designed for enterprise marketing sites that need static rendering, excellent SEO, bilingual content (zh-TW / en), and minimal client-side JavaScript.
When to use this skill
- Creating a new page
- Modifying existing page content or layout
- Adding sections or components to a page
- Updating translation/locale content
- Changing design system tokens (colors, typography, effects)
- Adding navigation items
Project architecture
src/
pages/[locale]/ ← Route pages (.astro), generates /zh-TW/... and /en/...
components/
layout/ ← Navbar, Footer, PageLayout, MobileMenu
sections/ ← Reusable page sections (Hero, CTA, TrustBadges)
ui/ ← Primitives (Button, Card, Badge, SectionTitle, Accordion)
visuals/ ← Diagrams and animated graphics (some are React .tsx)
i18n/
zh-TW.json ← Traditional Chinese content (default locale)
en.json ← English content (must mirror zh-TW structure)
utils.ts ← getTranslation(), getLocalePath(), locale types
layouts/
BaseLayout.astro ← HTML shell with <html lang>, fonts, meta, CSS
styles/
global.css ← Tailwind v4 @theme tokens, custom utilities
Core workflow
Modifying page content
Content lives in src/i18n/zh-TW.json and src/i18n/en.json, not in page files. To change text:
- Find the relevant key path in the JSON (e.g.,
home.hero.headline) - Update both locale files — the structure must stay in sync
- No page file changes needed unless the layout changes
Creating a new page
Follow this sequence — each step builds on the previous:
Step 1: Add content to locale files
Add a new top-level key in both src/i18n/zh-TW.json and src/i18n/en.json:
{
"meta": {
"newPage": { "title": "頁面標題", "description": "頁面描述" }
},
"newPage": {
"hero": { "headline": "...", "subtitle": "..." },
"sections": [ ... ],
"cta": { "headline": "...", "button": "..." }
}
}
Both files must have identical key structure. zh-TW values are in Traditional Chinese, en values in English.
Step 2: Create the page file
Create src/pages/[locale]/new-page.astro. Read references/page-template.md for the exact boilerplate. Every page follows this pattern:
---
import BaseLayout from '../../layouts/BaseLayout.astro';
import PageLayout from '../../components/layout/PageLayout.astro';
import { locales, getTranslation, getLocalePath } from '../../i18n/utils';
import type { Locale } from '../../i18n/utils';
export function getStaticPaths() {
return locales.map((locale) => ({ params: { locale } }));
}
const locale = Astro.params.locale as Locale;
const t = getTranslation(locale);
---
<BaseLayout title={t.meta.newPage.title} description={t.meta.newPage.description} locale={locale} currentPath="/new-page">
<PageLayout locale={locale} currentPath="/new-page">
<!-- sections here -->
</PageLayout>
</BaseLayout>
Key points:
getStaticPaths()generates both/zh-TW/new-pageand/en/new-pagecurrentPathmust match the URL path segment (used for language switcher and hreflang)- All visible text comes from
t(the translation object), never hardcoded
Step 3: Add navigation (if needed)
If the page should appear in the navbar:
- Add the label to
navin both locale files - Add the link to
src/components/layout/Navbar.astroin thenavLinksarray - Add the link to
src/components/layout/Footer.astroif appropriate
Step 4: Verify
Run npm run build and confirm the page appears in the output for both locales.
Adding a new section to an existing page
- Check
references/component-catalog.mdfor available components - If an existing component fits, import and use it
- If a new component is needed, create it in the appropriate directory:
components/sections/for full-width page sectionscomponents/ui/for small reusable primitivescomponents/visuals/for diagrams or animated graphics
- Add any new translatable text to both locale files
- Use
.astrofor static components,.tsx(React) only when client-side interactivity is required (animations with framer-motion, state like accordion open/close, mobile menu toggle)
React islands
Most components should be .astro (zero client JS). Use React .tsx only when the component needs:
- Client-side state (e.g., accordion open/close, mobile menu toggle)
- framer-motion animations that run on scroll or interaction
When using React islands in Astro pages, specify a client directive:
client:load— for immediately interactive components (mobile menu)client:visible— for components that animate on scroll (preferred for diagrams)
Design system quick reference
Read references/design-tokens.md for the full token list.
Colors: dark navy background (#0F172A), cyan primary (#06B6D4), purple accent (#8B5CF6), glass-card semi-transparent surfaces
Typography: Inter (primary) + Noto Sans TC (Chinese fallback)
Key CSS utilities defined in global.css:
.glass-card— semi-transparent card with backdrop blur and border.gradient-text— cyan-to-purple gradient text effect.text-glow-cyan/.text-glow-purple— subtle text shadow glow.glow-cyan/.glow-purple/.glow-amber/.glow-emerald— box shadow glow
Layout patterns:
- Max width:
max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 - Section spacing:
py-20orpy-24 - Dark panel sections:
bg-surface-panel border-y border-white/5 - Very dark sections:
bg-surface-dark
Verification checklist
After any change, verify:
- Build succeeds:
npm run build— check for errors - Both locales generated: confirm HTML files exist under both
dist/zh-TW/anddist/en/ - Locale sync: if content was added/changed, both JSON files have matching structure
- No hardcoded text: all visible text comes from locale files, not inline strings
- Links preserve locale: all
<a href>usegetLocalePath(locale, '/path')
Reference files
For detailed information, read these files from the references/ directory:
component-catalog.md— Full API docs for every available component (props, variants, usage examples)design-tokens.md— Complete color palette, typography, spacing, and custom CSS utilitiespage-template.md— Copy-paste starter template for new pages with all imports and boilerplate
Gives 0 of the 12 instructions most css styling skills give in ~1.6k tokens
Counted across 586 of the 596 authors here whose files we hold, read 2026-08-06
- avoid excessive centered layoutsin 55 of 586, across 12 files
- bundle code into single HTML filein 54 of 586, across 14 files
- Respect prefers-reduced-motion user settingsin 52 of 586, across 35 files
- avoid purple gradientsin 51 of 586, across 11 files
- avoid uniform rounded cornersin 51 of 586, across 11 files
- avoid Inter fontin 51 of 586, across 11 files
- edit generated files to develop artifactin 50 of 586, across 10 files
- animate only transform and opacity propertiesin 43 of 586
- Make touch targets at least 44x44 pixelsin 41 of 586, across 15 files
- Ensure minimum color contrast of 4.5:1in 39 of 586, across 10 files
- use tailwind cssin 39 of 586, across 24 files
- Use SVG icons instead of emojisin 38 of 586, across 11 files
Said here and by no other author read
- Update both locale files for any text change
- Keep JSON structures identical across both locales
- Create page files using the standard boilerplate
- Generate static paths for all supported locales
- Add new navigation links to navbar and footer
- Place new components in the appropriate directory
Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.