# Omarchy Foundation

> Use when consulting pinned Omarchy evidence for staged theme activation and independent palette-reader failure boundaries.

- Skill: `ryan-brosas/omarchy-foundation` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add ryan-brosas/omarchy-foundation`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ryan-brosas/omarchy-foundation/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ryan-brosas (https://skillmd.com/u/ryan-brosas)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ryan-brosas/omarchy-foundation

---

# Omarchy foundation

Historical evidence from [basecamp/omarchy](https://github.com/basecamp/omarchy) at
`a9eaf7978e33a6832630c51f1bb87f97dbf5fe36`. License: MIT.
Local convenience checkout: `<local-checkouts>/omarchy`.

Current project source, tests, requirements, and runtime behavior outrank this
projection. This is source evidence, not a procedure or an exhaustive repository study.

Open [the index](references/index.md), then load one matching capsule:

- [Staged activation and independent readers](references/staged-theme-reader-boundary.md).
- [Installed-theme symlink and trust boundaries](references/installed-theme-staging.md).
- [Legacy palette grammar and fallback contract](references/legacy-palette-contract.md).

Revalidate the pinned implementation and direct tests before reuse. These three
capsules cover bounded seams, not exhaustive theme safety or compatibility.