How do I install the Headlessui Foundation skill?

Run npx skillmds@latest add ryan-brosas/headlessui-foundation in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Headlessui Foundation safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Headlessui Foundation?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Headlessui Foundation free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Headlessui Foundation?

ryan-brosas (@ryan-brosas) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Headlessui Foundation by ryan-brosas

Name: Headlessui Foundation
Author: ryan-brosas

Headlessui Foundation

Use when porting headless UI primitives: focus trap/tab-lock, focusable enumeration, outside-click, top-layer stacking, inert siblings, scroll lock + iOS touch locking, portal nesting, listbox state machine, form-field hoisting.

ryan-brosas 17b9f93 28 files · 102.5 KB Updated Sep 17, 2026

File contents

Headless UI: headless primitive contracts

Foundation contract

This is a cold, source-specific foundation, not an operational procedure. It is historical, revision-pinned evidence rather than timeless guidance. Current project source, tests, requirements, and runtime behavior outrank this projection and decide what ships.

Provenance and revision

Source record: headlessui; portable upstream identity, license, coverage caveats, and retrieval history are preserved in the index.
Recorded revision: main@eea57cf46fd6767ed1059012f7073b88eb159fba.
Full provenance, coverage caveats, boundaries, and preserved evidence: references/index.md.

Topic map

Representative topics: Focus movement; Focus trap; Layering; Outside interaction; Scroll lock; Dialog orchestration; State plumbing; Listbox behaviors.
Scope and retrieval questions: references/index.md#use-this-for.
Complete capsule chooser: references/index.md#load-the-matching-source-dump.
Detailed grouped map: references/index.md#capsule-map.
Source limitations and portability boundaries: references/index.md#boundaries.

Retrieval

Open the index, choose one capsule matching the active question, and load only that capsule. Revalidate its cited source and revision before relying on it. Do not bulk-load the inventory, treat historical claims as current truth, or apply this foundation as a procedure.

Frequently asked questions