agentskillsdk 0.1.0

package/bin/cli.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../src/index.js';

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "agentskillsdk",
+  "version": "0.1.0",
+  "description": "Install agent skills from agentskills.dk",
+  "type": "module",
+  "bin": {
+    "agentskillsdk": "./bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "src/"
+  ],
+  "dependencies": {
+    "commander": "^13.0.0",
+    "chalk": "^5.4.0",
+    "tar-stream": "^3.1.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "agent",
+    "skills",
+    "cli",
+    "claude",
+    "ai"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agentskillsdk/cli"
+  },
+  "homepage": "https://agentskills.dk"
+}

package/src/commands/add.js

@@ -0,0 +1,62 @@
+import chalk from 'chalk';
+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';
+
+export async function addCommand(skillName) {
+  const cwd = process.cwd();
+
+  // 1. Look up skill
+  let skill;
+  try {
+    skill = await fetchSkill(skillName);
+  } catch (err) {
+    console.error(chalk.red(`\n  ${err.message}\n`));
+    process.exit(1);
+  }
+
+  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.log(chalk.green('  \u2713') + ` Found skill: ${chalk.bold(skill.name)}`);
+
+  // 2. Detect agent
+  const agents = await detectAgents(cwd);
+  console.log(chalk.green('  \u2713') + ` Detected agent: ${chalk.bold(agents[0].name)}`);
+
+  // 3. Download + install for each selected agent
+  for (const agent of agents) {
+    const destDir = join(cwd, agent.path(skillName));
+    try {
+      await downloadSkill(skill, destDir);
+    } catch (err) {
+      console.error(chalk.red(`\n  Failed to download skill files. Try again or report at agentskills.dk/support`));
+      console.error(chalk.red(`  ${err.message}\n`));
+      process.exit(1);
+    }
+    console.log(chalk.green('  \u2713') + ` Installed to ${agent.path(skillName)}`);
+  }
+
+  // 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`);
+}

package/src/commands/list.js

@@ -0,0 +1,28 @@
+import chalk from 'chalk';
+import { fetchSkills } from '../lib/api.js';
+
+export async function listCommand() {
+  let skills;
+  try {
+    skills = await fetchSkills();
+  } catch (err) {
+    console.error(chalk.red(`\n  ${err.message}\n`));
+    process.exit(1);
+  }
+
+  if (skills.length === 0) {
+    console.log('\n  No skills available yet.\n');
+    return;
+  }
+
+  console.log(chalk.bold('\n  Available skills:\n'));
+
+  const maxName = Math.max(...skills.map(s => s.name.length));
+
+  for (const skill of skills) {
+    console.log(`    ${chalk.cyan(skill.name.padEnd(maxName + 2))} ${skill.description}`);
+  }
+
+  console.log(`\n  Install: ${chalk.bold('npx agentskillsdk add <skill-name>')}`);
+  console.log(`  Browse:  ${chalk.underline('https://agentskills.dk/skills')}\n`);
+}

package/src/index.js

@@ -0,0 +1,23 @@
+import { Command } from 'commander';
+import { addCommand } from './commands/add.js';
+import { listCommand } from './commands/list.js';
+
+const program = new Command();
+
+program
+  .name('agentskillsdk')
+  .description('Install agent skills from agentskills.dk')
+  .version('0.1.0');
+
+program
+  .command('add')
+  .description('Install a skill into your project')
+  .argument('<skill-name>', 'name of the skill to install')
+  .action(addCommand);
+
+program
+  .command('list')
+  .description('Show all available skills')
+  .action(listCommand);
+
+program.parse();

package/src/lib/api.js

@@ -0,0 +1,25 @@
+const API_BASE = 'https://agentskills.dk/api/cli';
+
+export async function fetchSkills() {
+  let res;
+  try {
+    res = await fetch(`${API_BASE}/skills`);
+  } catch {
+    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;
+}
+
+export async function fetchSkill(name) {
+  let res;
+  try {
+    res = await fetch(`${API_BASE}/skills/${encodeURIComponent(name)}`);
+  } catch {
+    throw new Error('Could not reach agentskills.dk. Check your internet connection.');
+  }
+  if (res.status === 404) return null;
+  if (!res.ok) throw new Error(`Failed to fetch skill: ${res.status}`);
+  return res.json();
+}

package/src/lib/detect-agent.js

@@ -0,0 +1,34 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { createInterface } from 'node:readline';
+
+const AGENTS = [
+  { name: 'Claude Code', folder: '.claude', path: (skill) => `.claude/skills/${skill}/` },
+];
+
+export async function detectAgents(cwd) {
+  const found = AGENTS.filter(agent => existsSync(join(cwd, agent.folder)));
+
+  if (found.length === 1) return [found[0]];
+  if (found.length > 1) return await promptUserChoice(found);
+  return await promptUserChoice(AGENTS);
+}
+
+async function promptUserChoice(agents) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+
+  console.log('\nWhich agent do you use?\n');
+  agents.forEach((a, i) => console.log(`  ${i + 1}) ${a.name}`));
+
+  return new Promise((resolve) => {
+    rl.question('\nChoice: ', (answer) => {
+      rl.close();
+      const idx = parseInt(answer, 10) - 1;
+      if (idx >= 0 && idx < agents.length) {
+        resolve([agents[idx]]);
+      } else {
+        resolve([agents[0]]);
+      }
+    });
+  });
+}

package/src/lib/download.js

@@ -0,0 +1,61 @@
+import { pipeline } from 'node:stream/promises';
+import { createGunzip } from 'node:zlib';
+import { createWriteStream, mkdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import tar from 'tar-stream';
+
+export async function downloadSkill(skill, destDir) {
+  const url = `https://api.github.com/repos/${skill.githubOwner}/${skill.githubRepo}/tarball/${skill.defaultBranch}`;
+
+  let res;
+  try {
+    res = await fetch(url, {
+      headers: {
+        'Accept': 'application/vnd.github+json',
+        'User-Agent': 'agentskillsdk-cli',
+      },
+      redirect: 'follow',
+    });
+  } catch {
+    throw new Error('Failed to download skill files. Check your internet connection.');
+  }
+
+  if (!res.ok) throw new Error(`GitHub download failed: ${res.status}`);
+
+  const extract = tar.extract();
+  const skillPath = skill.githubPath;
+  const filePromises = [];
+
+  extract.on('entry', (header, stream, next) => {
+    // Tarball entries: "{owner}-{repo}-{sha}/skills/real-estate-crm/SKILL.md"
+    // Strip the first path segment (the repo prefix)
+    const parts = header.name.split('/');
+    parts.shift();
+    const relativePath = parts.join('/');
+
+    if (header.type === 'file' && relativePath.startsWith(skillPath + '/')) {
+      const fileRelative = relativePath.slice(skillPath.length + 1);
+      const destPath = join(destDir, fileRelative);
+
+      mkdirSync(dirname(destPath), { recursive: true });
+
+      const writePromise = new Promise((resolve, reject) => {
+        stream.pipe(createWriteStream(destPath))
+          .on('finish', resolve)
+          .on('error', reject);
+      });
+      filePromises.push(writePromise);
+    } else {
+      stream.resume();
+    }
+    next();
+  });
+
+  await pipeline(
+    res.body,
+    createGunzip(),
+    extract,
+  );
+
+  await Promise.all(filePromises);
+}