@akshar5/skillsync 0.1.0

package/README.md

@@ -0,0 +1,131 @@
+# SkillSync
+
+Local-first skill manager for AI agent skills.
+
+SkillSync uses a private GitHub repo as your cloud vault, then keeps selected skills linked into local agent skill folders on each device.
+
+## What it manages
+
+Vault repo layout:
+
+```text
+skills/
+  some-skill/
+    SKILL.md
+registry.json        # generated, do not edit
+devices/*.json       # generated, do not edit
+```
+
+User-owned files are the skill folders under `skills/`. SkillSync owns `registry.json` and `devices/*.json`.
+
+## Install on another device
+
+SkillSync is an npm-style CLI package. Once published, the nice path will be:
+
+```bash
+npx @akshar5/skillsync setup --repo AksharP5/skills
+npx @akshar5/skillsync add https://github.com/raroque/vibe-security-skill --skill vibe-security
+```
+
+It is not published to the public npm registry yet. Install it from the private GitHub repo for now:
+
+```bash
+# macOS
+brew install gh git node
+
+gh auth login
+npm install -g git+ssh://git@github.com/AksharP5/skillsync.git
+```
+
+If SSH is not set up on that device yet, use the clone/link fallback:
+
+```bash
+mkdir -p ~/projects
+gh repo clone AksharP5/skillsync ~/projects/skillsync
+cd ~/projects/skillsync
+npm install
+npm link
+```
+
+Connect to an existing vault:
+
+```bash
+skillsync setup --repo AksharP5/skills
+```
+
+Or create/select a different private vault repo name:
+
+```bash
+skillsync setup --name my-skills
+```
+
+If you run plain `skillsync setup` in an interactive terminal, it asks for the repo name and defaults to `skills`. `setup --name` creates `OWNER/my-skills` as a private GitHub repo if it does not exist. If it exists, SkillSync verifies it is private before using it.
+
+## Commands
+
+```bash
+skillsync setup
+skillsync
+skillsync add <skill-folder-or-git-url> --skill <name>
+skillsync add https://github.com/raroque/vibe-security-skill --skill vibe-security
+skillsync import hermes
+skillsync install <skill> --target codex
+skillsync uninstall <skill>
+skillsync delete <skill>
+skillsync target add codex ~/.codex/skills
+skillsync target add hermes ~/.hermes/skills/personal --scan-path ~/.hermes/skills
+skillsync scan
+skillsync sync
+skillsync service install
+```
+
+## Removal model
+
+- `skillsync uninstall <skill>` removes the skill from the current device only.
+- `skillsync delete <skill>` removes the skill from the vault and all device manifests.
+
+## Add from GitHub
+
+You can import a skill directly from a GitHub repo into your private vault:
+
+```bash
+skillsync add https://github.com/raroque/vibe-security-skill --skill vibe-security
+```
+
+If the repo has multiple skills, omit `--skill` in an interactive terminal and SkillSync will ask which ones to add. Add `--target codex` or `--target '*'` to install it on the current device immediately after importing.
+
+## Publishing to npm
+
+Clone the project on the machine where your npm account is configured:
+
+```bash
+gh repo clone AksharP5/skillsync ~/projects/skillsync
+cd ~/projects/skillsync
+npm install
+npm test
+npm pack --dry-run
+npm login
+npm publish --access public
+```
+
+The package name is `@akshar5/skillsync` because `skillsync` is already taken on npm. The installed command is still `skillsync`.
+
+## Detected versus managed skills
+
+`installed` skills are SkillSync-managed projections into a target folder. `detected` skills are already present in a local agent's skill tree, such as bundled Hermes skills under `~/.hermes/skills`.
+
+For Hermes, use a separate scan path so SkillSync installs personal synced skills into `~/.hermes/skills/personal` while still showing the full Hermes skill inventory from `~/.hermes/skills`:
+
+```bash
+skillsync target add hermes ~/.hermes/skills/personal --scan-path ~/.hermes/skills
+skillsync scan
+```
+
+## Auto-sync
+
+`skillsync service install` installs a background service:
+
+- macOS: LaunchAgent
+- Linux: systemd user service
+
+The service periodically pulls/pushes the GitHub vault and reapplies symlinks.

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@akshar5/skillsync",
+  "version": "0.1.0",
+  "description": "Local-first GitHub-backed skill vault sync client for AI agent skills.",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AksharP5/skillsync.git"
+  },
+  "homepage": "https://github.com/AksharP5/skillsync#readme",
+  "bugs": {
+    "url": "https://github.com/AksharP5/skillsync/issues"
+  },
+  "bin": {
+    "skillsync": "src/cli.js"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "node --test",
+    "start": "node src/cli.js"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.3.2"
+  },
+  "devDependencies": {},
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT"
+}