Layout Framework
Designlayout-frameworkLayout Framework is an Agent Skill for design published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use for any frontend layout or form arrangement work in PierceDesk. Covers Box/Container/Grid/Stack/Paper usage, responsive sizing, spacing rules, and how to align pages with the app’s layout framework. Trigger when asked to fix layout issues, align fields, create grids, or ensure design-system consistency.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/data/layout-framework/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/layout-framework, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Layout Framework Skill
Core rules (always follow)
- Use MUI v7 Grid with the
sizeprop (notxs/mdprops). - Prefer
Grid containerfor column layouts; useStackfor simple vertical rhythm. - Avoid hardcoded widths/heights; use theme spacing and responsive values (
{ xs, md }). - Wrap major sections in
Paper background={1}withp: { xs: 3, md: 5 }andborderRadius: 6unless the surrounding layout already provides a card. - Keep inputs aligned in a consistent grid (e.g., 12 / 6 / 3 / 3, 8 / 4, 6 / 6). No uneven, ad-hoc sizing.
- Use
Containeronly for page-level width constraints. Inside cards, useGridfor structure.
When to read references
- For exact examples of Box/Container/Grid/Stack usage, read:
references/component-docs-map.mdreferences/layout-patterns.md
Default layout patterns
- Two-column forms:
Grid container spacing={{ xs: 2, md: 3 }}withsize={{ xs: 12, md: 6 }}. - Primary + secondary field:
size={{ xs: 12, md: 8 }}+size={{ xs: 12, md: 4 }}. - Address block: street
12, city6, state3, zip3. - Section cards: each form block inside
Paper background={1}with internalGridorStack.
Process checklist
- Identify the page sections and their cards.
- Decide row/column structure using
Grid(avoid ad-hocsxflex sizing). - Normalize spacing with
spacing={{ xs: 2, md: 3 }}andp: { xs: 3, md: 5 }. - Verify that labels/inputs align across rows and breakpoints.
- Remove any hardcoded widths or manual flex ratios unless they map to a grid size.