Skip to content

ilandahan/AID / skills/atomic-page-builder

atomic-page-builder

Verified

Build 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

ForbiddenRequired
Creating new atoms/molecules/organismsUse existing components only
Guessing layout valuesExtract from design spec
External UI libs (MUI, Chakra)Design system imports only
Hardcoded values (#333, 24px)CSS Modules + tokens
Rounding valuesExact design spec values

Skill Switching

SituationAction
Missing atom/molecule/organism-> atomic-design
Need new tokens-> atomic-design
Token value changed in design spec-> atomic-design (update first)
Composing from existingStay 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
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: 319kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall