ilandahan/AID / skills/atomic-page-builder
atomic-page-builder
VerifiedBuild pages using ONLY existing atomic-design components. REQUIRES atomic-design skill. Use for composing pages, creating views/features from existing components.
Atomic Page Builder
Critical rule: design spec is source of truth. NEVER guess layout. ALWAYS extract EXACT page specs from design spec first.
Rules
| Forbidden | Required |
|---|---|
| Creating new atoms/molecules/organisms | Use existing components only |
| Guessing layout values | Extract from design spec |
| External UI libs (MUI, Chakra) | Design system imports only |
| Hardcoded values (#333, 24px) | CSS Modules + tokens |
| Rounding values | Exact design spec values |
Skill Switching
| Situation | Action |
|---|---|
| Missing atom/molecule/organism | -> atomic-design |
| Need new tokens | -> atomic-design |
| Token value changed in design spec | -> atomic-design (update first) |
| Composing from existing | Stay here |
Workflow
Step 0: EXTRACT FROM design spec (mandatory)
- Read the approved local specification, exported assets and token files
- Extract: grid, gaps, padding, margins
- Identify components used
- Note page-specific overrides
- Compare with tokens: check spacing tokens match design spec; if different -> UPDATE tokens (design spec wins)
Step 1: INVENTORY (scan existing components)
Step 2: GAP ANALYSIS (map requirements to components)
Step 3: BUILD OR STOP
- All exist? -> Compose page, matching design spec layout 1:1, NO "improvements"
- Missing? -> STOP, report gaps, switch to atomic-design
Page Composition
/**
* Dashboard Page
* @design-source ./design-spec.md
* @extracted 2024-01-15
* Layout specs from design spec - DO NOT MODIFY
*/
import { DashboardLayout } from '@/templates/DashboardLayout';
import { Card } from '@/molecules/Card';
import { DataTable } from '@/organisms/DataTable';
import styles from './Dashboard.module.css';
export const Dashboard = () => (
<DashboardLayout>
<div className={styles.statsGrid}>
<Card title="Revenue">$12,450</Card>
</div>
<DataTable columns={columns} data={data} />
</DashboardLayout>
);
/* Dashboard.module.css - ALL values from design spec */
.statsGrid {
display: grid;
grid-template-columns: repeat(3, 1fr); /* From design spec */
gap: var(--spacing-6); /* From design spec */
}
@media (max-width: 768px) {
.statsGrid {
grid-template-columns: 1fr; /* design spec mobile */
gap: var(--spacing-4);
}
}
Import Pattern
import { Button } from '@/design-system/atoms/Button';
import { Card } from '@/design-system/molecules/Card';
import { Header } from '@/design-system/organisms/Header';
import { DashboardLayout } from '@/design-system/templates/DashboardLayout';
Details
- design spec extraction steps: references/component-inventory-template.md
- Component inventory format: references/component-inventory-template.md
- Layout/composition patterns: references/page-composition-patterns.md
Output Checklist
- Page specs extracted from design spec
- Layout values match design spec exactly
- Responsive matches design spec
- Visual comparison 0% difference
- design spec link documented
- All imports from design system
- Zero hardcoded values
- Zero new components
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: 319k | 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: 196k | 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: 196k | 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: 196k | Updated | Claude CodeCodex | Verified | Install |