ring-skills-mcp 1.0.2 → 1.0.4

package/dist/index.js

@@ -52,10 +52,19 @@ async function fetchSkills(host, search = "", pageSize = 5000, token = "") {
         throw new Error("Failed to fetch Skills list: Unknown error");
     }
 }
+/**
+ * Extract skill name from gitUrl
+ * Example: "https://github.com/anthropics/skills/tree/main/skills/webapp-testing" -> "webapp-testing"
+ */
+function extractSkillNameFromGitUrl(gitUrl) {
+    // Match pattern: .../skills/{skill-name} or .../skills/{skill-name}/...
+    const match = gitUrl.match(/\/skills\/([^\/\s]+)/);
+    return match ? match[1].toLowerCase() : null;
+}
 /**
  * Install Skill to specified project
  */
-async function installSkill(skillName, projectPath, targetDir = "skills", repo = DEFAULT_SKILLS_REPO) {
+async function installSkill(skillName, projectPath, targetDir = ".claude/skills", repo = DEFAULT_SKILLS_REPO) {
     // Convert skill name to lowercase
     const normalizedName = skillName.toLowerCase();
     // Build full installation path
@@ -119,7 +128,8 @@ server.tool("list_skills", "Fetch company Skills list. You can search for specif
             const title = skill.title || skill.id || "Unnamed";
             const summary = skill.summary || "No description";
             const category = skill.category ? ` [${skill.category}]` : "";
-            return `${index + 1}. **${title}**${category}\n   ${summary}`;
+            const gitUrl = skill.gitUrl ? ` [${skill.gitUrl}]` : "";
+            return `${index + 1}. **${title}**${category}\n   ${summary} ${gitUrl}`;
         })
             .join("\n\n");
         return {
@@ -144,8 +154,9 @@ server.tool("list_skills", "Fetch company Skills list. You can search for specif
     }
 });
 // Register tool: Install Skill
-server.tool("install_skill", "Install skill to local project by skill name. Uses npx degit to download skill template from remote repository. Project path is required, which can be the project path of the currently opened file in IDE.", {
-    skillName: z.string().describe("Name of the skill to install"),
+server.tool("install_skill", "Install skill to local project by skill name or gitUrl. Uses npx degit to download skill template from remote repository. Project path is required, which can be the project path of the currently opened file in IDE.", {
+    skillName: z.string().optional().describe("Name of the skill to install (e.g., 'webapp-testing'). Either skillName or gitUrl must be provided."),
+    gitUrl: z.string().optional().describe("Git URL of the skill (e.g., 'https://github.com/anthropics/skills/tree/main/skills/webapp-testing'). The skill name will be extracted from this URL. Either skillName or gitUrl must be provided."),
     projectPath: z
         .string()
         .optional()
@@ -153,26 +164,57 @@ server.tool("install_skill", "Install skill to local project by skill name. Uses
     targetDir: z
         .string()
         .optional()
-        .describe("Installation target directory, default: skills"),
+        .describe("Installation target directory, default: .claude/skills"),
     repo: z
         .string()
         .optional()
         .describe(`Skills repository path, default: ${DEFAULT_SKILLS_REPO}`),
-}, async ({ skillName, projectPath, targetDir, repo }) => {
+}, async ({ skillName, gitUrl, projectPath, targetDir, repo }) => {
     // Check if project path is provided
     if (!projectPath) {
         return {
             content: [
                 {
                     type: "text",
-                    text: "❌ Please provide project path (projectPath).\n\nYou can provide the project root directory path of the currently opened file in IDE, skill will be installed to the skills directory of that project.\n\nExample: /Users/xxx/my-project",
+                    text: "❌ Please provide project path (projectPath).\n\nYou can provide the project root directory path of the currently opened file in IDE, skill will be installed to the .claude/skills directory of that project.\n\nExample: /Users/xxx/my-project",
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Determine the actual skill name to use
+    let actualSkillName = null;
+    // Priority: gitUrl > skillName
+    if (gitUrl) {
+        actualSkillName = extractSkillNameFromGitUrl(gitUrl);
+        if (!actualSkillName) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `❌ Error: Could not extract skill name from gitUrl: ${gitUrl}\n\nExpected format: https://github.com/org/repo/tree/main/skills/{skill-name}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    else if (skillName) {
+        actualSkillName = skillName;
+    }
+    if (!actualSkillName) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "❌ Error: Either skillName or gitUrl must be provided.",
                 },
             ],
             isError: true,
         };
     }
     try {
-        const result = await installSkill(skillName, projectPath, targetDir || "skills", repo || DEFAULT_SKILLS_REPO);
+        const result = await installSkill(actualSkillName, projectPath, targetDir || ".claude/skills", repo || DEFAULT_SKILLS_REPO);
         return {
             content: [
                 {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ring-skills-mcp",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "MCP service for fetching and installing company Skills",
   "type": "module",
   "main": "dist/index.js",