yeknal 1.3.2 → 1.3.3

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`.
+- Only the matching `yeknal-*` managed destination folders are overwritten during sync.
 - 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}`;
@@ -393,6 +401,7 @@ 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) {
@@ -402,7 +411,7 @@ async function runSkillsCommand() {
 
         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.3.3",
   "description": "CLI to fetch markdown templates and sync AI agent skills",
   "main": "bin/yeknal.js",
   "bin": {