diff --git a/.claude/skills/build-state-semantics/SKILL.md b/.claude/skills/build-state-semantics/SKILL.md
new file mode 100644
index 0000000..34ad962
--- /dev/null
+++ b/.claude/skills/build-state-semantics/SKILL.md
@@ -0,0 +1,7 @@
+---
+name: Build State Semantics
+description: How the core semantics of databuild's build state works; what its conceptual boundaries, responsibilities, and interfaces are; the mental model and rationale for how databuild is architected.
+version: 1.0.0
+---
+
+