agentskillsync
v0.2.1
Published
Sync ~/.agents skills (source of truth) one-way into Claude Code, Codex, Antigravity, Aside, and other harnesses
Downloads
284
Maintainers
Readme
agentskillsync
One-way sync of ~/.agents skills (source of truth) into harnesses that do not natively read ~/.agents (Claude Code, Codex, Antigravity, Aside).
Target-only custom skills (for example Aside user skills) are left untouched and never pulled into ~/.agents.
Run
npx agentskillsyncInstall
npm i -g agentskillsync
agentskillsync
# alias:
syncskillsUsage
agentskillsync # push agents skills one-way
agentskillsync --dry-run
agentskillsync status
agentskillsync status -vBehavior
- Source of truth:
$AGENTS_DIR(default~/.agents) - Bootstrap: if agents is missing, seed from
~/.claude - Write Claude / Codex / Antigravity / Aside instruction stubs
- Symlink
~/.claude/skills→~/.agents/skillswhen missing - One-way link each agents skill into other hubs when missing
- Destination-only customs stay on the destination only
Environment
| Variable | Default |
| --- | --- |
| AGENTS_DIR | ~/.agents (source) |
| CLAUDE_DIR | ~/.claude (bootstrap seed) |
| CODEX_DIR | ~/.codex |
| ANTIGRAVITY_DIR | ~/.gemini/antigravity |
| ANTIGRAVITY_CLI_DIR | ~/.gemini/antigravity-cli |
| ASIDE_DIR | ~/.aside |
| ASIDE_USER_SKILLS_DIRS | all ~/.aside/u/<id>/agents/main/skills/user |
License
MIT
