diff --git a/skills/fastapi-async-sqlalchemy-modernization/SKILL.md b/docs/skills/fastapi-async-sqlalchemy-modernization/SKILL.md
similarity index 100%
rename from skills/fastapi-async-sqlalchemy-modernization/SKILL.md
rename to docs/skills/fastapi-async-sqlalchemy-modernization/SKILL.md
diff --git a/skills/fastapi-async-sqlalchemy-modernization/references/engine.md b/docs/skills/fastapi-async-sqlalchemy-modernization/references/engine.md
similarity index 100%
rename from skills/fastapi-async-sqlalchemy-modernization/references/engine.md
rename to docs/skills/fastapi-async-sqlalchemy-modernization/references/engine.md
diff --git a/skills/fastapi-async-sqlalchemy-modernization/references/implicit_io.md b/docs/skills/fastapi-async-sqlalchemy-modernization/references/implicit_io.md
similarity index 100%
rename from skills/fastapi-async-sqlalchemy-modernization/references/implicit_io.md
rename to docs/skills/fastapi-async-sqlalchemy-modernization/references/implicit_io.md
diff --git a/skills/fastapi-async-sqlalchemy-modernization/references/index.md b/docs/skills/fastapi-async-sqlalchemy-modernization/references/index.md
similarity index 100%
rename from skills/fastapi-async-sqlalchemy-modernization/references/index.md
rename to docs/skills/fastapi-async-sqlalchemy-modernization/references/index.md
diff --git a/skills/fastapi-async-sqlalchemy-modernization/references/observability.md b/docs/skills/fastapi-async-sqlalchemy-modernization/references/observability.md
similarity index 100%
rename from skills/fastapi-async-sqlalchemy-modernization/references/observability.md
rename to docs/skills/fastapi-async-sqlalchemy-modernization/references/observability.md
diff --git a/skills/fastapi-async-sqlalchemy-modernization/references/session.md b/docs/skills/fastapi-async-sqlalchemy-modernization/references/session.md
similarity index 100%
rename from skills/fastapi-async-sqlalchemy-modernization/references/session.md
rename to docs/skills/fastapi-async-sqlalchemy-modernization/references/session.md
diff --git a/skills/fastapi-async-sqlalchemy-modernization/references/template.md b/docs/skills/fastapi-async-sqlalchemy-modernization/references/template.md
similarity index 100%
rename from skills/fastapi-async-sqlalchemy-modernization/references/template.md
rename to docs/skills/fastapi-async-sqlalchemy-modernization/references/template.md
diff --git a/skills/fastapi-async-sqlalchemy-modernization/references/transactions.md b/docs/skills/fastapi-async-sqlalchemy-modernization/references/transactions.md
similarity index 100%
rename from skills/fastapi-async-sqlalchemy-modernization/references/transactions.md
rename to docs/skills/fastapi-async-sqlalchemy-modernization/references/transactions.md
diff --git a/skills/fastapi-uv-docker/SKILL.md b/docs/skills/fastapi-uv-docker/SKILL.md
similarity index 100%
rename from skills/fastapi-uv-docker/SKILL.md
rename to docs/skills/fastapi-uv-docker/SKILL.md
diff --git a/skills/fastapi-uv-docker/references/docker-cloud-native.md b/docs/skills/fastapi-uv-docker/references/docker-cloud-native.md
similarity index 100%
rename from skills/fastapi-uv-docker/references/docker-cloud-native.md
rename to docs/skills/fastapi-uv-docker/references/docker-cloud-native.md
diff --git a/skills/fastapi-uv-docker/references/fastapi-best-practices.md b/docs/skills/fastapi-uv-docker/references/fastapi-best-practices.md
similarity index 100%
rename from skills/fastapi-uv-docker/references/fastapi-best-practices.md
rename to docs/skills/fastapi-uv-docker/references/fastapi-best-practices.md
diff --git a/skills/fastapi-uv-docker/references/uv-project-layout.md b/docs/skills/fastapi-uv-docker/references/uv-project-layout.md
similarity index 100%
rename from skills/fastapi-uv-docker/references/uv-project-layout.md
rename to docs/skills/fastapi-uv-docker/references/uv-project-layout.md
diff --git a/skills/fastapi-uv-docker/references/uvicorn-settings.md b/docs/skills/fastapi-uv-docker/references/uvicorn-settings.md
similarity index 100%
rename from skills/fastapi-uv-docker/references/uvicorn-settings.md
rename to docs/skills/fastapi-uv-docker/references/uvicorn-settings.md
diff --git a/skills/nicegui-ui-customization/SKILL.md b/docs/skills/nicegui-ui-customization/SKILL.md
similarity index 100%
rename from skills/nicegui-ui-customization/SKILL.md
rename to docs/skills/nicegui-ui-customization/SKILL.md
diff --git a/skills/nicegui-ui-customization/references/architecture-and-styling.md b/docs/skills/nicegui-ui-customization/references/architecture-and-styling.md
similarity index 100%
rename from skills/nicegui-ui-customization/references/architecture-and-styling.md
rename to docs/skills/nicegui-ui-customization/references/architecture-and-styling.md
diff --git a/skills/nicegui-ui-customization/references/interaction-patterns.md b/docs/skills/nicegui-ui-customization/references/interaction-patterns.md
similarity index 100%
rename from skills/nicegui-ui-customization/references/interaction-patterns.md
rename to docs/skills/nicegui-ui-customization/references/interaction-patterns.md
diff --git a/skills/nicegui-ui-customization/references/troubleshooting-and-quality-gates.md b/docs/skills/nicegui-ui-customization/references/troubleshooting-and-quality-gates.md
similarity index 100%
rename from skills/nicegui-ui-customization/references/troubleshooting-and-quality-gates.md
rename to docs/skills/nicegui-ui-customization/references/troubleshooting-and-quality-gates.md
diff --git a/skills/nicegui/SKILL.md b/docs/skills/nicegui/SKILL.md
similarity index 100%
rename from skills/nicegui/SKILL.md
rename to docs/skills/nicegui/SKILL.md
diff --git a/skills/nicegui/references/architecture.md b/docs/skills/nicegui/references/architecture.md
similarity index 100%
rename from skills/nicegui/references/architecture.md
rename to docs/skills/nicegui/references/architecture.md
diff --git a/skills/nicegui/references/source-documentation.md b/docs/skills/nicegui/references/source-documentation.md
similarity index 100%
rename from skills/nicegui/references/source-documentation.md
rename to docs/skills/nicegui/references/source-documentation.md
diff --git a/skills/pytest-scaffolding/SKILL.md b/docs/skills/pytest-scaffolding/SKILL.md
similarity index 100%
rename from skills/pytest-scaffolding/SKILL.md
rename to docs/skills/pytest-scaffolding/SKILL.md
diff --git a/skills/pytest-scaffolding/references/pytest-docs.md b/docs/skills/pytest-scaffolding/references/pytest-docs.md
similarity index 100%
rename from skills/pytest-scaffolding/references/pytest-docs.md
rename to docs/skills/pytest-scaffolding/references/pytest-docs.md
diff --git a/skills/python-logging-dictconfig/SKILL.md b/docs/skills/python-logging-dictconfig/SKILL.md
similarity index 100%
rename from skills/python-logging-dictconfig/SKILL.md
rename to docs/skills/python-logging-dictconfig/SKILL.md
diff --git a/skills/python-logging-dictconfig/references/python-logging-docs.md b/docs/skills/python-logging-dictconfig/references/python-logging-docs.md
similarity index 100%
rename from skills/python-logging-dictconfig/references/python-logging-docs.md
rename to docs/skills/python-logging-dictconfig/references/python-logging-docs.md