Skip to content

AI-native design editor. Open-source Figma alternative.

1.1 KB
Raw Blame
import { parseSkill } from './parse'
import type { Skill, SkillProblem, SkillSourceID } from './types'

/** A skill folder as a source holds it: its SKILL.md and the other files it can read. */
export interface SkillFolderContents {
  source: SkillSourceID
  /** The folder's name, or null for a SKILL.md that came without one. */
  folder: string | null
  location: string
  skillsFolder?: string
  skillFile: string
  files: readonly string[]
  readFile: (path: string) => Promise<string>
}

/** The skill a folder holds, or why it holds none. */
export function skillFromFolder(contents: SkillFolderContents): Skill | SkillProblem {
  const { source, folder, location, skillsFolder, skillFile, files, readFile } = contents
  const parsed = parseSkill(skillFile, folder)
  const found =
    skillsFolder === undefined ? { source, location } : { source, location, skillsFolder }
  if (!parsed.ok) return { ...found, folder: folder ?? location, error: parsed.error }
  return { ...parsed.skill, ...found, files, readFile, warnings: parsed.warnings }
}

export function isSkill(entry: Skill | SkillProblem): entry is Skill {
  return !('error' in entry)
}