agentskillsdk 0.1.0 → 0.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentskillsdk",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Install agent skills from agentskills.dk",
   "type": "module",
   "bin": {

package/src/commands/add.js

@@ -3,41 +3,61 @@ import { join } from 'node:path';
 import { fetchSkill, fetchSkills } from '../lib/api.js';
 import { detectAgents } from '../lib/detect-agent.js';
 import { downloadSkill } from '../lib/download.js';
+import { parseGithubSource } from '../lib/parse-source.js';
 
-export async function addCommand(skillName) {
+export async function addCommand(skillName, options) {
   const cwd = process.cwd();
+  const githubSource = parseGithubSource(skillName);
 
-  // 1. Look up skill
   let skill;
-  try {
-    skill = await fetchSkill(skillName);
-  } catch (err) {
-    console.error(chalk.red(`\n  ${err.message}\n`));
-    process.exit(1);
-  }
+  let installName;
 
-  if (!skill) {
-    let suggestions = [];
+  if (githubSource) {
+    // GitHub owner/repo source
+    const skillPath = options.skill || '';
+    installName = skillPath ? skillPath.split('/').pop() : githubSource.repo;
+    skill = {
+      name: installName,
+      githubOwner: githubSource.owner,
+      githubRepo: githubSource.repo,
+      githubPath: skillPath,
+      defaultBranch: 'main',
+    };
+    console.log(chalk.green('  \u2713') + ` GitHub source: ${chalk.bold(`${githubSource.owner}/${githubSource.repo}`)}` +
+      (options.skill ? ` (skill: ${chalk.bold(options.skill)})` : ''));
+  } else {
+    // Registry source
+    installName = skillName;
     try {
-      const allSkills = await fetchSkills();
-      suggestions = allSkills
-        .filter(s => s.name.includes(skillName) || skillName.includes(s.name))
-        .slice(0, 3);
-    } catch {
-      // If we can't fetch suggestions, just show the not-found message
+      skill = await fetchSkill(skillName);
+    } catch (err) {
+      console.error(chalk.red(`\n  ${err.message}\n`));
+      process.exit(1);
     }
 
-    console.error(chalk.red(`\n  Skill "${skillName}" not found.\n`));
-    if (suggestions.length > 0) {
-      console.error('  Did you mean:');
-      suggestions.forEach(s => console.error(`    - ${chalk.bold(s.name)}`));
-      console.error('');
+    if (!skill) {
+      let suggestions = [];
+      try {
+        const allSkills = await fetchSkills();
+        suggestions = allSkills
+          .filter(s => s.name.includes(skillName) || skillName.includes(s.name))
+          .slice(0, 3);
+      } catch {
+        // If we can't fetch suggestions, just show the not-found message
+      }
+
+      console.error(chalk.red(`\n  Skill "${skillName}" not found.\n`));
+      if (suggestions.length > 0) {
+        console.error('  Did you mean:');
+        suggestions.forEach(s => console.error(`    - ${chalk.bold(s.name)}`));
+        console.error('');
+      }
+      console.error(`  Browse all skills: ${chalk.underline('https://agentskills.dk/skills')}\n`);
+      process.exit(1);
     }
-    console.error(`  Browse all skills: ${chalk.underline('https://agentskills.dk/skills')}\n`);
-    process.exit(1);
-  }
 
-  console.log(chalk.green('  \u2713') + ` Found skill: ${chalk.bold(skill.name)}`);
+    console.log(chalk.green('  \u2713') + ` Found skill: ${chalk.bold(skill.name)}`);
+  }
 
   // 2. Detect agent
   const agents = await detectAgents(cwd);
@@ -45,7 +65,7 @@ export async function addCommand(skillName) {
 
   // 3. Download + install for each selected agent
   for (const agent of agents) {
-    const destDir = join(cwd, agent.path(skillName));
+    const destDir = join(cwd, agent.path(installName));
     try {
       await downloadSkill(skill, destDir);
     } catch (err) {
@@ -53,10 +73,14 @@ export async function addCommand(skillName) {
       console.error(chalk.red(`  ${err.message}\n`));
       process.exit(1);
     }
-    console.log(chalk.green('  \u2713') + ` Installed to ${agent.path(skillName)}`);
+    console.log(chalk.green('  \u2713') + ` Installed to ${agent.path(installName)}`);
   }
 
   // 4. Done
   console.log(`\n  Skill ready. Start a new ${agents[0].name} session to use it.`);
-  console.log(`  Learn more: ${chalk.underline(`https://agentskills.dk/skills/${skill.namespace}`)}\n`);
+  if (!githubSource) {
+    console.log(`  Learn more: ${chalk.underline(`https://agentskills.dk/skills/${skill.namespace}`)}\n`);
+  } else {
+    console.log('');
+  }
 }

package/src/index.js

@@ -12,7 +12,8 @@ program
 program
   .command('add')
   .description('Install a skill into your project')
-  .argument('<skill-name>', 'name of the skill to install')
+  .argument('<skill-name>', 'name of the skill to install (or owner/repo for GitHub)')
+  .option('--skill <path>', 'path within repo, e.g. skills/twitter')
   .action(addCommand);
 
 program

package/src/lib/api.js

@@ -8,8 +8,7 @@ export async function fetchSkills() {
     throw new Error('Could not reach agentskills.dk. Check your internet connection.');
   }
   if (!res.ok) throw new Error(`Failed to fetch skills: ${res.status}`);
-  const data = await res.json();
-  return data.skills;
+  return res.json();
 }
 
 export async function fetchSkill(name) {

package/src/lib/download.js

@@ -33,8 +33,18 @@ export async function downloadSkill(skill, destDir) {
     parts.shift();
     const relativePath = parts.join('/');
 
-    if (header.type === 'file' && relativePath.startsWith(skillPath + '/')) {
-      const fileRelative = relativePath.slice(skillPath.length + 1);
+    let fileRelative;
+    if (skillPath === '') {
+      if (header.type === 'file' && relativePath) {
+        fileRelative = relativePath;
+      }
+    } else {
+      if (header.type === 'file' && relativePath.startsWith(skillPath + '/')) {
+        fileRelative = relativePath.slice(skillPath.length + 1);
+      }
+    }
+
+    if (fileRelative) {
       const destPath = join(destDir, fileRelative);
 
       mkdirSync(dirname(destPath), { recursive: true });

package/src/lib/parse-source.js

@@ -0,0 +1,7 @@
+export function parseGithubSource(input) {
+  const parts = input.split('/');
+  if (parts.length === 2 && parts[0] && parts[1]) {
+    return { owner: parts[0], repo: parts[1] };
+  }
+  return null;
+}