skill-registry-sync

skill-registry-sync

Why this exists

Every new skill needs to be listed in its owner-agent's SOUL.md "Available Skills" section, otherwise the agent doesn't know to dispatch to it. This has been forgotten in 3 recent ship sessions, causing silent dispatch failures Cooper had to debug manually. This skill makes the wire-in automatic.

Inputs

{
  "dry_run": false
}

dry_run=true walks the skills, computes the would-be block, prints the diffs, but does NOT modify any SOUL.md.

Procedure

Step 1 — Walk skills + parse frontmatter

import pathlib, re, json, subprocess, datetime
home = pathlib.Path.home()
skills_dir = home / ".openclaw/skills"

# Map agent_id → list of skill names
by_agent = {}
no_owner = []

for skill_dir in sorted(skills_dir.iterdir()):
    if not skill_dir.is_dir():
        continue
    soul_path = skill_dir / "SOUL.md"
    if not soul_path.exists():
        continue
    text = soul_path.read_text(errors="replace")
    # Parse leading --- frontmatter
    m = re.match(r"^---\n(.*?)\n---\n", text, re.DOTALL)
    if not m:
        no_owner.append(skill_dir.name)
        continue
    fm = m.group(1)
    owner_match = re.search(r"^owner_agent:\s*(.+?)\s*$", fm, re.MULTILINE)
    if not owner_match:
        no_owner.append(skill_dir.name)
        continue
    owner = owner_match.group(1).strip()
    by_agent.setdefault(owner, []).append(skill_dir.name)

# Sort skills alphabetically per agent
for k in by_agent:
    by_agent[k].sort()

print(f"[registry] {sum(len(v) for v in by_agent.values())} skills with owner_agent across {len(by_agent)} agents")
print(f"[registry] {len(no_owner)} skills without owner_agent (skipped, see WARN log)")

Step 2 — Locate SOUL.md files (repo + runtime)

repo = home / "Dev/daily-ai-agent-os"
def soul_pair(agent_id):
    if agent_id == "main":
        return [
            repo / "tools/hermes/SOUL.md",
            home / ".hermes/SOUL.md",
        ]
    repo_soul_candidates = [
        repo / f"openclaw/{agent_id}-agent/SOUL.md",
        repo / f"openclaw/{agent_id}-commander-agent/SOUL.md",  # ops uses ops-commander-agent
    ]
    repo_soul = next((p for p in repo_soul_candidates if p.exists()), repo_soul_candidates[0])
    return [
        repo_soul,
        home / f".openclaw/agents/{agent_id}/SOUL.md",
    ]