Add repo-pointer skill: move source-of-truth from agentic-os-kai #15

Open
opened 2026-05-27 09:10:13 +00:00 by coilysiren · 0 comments
Owner

Problem

Per agentic-os-kai#321, the repo-pointer skill for this repo currently lives at agentic-os-kai/.agents/skills/<repo>/SKILL.md (wrong source-of-truth address). It should live in this repo as the canonical copy, with agentic-os-kai symlinking it in.

Proposal

  1. Create .agents/skills/<repo>/SKILL.md mirroring the body at agentic-os-kai/.agents/skills/<repo>/SKILL.md, with relative paths rewritten from ../../../../<repo>/ to ../../../ (since the pointer now lives one level deeper inside the target repo).
  2. If .agents/skills/categories.yaml exists in this repo, add a kind: exact entry for the repo (or kind: repo if the pre-commit pin is v0.5.0+). Most likely no categories.yaml exists - in that case skip.
  3. Commit with closes #N.
  4. In agentic-os-kai: delete the local SKILL.md, run ./setup.sh so the new symlink lands (relink_repo_pointers step), update the categories.yaml entry for the repo to add role: external-symlink, commit (use git pull --rebase first to avoid racing with sibling fanout dispatches).

See also

  • agentic-os-kai#321 - fanout tracker.
  • agentic-os-kai#319 - pattern landed for the first 3 repos.
## Problem Per [agentic-os-kai#321](https://forgejo.coilysiren.me/coilysiren/agentic-os-kai/issues/321), the repo-pointer skill for this repo currently lives at `agentic-os-kai/.agents/skills/<repo>/SKILL.md` (wrong source-of-truth address). It should live in this repo as the canonical copy, with agentic-os-kai symlinking it in. ## Proposal 1. Create `.agents/skills/<repo>/SKILL.md` mirroring the body at `agentic-os-kai/.agents/skills/<repo>/SKILL.md`, with relative paths rewritten from `../../../../<repo>/` to `../../../` (since the pointer now lives one level deeper inside the target repo). 2. If `.agents/skills/categories.yaml` exists in this repo, add a `kind: exact` entry for the repo (or `kind: repo` if the pre-commit pin is v0.5.0+). Most likely no categories.yaml exists - in that case skip. 3. Commit with `closes #N`. 4. In agentic-os-kai: delete the local SKILL.md, run `./setup.sh` so the new symlink lands (relink_repo_pointers step), update the categories.yaml entry for the repo to add `role: external-symlink`, commit (use `git pull --rebase` first to avoid racing with sibling fanout dispatches). ## See also - agentic-os-kai#321 - fanout tracker. - agentic-os-kai#319 - pattern landed for the first 3 repos.
coilysiren added
P4
and removed
P2
labels 2026-05-31 07:01:04 +00:00
Sign in to join this conversation.
No labels
P0
P1
P2
P3
P4
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
coilyco-flight-deck/otel-a2a-relay#15
No description provided.