첫 스킬 만들기

// SKILL.md 검사기 — SKILL.md 맨 위 라벨(name·description·allowed-tools·model)이
// agentskills.io 공개 표준 규칙에 맞는지 점검한다. 규칙은 3장에서 배운 것 그대로다.

// (a) 맨 위 라벨 블록을 잘라 읽는다. 여는 --- 와 닫는 --- 는 각자 제 줄에 있어야 한다.
//     한 줄로 붕괴하면(---name: ... model: ... ---) 라벨을 읽지 못한다.
function parseFrontmatter(src) {
  const lines = src.replace(/\r\n/g, "\n").split("\n");
  const first = lines[0].trim();
  if (first !== "---") {
    if (first.indexOf("---") === 0) {
      return { ok: false, reason: "여는 --- 뒤에 내용이 붙어 라벨이 한 줄로 붕괴했습니다." };
    }
    return { ok: false, reason: "맨 위 라벨이 --- 로 시작하지 않습니다." };
  }
  let end = -1;
  for (let i = 1; i < lines.length; i++) {
    if (lines[i].trim() === "---") { end = i; break; }
  }
  if (end === -1) {
    return { ok: false, reason: "닫는 --- 가 제 줄에 없습니다." };
  }
  const fm = {};
  for (let i = 1; i < end; i++) {
    const c = lines[i].indexOf(":");
    if (c === -1) continue;
    fm[lines[i].slice(0, c).trim()] = lines[i].slice(c + 1).trim();
  }
  return { ok: true, fm: fm, body: lines.slice(end + 1).join("\n").trim() };
}

// (b) 라벨과 본문을 규칙대로 점검한다.
function validate(parsed) {
  const problems = [];
  if (!parsed.ok) { problems.push(parsed.reason); return problems; }
  const fm = parsed.fm;

  // name — 필수 · 소문자·숫자·하이픈만 · 최대 64자
  if (!fm.name) {
    problems.push("name 이 없습니다(필수).");
  } else {
    if (!/^[a-z0-9-]+$/.test(fm.name)) {
      problems.push("name 은 소문자·숫자·하이픈만 됩니다: " + fm.name);
    }
    if (fm.name.length > 64) {
      problems.push("name 이 64자를 넘습니다(" + fm.name.length + "자).");
    }
  }

  // description — 필수 · 최대 1,024자 · 매칭에 가장 중요한 항목
  if (!fm.description) {
    problems.push("description 이 없습니다(필수 · 매칭에 가장 중요).");
  } else if (fm.description.length > 1024) {
    problems.push("description 이 1,024자를 넘습니다(" + fm.description.length + "자).");
  }

  // allowed-tools — 있으면 쉼표로 나눈 목록이어야 한다
  const at = fm["allowed-tools"];
  if (at && at.indexOf(",") === -1 && at.split(/\s+/).length > 1) {
    problems.push("allowed-tools 는 쉼표로 나눈 목록이어야 합니다.");
  }

  // 라벨 아래 본문(지침) 존재
  if (!parsed.body) {
    problems.push("라벨 아래 본문(지침)이 없습니다.");
  }
  return problems;
}

// ── 점검할 SKILL.md 세 벌(전부 3장 예시에서 가져옴) ──
const GOOD = [
  "---",
  "name: codebase-onboarding",
  "description: Helps new developers understand how the system works.",
  "allowed-tools: Read, Grep, Glob, Bash",
  "model: sonnet",
  "---",
  "",
  "# Codebase Guide",
].join("\n");

// 여닫는 --- 가 제 줄을 잃고 한 줄로 붕괴한 라벨
const COLLAPSED =
  "---name: codebase-onboardingdescription: Helps new developers " +
  "understand how the system works.allowed-tools: Read, Grep, Glob, Bashmodel: sonnet---";

// 이름에 대문자·공백이 섞이고 description 이 빠진 라벨
const BAD = [
  "---",
  "name: PR Review",
  "model: sonnet",
  "---",
  "",
  "When writing a PR description, run git diff first.",
].join("\n");

[
  ["통과 · codebase-onboarding", GOOD],
  ["위반A · 한 줄로 붕괴한 라벨", COLLAPSED],
  ["위반B · 이름 규칙 위반 + 설명 누락", BAD],
].forEach(function (pair) {
  const problems = validate(parseFrontmatter(pair[1]));
  console.log(pair[0] + " → " + (problems.length ? problems.join(" / ") : "표준과 일치"));
});