yeknal 1.3.2 → 1.4.0

package/README.md

@@ -40,12 +40,14 @@ Behavior:
 - Uses GitHub API + raw file download by default.
 - If GitHub API rate limit is hit, it automatically falls back to `git clone` (Git must be installed).
 - Top-level folders are included only if they contain `SKILL.md`.
+- Installs each synced skill with a `yeknal-` folder prefix, for example `taste-skill` installs as `yeknal-taste-skill`.
+- Matching `yeknal-*` managed destination folders are overwritten during sync, and stale `yeknal-*` folders removed from an earlier repository version are cleaned up. Unprefixed personal skill folders are never touched.
 - Sync targets (if parent folder exists):
 - Gemini: `~/.gemini/antigravity` or `~/.antigravity`
 - Codex: `~/.codex`
 - Claude: `~/.claude`
 - For each detected target, creates `<parent>/skills` if missing.
-- Overwrites destination skill folders to keep targets in sync.
+- Personal/private skill folders without the `yeknal-` prefix are left untouched.
 
 Optional environment variable overrides:
 - `YEKNAL_GEMINI_PARENT`

package/bin/yeknal.js

@@ -27,6 +27,7 @@ const API_BASE = `https://api.github.com/repos/${GITHUB_USERNAME}/${GITHUB_REPO}
 const GITHUB_TOKEN = process.env.YEKNAL_GITHUB_TOKEN || process.env.GITHUB_TOKEN || "";
 
 const EXCLUDED_SKILL_FOLDERS = new Set(["Design", "Security", "Security_Raw", "SEO"]);
+const MANAGED_SKILL_FOLDER_PREFIX = "yeknal-";
 
 const SECURITY_REPO_FOLDERS = ["Security", "Security_Raw"];
 
@@ -163,6 +164,13 @@ function listFilesForFolder(repoTree, folderName) {
     .sort((a, b) => a.localeCompare(b));
 }
 
+function getManagedSkillFolderName(folderName) {
+  if (folderName.startsWith(MANAGED_SKILL_FOLDER_PREFIX)) {
+    return folderName;
+  }
+  return `${MANAGED_SKILL_FOLDER_PREFIX}${folderName}`;
+}
+
 function buildRawFileUrl(repoFilePath) {
   const encodedPath = repoFilePath.split("/").map((part) => encodeURIComponent(part)).join("/");
   return `${RAW_BASE_URL}/${encodedPath}`;
@@ -187,6 +195,26 @@ async function copyDirRecursive(sourceDir, targetDir) {
   }
 }
 
+async function removeStaleManagedSkillFolders(skillsPath, expectedFolders) {
+  const entries = await fsp.readdir(skillsPath, { withFileTypes: true });
+  const removed = [];
+
+  for (const entry of entries) {
+    if (!entry.isDirectory() || !entry.name.startsWith(MANAGED_SKILL_FOLDER_PREFIX)) {
+      continue;
+    }
+
+    if (expectedFolders.has(entry.name)) {
+      continue;
+    }
+
+    await fsp.rm(path.join(skillsPath, entry.name), { recursive: true, force: true });
+    removed.push(entry.name);
+  }
+
+  return removed;
+}
+
 function execCommand(command, options = {}) {
   return new Promise((resolve, reject) => {
     exec(command, options, (error, stdout, stderr) => {
@@ -393,16 +421,28 @@ async function runSkillsCommand() {
 
     console.log(`\nSkill folders to sync (${skillFolders.length}) via ${sourceLabel}:`);
     console.log(`  ${skillFolders.join(", ")}`);
+    console.log(`\nInstalled folders use the managed "${MANAGED_SKILL_FOLDER_PREFIX}" prefix.`);
 
     let hadFailure = false;
     for (const target of targets) {
       try {
         await fsp.mkdir(target.skillsPath, { recursive: true });
         let copiedCount = 0;
+        const expectedFolders = new Set(
+          skillFolders.map((folder) => getManagedSkillFolderName(folder)),
+        );
+        const removedFolders = await removeStaleManagedSkillFolders(
+          target.skillsPath,
+          expectedFolders,
+        );
+
+        for (const removedFolder of removedFolders) {
+          console.log(`  [removed] ${target.label}: stale managed skill ${removedFolder}`);
+        }
 
         for (const folder of skillFolders) {
           const sourceFolder = path.join(tempRoot, folder);
-          const destinationFolder = path.join(target.skillsPath, folder);
+          const destinationFolder = path.join(target.skillsPath, getManagedSkillFolderName(folder));
           await fsp.rm(destinationFolder, { recursive: true, force: true });
           await copyDirRecursive(sourceFolder, destinationFolder);
           copiedCount += 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yeknal",
-  "version": "1.3.2",
+  "version": "1.4.0",
   "description": "CLI to fetch markdown templates and sync AI agent skills",
   "main": "bin/yeknal.js",
   "bin": {