manage-skills

Register a source directory with manage-skills sources add, then run manage-skills link <skill> inside each project. The whole skill directory is hardlinked from the source, so edits in one place appear everywhere on your machine.

Run manage-skills sync in the cloned project. It re-establishes hardlinks for committed skill copies that match a source, while diverged copies are kept and reported unless you pass --force.

Editors and AI Write/Edit tools that rewrite-and-replace create a new inode, silently detaching the file from every other linked copy. Edit with shell redirects like cat > file, which truncate and write in place, preserving the inode.

Yes. A second target codex:.agents/skills:SKILL.md is configured by default, and manage-skills link <skill> --target codex links the same source into the Codex skills directory. Under Codex the script is invoked by path since plugins cannot modify PATH.

Yes. Run manage-skills sources add github:owner/repo, or just the owner name to resolve their skills repo. manage-skills update fetches changes and writes them in place so existing hardlinks keep working.

Find paths sharing the old inode with find -inum, copy the new content into one old path to preserve that inode, then remove the new path and relink it with ln. Verify with stat that inode and link count match across all paths.