Function generateSkill

packages/dev/s2-docs/scripts/generateAgentSkills.mjs:995–1051

* Generate a single skill.

(skillConfig, wellKnownRoot)

 * Generate a single skill.
 */
function generateSkill(skillConfig, wellKnownRoot) {
  const skillDir = path.join(wellKnownRoot, skillConfig.name);

  // Create skill directory
  fs.mkdirSync(skillDir, {recursive: true});

  if (skillConfig.kind === 'migration') {
    const skillMdContent = generateMigrationSkillMd(skillConfig);
    fs.writeFileSync(path.join(skillDir, 'SKILL.md'), skillMdContent);
    console.log(`Generated ${path.relative(REPO_ROOT, path.join(skillDir, 'SKILL.md'))}`);

    writeMigrationReferences(skillDir, skillConfig.sourceDir);
    console.log(
      `Copied migration references to ${path.relative(REPO_ROOT, path.join(skillDir, 'references'))}`
    );

    return skillDir;
  }

  if (skillConfig.kind === 'audit') {
    fs.writeFileSync(path.join(skillDir, 'SKILL.md'), generateAuditSkillMd(skillConfig));
    console.log(`Generated ${path.relative(REPO_ROOT, path.join(skillDir, 'SKILL.md'))}`);

    writeAuditReferences(skillDir);
    console.log(
      `Copied audit references to ${path.relative(REPO_ROOT, path.join(skillDir, 'references'))}`
    );

    return skillDir;
  }

  const isS2 = skillConfig.name === 'react-spectrum-s2';

  // Parse documentation entries
  const llmsTxtPath = path.join(MARKDOWN_DOCS_DIST, skillConfig.sourceDir, 'llms.txt');
  if (!fs.existsSync(llmsTxtPath)) {
    console.error(`llms.txt not found at ${llmsTxtPath}`);
    return;
  }

  const entries = parseLlmsTxt(llmsTxtPath);
  const categories = categorizeEntries(entries, skillConfig.sourceDir);

  // Generate SKILL.md
  const skillMdContent = generateDocsSkillMd(skillConfig, categories, isS2);
  fs.writeFileSync(path.join(skillDir, 'SKILL.md'), skillMdContent);
  console.log(`Generated ${path.relative(REPO_ROOT, path.join(skillDir, 'SKILL.md'))}`);

  // Copy documentation to references
  copyDocsDocumentation(skillConfig, categories, skillDir);
  console.log(
    `Copied documentation to ${path.relative(REPO_ROOT, path.join(skillDir, 'references'))}`
  );
  copyAdditionalReferenceLibraries(skillConfig, skillDir);

  return skillDir;
}