Function validateSkill

ng-dev/misc/validate-skills/validate.ts:89–129

(filePath: string)

/** Validates a single skill file. */
export async function validateSkill(filePath: string): Promise<ValidationResult> {
  const name = basename(join(filePath, '..'));
  const failures: string[] = [];

  try {
    const content = await readFile(filePath, {encoding: 'utf8'});
    const frontmatterRaw = content.match(/^---\n([\s\S]*?)\n---/);

    if (frontmatterRaw === null) {
      failures.push('Missing or invalid frontmatter in SKILL.md');
      return {name, failures};
    }

    let frontmatter: unknown;
    try {
      frontmatter = parse(frontmatterRaw[1]);
    } catch (e) {
      failures.push(`Failed to parse YAML frontmatter: ${(e as Error).message}`);
      return {name, failures};
    }

    const frontmatterData = skillFrontmatterSchema.safeParse(frontmatter);
    if (frontmatterData.success === false) {
      for (const issue of frontmatterData.error.issues) {
        failures.push(`Schema validation failure: [${issue.path.join('.')}] ${issue.message}`);
      }
      return {name, failures};
    }

    // Check name match if data looks like an object with a name
    if (frontmatterData.data?.name !== name) {
      failures.push(
        `Name mismatch. Expected "${name}", found "${frontmatterData.data?.name ?? '<UNKNOWN>'}"`,
      );
    }
  } catch (e) {
    failures.push(`Unexpected error: ${(e as Error).message}`);
  }

  return {name, failures};
}