recursica-skill-layers

Applies Recursica layer rules for declaring token-scoped surfaces in application layouts.

1|Updated May 29, 2026
One-click install
npx skills add https://github.com/borderux/recursica-knowledge --skill recursica-skill-layers-borderux
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: recursica-skill-layers
Source: https://github.com/borderux/recursica-knowledge/tree/main/skills/design-rules/recursica-skill-layers
Command: npx skills add https://github.com/borderux/recursica-knowledge --skill recursica-skill-layers-borderux

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Deciding which regions of an application shell need their own surface is error-prone: agents re-declare layer 0, nest a layer per div, or hand-paint backgrounds that break re-theming. This Skill encodes the Recursica layer house rules so every region lands on the correct level 0-3 with theme-owned styling. ## Core Features & Use Cases - Layer declaration rules: Layer 0 declared exactly once on the root element via data-recursica-layer, with containment as the only reason to raise a region to layer 1. - Depth budget enforcement: Levels 0 and 1 are ordinary, level 2 needs a stated reason, level 3 signals a structural problem, and no fourth level exists. - Token contract guidance: All surface, border, radius, padding, and emphasis values come from Forge theme tokens; nothing is hardcoded or hand-painted. - Use Case: When building an application shell, use this Skill to decide whether the nav or the main content (not both) should be raised to layer 1, and verify the result against the pre-flight checklist. ## Quick Start Ask the agent to review your application shell layout and decide which regions need their own Recursica layer using the layer house rules.

Frequently Asked Questions about recursica-skill-layers

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I declare a Recursica layer in my application?▼

Declare a layer with the data-recursica-layer attribute set to 0, 1, 2, or 3, alongside data-recursica-theme for light or dark. Layer 0 goes on the root element exactly once; deeper layers are declared only where a region needs containment.

When should a region move from layer 0 to layer 1?▼

A region leaves layer 0 only when it needs containment as its own visible surface. Typically either the navigation or the main content is raised to layer 1, never both, and the choice stays consistent across every page.

Can I set background color or padding on a Recursica layer?▼

No. All layer properties including surface, border, radius, padding, and shadow are authored in the Forge theme and consumed as tokens. Setting them manually overrides the theme and breaks re-theming and dark mode.

What is the difference between a Recursica layer and a card?▼

A layer is a token-scoped surface that everything sits on; a card is a component for a small set of repeating peer objects. Cards are placed on layers, and a layer never substitutes for a card or vice versa.

Why is using layer 3 or deeper nesting discouraged?▼

The depth budget treats layer 2 as rare and layer 3 as evidence the structure is wrong. Wanting a fourth level means the nesting is too deep and the layout should be restructured rather than stacked deeper.