docs(skills): document monorepo skill layout

src/skills/README.md

@@ -0,0 +1,36 @@
+# Skills
+
+This directory contains monorepo-owned agent skill sources.
+
+## Layout
+
+```text
+src/skills/                         Monorepo-owned skill sources
+.agents/skills/                     Monorepo-wide enabled skill symlinks
+src/<project>/skills/               Project-owned skill sources
+src/<project>/.agents/skills/       Project-specific enabled skill symlinks
+```
+
+## Source ownership
+
+Use `src/skills/` for skills that support workflows across the monorepo.
+Keep project-specific skills inside the project that owns them.
+
+For example, a `gitea-axi` skill belongs with the `gitea-axi` project source.
+A general commit or review workflow skill belongs in `src/skills/`.
+
+## Enablement
+
+Enable skills with symlinks.
+Do not copy skill sources into `.agents/skills/`.
+
+Use root `.agents/skills/` for skills that should be available when Pi starts at the monorepo root.
+Use `src/<project>/.agents/skills/` for skills that should be available only when Pi starts in that project subtree.
+
+Pi scans `.agents/skills/` in the current working directory and ancestors up to the Git root.
+Pi does not scan descendant project directories when it starts at the monorepo root.
+
+## Distribution
+
+This monorepo optimizes for local use.
+Do not add packaging or distribution layers until a concrete distribution need exists.