diff --git a/.agents/skills/.gitkeep b/.agents/skills/.gitkeep new file mode 100644 index 0000000..e69de29 diff --git a/src/skills/AGENTS.md b/src/skills/AGENTS.md new file mode 100644 index 0000000..e69de29 diff --git a/src/skills/README.md b/src/skills/README.md new file mode 100644 index 0000000..14fac36 --- /dev/null +++ b/src/skills/README.md @@ -0,0 +1,28 @@ +# 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//skills/ Project-owned skill sources +src//.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 anywhere inside the monorepo. +Use `src//.agents/skills/` for skills that should be available only in that project subtree.