@kurokeita/add-skill 1.5.0 → 1.7.0

package/README.md

@@ -86,10 +86,10 @@ pnpm dev import https://github.com/owner/repo/tree/main/skills/skill-name
 <!-- SUPPORTED_AGENTS_START -->
 | Platform | Agents Path | Skills Path | Workflows Path |
 | :--- | :--- | :--- | :--- |
-| Antigravity | `~/.gemini/antigravity/global_agents` | `~/.gemini/antigravity/global_skills` | `~/.gemini/antigravity/workflows` |
-| Gemini CLI | `~/.gemini/agents` | `~/.gemini/skills` | `~/.gemini/workflows` |
+| Antigravity | `~/.gemini/antigravity/global_agents` | `~/.gemini/antigravity/global_skills` | `~/.gemini/antigravity/global_workflows` |
+| Gemini CLI | `~/.gemini/agents` | `~/.gemini/skills` | `~/.gemini/commands` |
 | GitHub Copilot | `~/.copilot/agents` | `~/.copilot/skills` | `~/.copilot/prompts` |
-| Windsurf | `~/.codeium/windsurf/agents` | `~/.codeium/windsurf/skills` | `~/.codeium/windsurf/workflows` |
+| Windsurf | `~/.codeium/windsurf/agents` | `~/.codeium/windsurf/skills` | `~/.codeium/windsurf/global_workflows` |
 <!-- SUPPORTED_AGENTS_END -->
 
 ## Development

package/dist/src/commands/add.js

@@ -5,6 +5,7 @@ import fs from "fs-extra";
 import pc from "picocolors";
 import { fetchSkillFromGitHub } from "../utils/github.js";
 import { getTargetPaths, PLATFORM_LABELS, TYPE_DIRS, } from "../utils/paths.js";
+import { convertToGeminiCommandTOML } from "../utils/toml.js";
 function getPlatformOptions(type) {
     const paths = getTargetPaths(type);
     return Object.entries(paths).map(([platform, pathStr]) => ({
@@ -192,7 +193,28 @@ export async function add(type, url) {
                             currentSourcePath = src; // direct path to dir
                         }
                     }
-                    const installed = await installItem(item, overwrite, currentSourcePath, targetBase);
+                    let targetItemName = item;
+                    if (platform === "windsurf" && normalizedType === "agent") {
+                        targetItemName = path.join(path.parse(item).name, "AGENTS.md");
+                    }
+                    // Gemini Workflow Conversion
+                    if (platform === "gemini" &&
+                        normalizedType === "workflow" &&
+                        currentSourcePath.endsWith(".md")) {
+                        const targetPath = path.join(targetBase, item.replace(/\.md$/, ".toml"));
+                        if (!overwrite && (await fs.pathExists(targetPath))) {
+                            skippedCount++;
+                        }
+                        else {
+                            const content = await fs.readFile(currentSourcePath, "utf-8");
+                            const tomlContent = convertToGeminiCommandTOML(content);
+                            await fs.ensureDir(targetBase);
+                            await fs.writeFile(targetPath, tomlContent);
+                            installedCount++;
+                        }
+                        continue;
+                    }
+                    const installed = await installItem(targetItemName, overwrite, currentSourcePath, targetBase);
                     if (installed) {
                         installedCount++;
                     }

package/dist/src/utils/paths.js

@@ -23,10 +23,10 @@ export const PLATFORM_PATHS_AGENTS = {
     windsurf: path.join(os.homedir(), ".codeium/windsurf/agents"),
 };
 export const PLATFORM_PATHS_WORKFLOWS = {
-    antigravity: path.join(os.homedir(), ".gemini/antigravity/workflows"),
+    antigravity: path.join(os.homedir(), ".gemini/antigravity/global_workflows"),
     copilot: path.join(os.homedir(), ".copilot/prompts"),
-    gemini: path.join(os.homedir(), ".gemini/workflows"),
-    windsurf: path.join(os.homedir(), ".codeium/windsurf/workflows"),
+    gemini: path.join(os.homedir(), ".gemini/commands"),
+    windsurf: path.join(os.homedir(), ".codeium/windsurf/global_workflows"),
 };
 export const TYPE_DIRS = {
     skill: path.join(PROJECT_ROOT, "skills"),

package/dist/src/utils/toml.js

@@ -0,0 +1,60 @@
+/**
+ * Converts Markdown content to the Gemini CLI Custom Command TOML format.
+ *
+ * @param markdownContent The original Markdown content.
+ * @returns A string in TOML format with description and prompt fields.
+ */
+export function convertToGeminiCommandTOML(markdownContent) {
+    // Extract description: find the first line that isn't empty, a horizontal rule, or just whitespace
+    const lines = markdownContent.split("\n");
+    let description = "";
+    for (let i = 0; i < lines.length; i++) {
+        const trimmedLine = lines[i].trim();
+        // Skip empty lines, separators, and common non-description markers
+        if (trimmedLine &&
+            trimmedLine !== "---" &&
+            !trimmedLine.startsWith("<!--")) {
+            if (trimmedLine.startsWith("#")) {
+                description = trimmedLine.replace(/^#+\s*/, "");
+            }
+            else {
+                description = trimmedLine;
+            }
+            break;
+        }
+    }
+    // Limit description length for the help menu
+    if (description.length > 100) {
+        description = `${description.substring(0, 97)}...`;
+    }
+    // Escape triple quotes in the content if any (replace """ with \"\"\" )
+    const escapedContent = markdownContent.replace(/"""/g, '\\"\\"\\"');
+    return `description = ${JSON.stringify(description)}
+
+prompt = """
+${escapedContent.trim()}
+"""
+`;
+}
+/**
+ * Performs a basic validation of a Gemini Command TOML string.
+ *
+ * @param tomlContent The TOML content to validate.
+ * @returns An object with valid boolean and optional error message.
+ */
+export function validateGeminiCommandTOML(tomlContent) {
+    // 1. Basic syntax check for prompt field
+    if (!tomlContent.includes('prompt = """')) {
+        return {
+            valid: false,
+            error: 'Missing required "prompt" field with """ wrapping.',
+        };
+    }
+    // 2. Check for closing triple quotes
+    const promptStart = tomlContent.indexOf('prompt = """');
+    const rest = tomlContent.substring(promptStart + 'prompt = """'.length);
+    if (!rest.includes('"""')) {
+        return { valid: false, error: 'Unterminated "prompt" multi-line string.' };
+    }
+    return { valid: true };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@kurokeita/add-skill",
-	"version": "1.5.0",
+	"version": "1.7.0",
 	"description": "CLI to install AI agent skills to various platforms",
 	"type": "module",
 	"bin": {
@@ -15,10 +15,10 @@
 		"update:readme": "tsx scripts/update-readme.ts",
 		"build": "tsc && tsx scripts/copy-assets.ts",
 		"prepublishOnly": "pnpm run build",
-		"lint": "pnpm run lint:ts && pnpm run lint:md",
+		"lint": "pnpm run lint:ts && pnpm run lint:md '**/*.md'",
 		"lint:ts": "biome check .",
-		"lint:md": "markdownlint '**/*.md' --ignore node_modules",
-		"format": "biome check --write . && markdownlint '**/*.md' --fix --ignore node_modules",
+		"lint:md": "markdownlint --ignore node_modules '**/*.md'",
+		"format": "biome check --write . && pnpm run lint:md --fix",
 		"release": "semantic-release"
 	},
 	"keywords": [