Skill Type Definitions

type SkillStatus = 'experimental' | 'stable';

// Install method for a skill
// - 'npx-single': npx skills add <owner>/<repo>
// - 'npx-multi': npx skills add <url> --skill <name>
// - 'download': No repo, show download button
type SkillInstallMethod = 'npx-single' | 'npx-multi' | 'download';

type Skill = {
  id: string;                    // Derived from directory name
  name: string;                  // From frontmatter (required)
  description: string;           // From frontmatter (required)
  author?: string;               // From frontmatter
  version?: string;              // From frontmatter
  status: SkillStatus;           // From frontmatter (default: 'stable')
  tags: string[];                // From frontmatter (default: [])
  sourceUrl?: string;            // From frontmatter - optional external source URL
  content: string;               // Markdown content after frontmatter
  hasSupporting: boolean;        // Computed: has files beyond SKILL.md
  supportingFiles: string[];     // Computed: list of supporting file paths
  installMethod: SkillInstallMethod; // Computed based on source
  installCommand?: string;       // Computed: npx command
  viewSourceUrl: string;         // Computed: GitHub link to skill source
  repoUrl: string;               // Repository URL (Agent-Skills for official, sourceUrl for external)
  isCommunity: boolean;          // True if author is not "goose" (community-contributed)
};