Skill Folder Structure
Understand how ARCTIS composes one Theme, multiple Add-ons, and multiple Rules into a project-local agent skill.
Overview
ARCTIS installs skills per project, not globally. Every project gets its own arctis skill package. This keeps design direction, interaction behavior, and visual rules isolated per codebase.
Instead of installing each Theme, Add-on, and Rule as a separate skill, ARCTIS composes them into one unified package. Your agent loads a single SKILL.md that contains everything.
Agent Output Paths
The same composed skill package is written to each agent's skills directory:
Full Folder Structure
my-project/
├── arctis.config.json
├── .claude/
│ └── skills/
│ └── arctis/
│ ├── SKILL.md
│ ├── arctis.config.json
│ ├── references/
│ │ ├── theme.md
│ │ ├── addons/
│ │ │ ├── gsap-scroll-reveal.md
│ │ │ └── custom-cursor.md
│ │ └── rules/
│ │ ├── zero-radius.md
│ │ ├── hairline-borders.md
│ │ └── restrained-accent.md
│ ├── snippets/
│ └── assets/
├── .opencode/
│ └── skills/
│ └── arctis/
│ ├── ... (same structure)
└── .agents/
└── skills/
└── arctis/
├── ... (same structure)arctis.config.json
Root config declaring the selected Theme, Add-ons, Rules, and target Agents for this project.
SKILL.md
The merged skill document. All design rules, component patterns, typography, colors, and workflow conventions from every selected skill composed into one file.
references/theme.md
The Theme's full design specification — layout rules, spacing conventions, visual principles, and color palette. One file per project.
references/addons/
Each Add-on gets its own reference file inside this directory. Contains interaction patterns, animation rules, and library-specific conventions.
references/rules/
Each Rule gets its own reference file. Contains global constraints like border-radius enforcement, spacing grids, and accent color limits.
snippets/
Reusable code snippets from all selected skills. Your agent can compose these into larger components.
assets/
Static assets bundled with skills — placeholder images, font files, or design resources referenced by examples.