@ryanreh99/skills-sync 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ryan Rehman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,74 @@
+# skills-sync
+
+skills-sync keeps AI agent skills and MCP servers synchronized across various AI coding agents.
+
+---
+
+AI coding tools store skills and MCP definitions in different directories and configuration formats. Maintaining the same setup across multiple agents usually requires duplicating configuration, copying skill folders, and updating MCP server lists separately for each tool.
+
+skills-sync provides a CLI for managing these definitions in one place and applying them to each supported agent. Skills can be sourced from local directories, public repositories, or private repositories.
+
+If you create a skill or install an MCP server for one agent, skills-sync can synchronize it across your other agents so the same capabilities are available everywhere.
+
+`skills-sync` works across any environment where these agents run, including both **IDEs and terminal-based workflows**.
+## Supported Agents
+
+
+![Codex](https://img.shields.io/badge/Codex-supported-412991?logo=openaigym&logoColor=white)
+![Cursor](https://img.shields.io/badge/Cursor-supported-000000?logo=cursor)![Gemini](https://img.shields.io/badge/Gemini-supported-4285F4?logo=google)
+![Copilot](https://img.shields.io/badge/Copilot-supported-2F80ED?logo=githubcopilot)
+![Claude Code](https://img.shields.io/badge/Claude%20Code-experimental-orange?logo=anthropic&logoColor=white)
+
+## Installation
+
+npm:
+
+```bash
+npm i -g @ryanreh99/skills-sync
+npx @ryanreh99/skills-sync
+```
+
+Homebrew:
+
+```bash
+brew tap ryanreh99/skills-sync
+brew install ryanreh99/skills-sync/skills-sync
+```
+
+## Quick Start
+
+```bash
+# Initialize local workspace from bundled seed content
+skills-sync init --seed
+
+# Build canonical artifacts from your profile inputs
+skills-sync build
+
+# Apply generated skills and MCP config to detected agent targets
+skills-sync apply
+```
+
+These commands initialize your local workspace, build canonical artifacts, and apply them to supported agent targets.
+
+Paste your existing agent's `mcp.json` settings and ask an AI agent to generate the corresponding `skills-sync` commands.
+
+## Verify In Agent Chats
+
+After `apply`, run these in your agent chat to confirm skills and MCP servers are available:
+
+```text
+/skills list or /skills show
+/mcp list
+```
+
+## Documentation
+
+Full documentation lives in the docs directory:
+
+- [docs/quickstart.md](docs/quickstart.md)
+- [docs/user-guide.md](docs/user-guide.md)
+- [docs/commands.md](docs/commands.md)
+
+## License
+
+[MIT](LICENSE)

package/dist/assets/contracts/build/bundle.schema.json

@@ -0,0 +1,76 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Build Bundle Metadata",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "profile",
+    "generatedAt",
+    "sources"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "type": "integer",
+      "const": 1
+    },
+    "profile": {
+      "type": "string",
+      "minLength": 1
+    },
+    "generatedAt": {
+      "type": "string",
+      "minLength": 1
+    },
+    "sources": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "packPath",
+        "imports"
+      ],
+      "properties": {
+        "packPath": {
+          "type": "string",
+          "minLength": 1
+        },
+        "imports": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "upstream",
+              "ref",
+              "commit",
+              "path",
+              "destPrefix"
+            ],
+            "properties": {
+              "upstream": {
+                "type": "string",
+                "minLength": 1
+              },
+              "ref": {
+                "type": "string",
+                "minLength": 1
+              },
+              "commit": {
+                "type": "string",
+                "minLength": 7
+              },
+              "path": {
+                "type": "string",
+                "minLength": 1
+              },
+              "destPrefix": {
+                "type": "string",
+                "minLength": 1
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/dist/assets/contracts/inputs/config.schema.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "User Config",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "defaultProfile": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Profile name used when --profile is not passed on the CLI."
+    }
+  }
+}

package/dist/assets/contracts/inputs/mcp-servers.schema.json

@@ -0,0 +1,56 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "MCP Servers Manifest",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "servers"
+  ],
+  "properties": {
+    "servers": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": false,
+        "anyOf": [
+          {
+            "required": [
+              "command"
+            ]
+          },
+          {
+            "required": [
+              "url"
+            ]
+          }
+        ],
+        "properties": {
+          "command": {
+            "type": "string",
+            "minLength": 1
+          },
+          "url": {
+            "type": "string",
+            "minLength": 1
+          },
+          "args": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "env": {
+            "type": "object",
+            "propertyNames": {
+              "type": "string",
+              "minLength": 1
+            },
+            "additionalProperties": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/dist/assets/contracts/inputs/pack-manifest.schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Pack Manifest",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "name",
+    "version"
+  ],
+  "properties": {
+    "name": {
+      "type": "string",
+      "minLength": 1
+    },
+    "version": {
+      "type": "string",
+      "minLength": 1
+    },
+    "description": {
+      "type": "string"
+    },
+    "maintainer": {
+      "type": "string"
+    },
+    "tags": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    }
+  }
+}
+

package/dist/assets/contracts/inputs/pack-sources.schema.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Pack Sources Selectors",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "imports"
+  ],
+  "properties": {
+    "imports": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "upstream",
+          "paths"
+        ],
+        "properties": {
+          "upstream": {
+            "type": "string",
+            "minLength": 1
+          },
+          "ref": {
+            "type": "string",
+            "minLength": 1
+          },
+          "paths": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "destPrefix": {
+            "type": "string",
+            "minLength": 1
+          },
+          "allowWholeSkillsTree": {
+            "type": "boolean"
+          }
+        }
+      }
+    }
+  }
+}

package/dist/assets/contracts/inputs/profile.schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Profile",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "name",
+    "packPath"
+  ],
+  "properties": {
+    "name": {
+      "type": "string",
+      "minLength": 1
+    },
+    "packPath": {
+      "type": "string",
+      "minLength": 1
+    }
+  }
+}
+

package/dist/assets/contracts/inputs/upstreams.schema.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Upstreams Config",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "upstreams"
+  ],
+  "properties": {
+    "upstreams": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "type",
+          "repo",
+          "defaultRef"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "git"
+            ]
+          },
+          "repo": {
+            "type": "string",
+            "minLength": 1
+          },
+          "defaultRef": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    }
+  }
+}
+

package/dist/assets/contracts/runtime/targets.schema.json

@@ -0,0 +1,120 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Tool Targets",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "codex",
+    "claude",
+    "cursor",
+    "copilot",
+    "gemini"
+  ],
+  "properties": {
+    "codex": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "skillsDir",
+        "mcpConfig"
+      ],
+      "properties": {
+        "skillsDir": {
+          "type": "string",
+          "minLength": 1
+        },
+        "mcpConfig": {
+          "type": "string",
+          "minLength": 1
+        },
+        "canOverride": {
+          "type": "boolean"
+        }
+      }
+    },
+    "claude": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "skillsDir",
+        "mcpConfig"
+      ],
+      "properties": {
+        "skillsDir": {
+          "type": "string",
+          "minLength": 1
+        },
+        "mcpConfig": {
+          "type": "string",
+          "minLength": 1
+        },
+        "canOverride": {
+          "type": "boolean"
+        }
+      }
+    },
+    "cursor": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "skillsDir",
+        "mcpConfig"
+      ],
+      "properties": {
+        "skillsDir": {
+          "type": "string",
+          "minLength": 1
+        },
+        "mcpConfig": {
+          "type": "string",
+          "minLength": 1
+        },
+        "canOverride": {
+          "type": "boolean"
+        }
+      }
+    },
+    "copilot": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "skillsDir",
+        "mcpConfig"
+      ],
+      "properties": {
+        "skillsDir": {
+          "type": "string",
+          "minLength": 1
+        },
+        "mcpConfig": {
+          "type": "string",
+          "minLength": 1
+        },
+        "canOverride": {
+          "type": "boolean"
+        }
+      }
+    },
+    "gemini": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "skillsDir",
+        "mcpConfig"
+      ],
+      "properties": {
+        "skillsDir": {
+          "type": "string",
+          "minLength": 1
+        },
+        "mcpConfig": {
+          "type": "string",
+          "minLength": 1
+        },
+        "canOverride": {
+          "type": "boolean"
+        }
+      }
+    }
+  }
+}

package/dist/assets/contracts/state/upstreams-lock.schema.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Upstreams Lockfile",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "pins"
+  ],
+  "properties": {
+    "pins": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "upstream",
+          "ref",
+          "commit"
+        ],
+        "properties": {
+          "upstream": {
+            "type": "string",
+            "minLength": 1
+          },
+          "ref": {
+            "type": "string",
+            "minLength": 1
+          },
+          "commit": {
+            "type": "string",
+            "pattern": "^[a-fA-F0-9]{7,40}$"
+          }
+        }
+      }
+    }
+  }
+}
+

package/dist/assets/manifests/targets.linux.json

@@ -0,0 +1,27 @@
+{
+  "codex": {
+    "skillsDir": "$HOME/.codex/skills/vendor_imports",
+    "mcpConfig": "$HOME/.codex/config.toml",
+    "canOverride": false
+  },
+  "claude": {
+    "skillsDir": "$HOME/.claude/skills",
+    "mcpConfig": "$HOME/.claude/mcp_servers.json",
+    "canOverride": true
+  },
+  "cursor": {
+    "skillsDir": "$HOME/.cursor/skills",
+    "mcpConfig": "$HOME/.cursor/mcp.json",
+    "canOverride": true
+  },
+  "copilot": {
+    "skillsDir": "$HOME/.copilot/skills",
+    "mcpConfig": "$HOME/.copilot/mcp-config.json",
+    "canOverride": true
+  },
+  "gemini": {
+    "skillsDir": "$HOME/.gemini/skills",
+    "mcpConfig": "$HOME/.gemini/settings.json",
+    "canOverride": false
+  }
+}

package/dist/assets/manifests/targets.macos.json

@@ -0,0 +1,27 @@
+{
+  "codex": {
+    "skillsDir": "$HOME/.codex/skills/vendor_imports",
+    "mcpConfig": "$HOME/.codex/config.toml",
+    "canOverride": false
+  },
+  "claude": {
+    "skillsDir": "$HOME/.claude/skills",
+    "mcpConfig": "$HOME/mcp_servers.json",
+    "canOverride": true
+  },
+  "cursor": {
+    "skillsDir": "$HOME/.cursor/skills",
+    "mcpConfig": "$HOME/.cursor/mcp.json",
+    "canOverride": true
+  },
+  "copilot": {
+    "skillsDir": "$HOME/.copilot/skills",
+    "mcpConfig": "$HOME/.copilot/mcp-config.json",
+    "canOverride": true
+  },
+  "gemini": {
+    "skillsDir": "$HOME/.gemini/skills",
+    "mcpConfig": "$HOME/.gemini/settings.json",
+    "canOverride": false
+  }
+}

package/dist/assets/manifests/targets.windows.json

@@ -0,0 +1,27 @@
+{
+  "codex": {
+    "skillsDir": "%USERPROFILE%\\\\.codex\\\\skills\\\\vendor_imports",
+    "mcpConfig": "%USERPROFILE%\\\\.codex\\\\config.toml",
+    "canOverride": false
+  },
+  "claude": {
+    "skillsDir": "%USERPROFILE%\\\\.claude\\\\skills",
+    "mcpConfig": "%USERPROFILE%\\\\.claude\\\\mcp_servers.json",
+    "canOverride": true
+  },
+  "cursor": {
+    "skillsDir": "%USERPROFILE%\\\\.cursor\\\\skills",
+    "mcpConfig": "%USERPROFILE%\\\\.cursor\\\\mcp.json",
+    "canOverride": true
+  },
+  "copilot": {
+    "skillsDir": "%USERPROFILE%\\\\.copilot\\\\skills",
+    "mcpConfig": "%USERPROFILE%\\\\.copilot\\\\mcp-config.json",
+    "canOverride": true
+  },
+  "gemini": {
+    "skillsDir": "%USERPROFILE%\\\\.gemini\\\\skills",
+    "mcpConfig": "%USERPROFILE%\\\\.gemini\\\\settings.json",
+    "canOverride": false
+  }
+}

package/dist/assets/seed/config.json

@@ -0,0 +1,3 @@
+{
+  "defaultProfile": "personal"
+}

package/dist/assets/seed/packs/personal/mcp/servers.json

@@ -0,0 +1,20 @@
+{
+  "servers": {
+    "filesystem": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@modelcontextprotocol/server-filesystem",
+        "$HOME"
+      ]
+    },
+    "memory": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@modelcontextprotocol/server-memory"
+      ]
+    }
+  }
+}
+

package/dist/assets/seed/packs/personal/pack.json

@@ -0,0 +1,7 @@
+{
+  "name": "personal",
+  "version": "1.0.0",
+  "description": "Personal profile example using upstream imports.",
+  "maintainer": "skills-sync example",
+  "tags": []
+}