TheGoat395/Codex-Skills / skills/modern-site-engineering
modern-site-engineering
VerifiedIntegrate systems after frontend direction.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.4 KB |
| agents/openai.yaml | config | 292 B |
| references/stack-recipes.md | markdown | 2.3 KB |
SKILL.md
View on GitHub---
name: modern-site-engineering
description: "Integrate systems after frontend direction."
---
# Modern Site Engineering
## Operating Mode
Inspect relevant structure, framework, entry files, styling and interaction systems, and available build commands. Proceed within existing authorization and explain material choices.
## Selected stack
Retain the selected framework and existing package manager. For a new project with an unresolved choice, use `route-enterprise-web-stack` if installed. Otherwise, compare the actual rendering, interaction, hosting and maintenance requirements, and choose the smallest compatible stack. Select only dependencies required by the actual components. The roles below are optional capabilities, not an installation list.
## Dependency Roles
- Next.js: routing, metadata, optimized images/fonts, production build.
- TypeScript: stable component contracts.
- Tailwind: fast design-system implementation with custom tokens.
- CSS variables: brand colors, spacing, shadows, easing, radii, typography.
- Motion: React-native UI motion, enter/exit, hover/tap, layout transitions.
- GSAP: timeline-driven cinematic sequences, ScrollTrigger, pinned scenes, split text, advanced scroll choreography.
- Lenis: smooth scrolling when the design calls for cinematic scroll.
- Three.js/R3F/Drei: immersive product, material, shader, or spatial scenes.
- lucide-react: icons for controls and clear commands.
- shadcn/ui: accessible component source to customize, not a default visual identity.
- Playwright: visual and interaction verification.
## Build Workflow
1. Inspect project and commands.
2. Reuse the approved visual system; establish type, color, spacing, media and motion only when those decisions are in scope.
3. Build version 1 with real content structure.
4. Run the app locally when possible.
5. Inspect changed visual output in the browser at the requested supported sizes.
6. Correct observed spacing, type, hierarchy, interaction, motion or responsive defects on affected surfaces. Repeat checks after edits or unresolved findings, not by fixed cycle.
7. Run available lint/build/test commands.
8. Report files changed, commands run, and any errors honestly.
## Component Defaults
- Prefer section components with clear names: `Hero`, `FeaturedWork`, `Experience`, `Gallery`, `Offer`, `Journal`, `Contact`.
- Keep layout primitives minimal and reusable.
- Use responsive constraints: `clamp()`, `minmax()`, `aspect-ratio`, stable grid tracks.
- Avoid text overflow by designing for the longest realistic labels.
- Make buttons feel designed: icon placement, focus state, hover state, disabled state.
- Use semantic HTML and accessible labels.
- Respect `prefers-reduced-motion`.
## Motion Defaults
Use CSS transitions for tiny state changes. Use Motion for component/state animation. Use GSAP only when timeline control or scroll choreography is actually needed. Use Three/R3F only when visual concept benefits from spatial or material interaction.
Read `references/stack-recipes.md` when starting a new project or adding dependencies.
## Ownership
Coordinate integration once framework and direction are chosen. The optional architecture specialist is useful only for an unresolved decision; its absence does not block the local procedure above. A localized task goes directly to its implementation owner; this skill does not require a new site blueprint or full tool stack.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |