Skills-Registry-CLI: Skill for Claude Code

Skill Format Converter Skill

This skill provides guidance for converting skills between different formats for GitHub Copilot compatibility.

Format Comparison

Source: anthropics/skills Format

skills/
└── <skill-name>/
    ├── SKILL.md
    ├── scripts/
    ├── references/
    └── assets/

Target: GitHub Copilot Format

.github/skills/
└── <skill-name>/
    ├── SKILL.md
    ├── scripts/
    ├── references/
    └── assets/

SKILL.md Format

Both formats use the same SKILL.md structure:

---
name: skill-name
description: Description of the skill
---

# Skill Title

Instructions and content...

Required Frontmatter

Per VS Code Agent Skills specification:

• name: lowercase, hyphens for spaces, max 64 chars
• description: what it does and when to use, max 1024 chars

Conversion Process

Step 1: Parse Source Skill

import { readFile, readdir, stat } from 'fs/promises';
import { join } from 'path';
import { parse as parseYaml } from 'yaml';

async function parseSkill(skillPath) {
  const skillMd = await readFile(join(skillPath, 'SKILL.md'), 'utf-8');
  
  // Extract frontmatter
  const fmMatch = skillMd.match(/^---\n([\s\S]*?)\n---/);
  if (!fmMatch) {
    throw new Error('Invalid SKILL.md: no frontmatter');
  }
  
  const frontmatter = parseYaml(fmMatch[1]);
  const body = skillMd.slice(fmMatch[0].length).trim();
  
  // Scan for resources
  const resources = {
    scripts: await scanDir(join(skillPath, 'scripts')),
    references: await scanDir(join(skillPath, 'references')),
    assets: await scanDir(join(skillPath, 'assets'))
  };
  
  return {
    name: frontmatter.name,
    description: frontmatter.description,
    license: frontmatter.license,
    body,
    resources
  };
}

async function scanDir(dir) {
  try {
    const entries = await readdir(dir, { withFileTypes: true });
    return entries.map(e => ({
      name: e.name,
      isDirectory: e.isDirectory()
    }));
  } catch {
    return [];
  }
}