skills

type Frontmatter struct {
	Name        string         `yaml:"name"`
	Description string         `yaml:"description"`
	Metadata    map[string]any `yaml:"metadata"`
}

type GitSource struct {
	URL         string // Git clone URL
	Ref         string // Branch/tag reference (optional)
	Subpath     string // Path within repo (optional)
	SkillFilter string // Skill name filter (optional)
}

type HTTPClient interface {
	Do(*http.Request) (*http.Response, error)
}

type HostProvider interface {
	// ID returns a unique identifier for this provider (e.g., "mintlify", "huggingface")
	ID() string

	// DisplayName returns a human-readable name for this provider
	DisplayName() string

	// Match checks if a URL belongs to this provider
	Match(url string) ProviderMatch

	// FetchSkill fetches and parses a skill from the given URL
	FetchSkill(ctx context.Context, url string, client HTTPClient) (*RemoteSkill, error)

	// ToRawURL converts a user-facing URL to a raw content URL
	ToRawURL(url string) string

	// GetSourceIdentifier returns a stable identifier for telemetry/storage
	GetSourceIdentifier(url string) string
}

type LocalSkillDir struct {
	Path      string // Full path to skill directory
	SkillName string // Name of the skill (directory name)
}

type ParsedSource struct {
	Type        SourceType // github, gitlab, git, local, direct-url, well-known
	URL         string     // Git URL or HTTP URL
	LocalPath   string     // For local sources (resolved absolute path)
	Ref         string     // Branch/tag reference (optional)
	Subpath     string     // Path within repo (optional)
	SkillFilter string     // From @skill syntax (optional)
}

type ProviderMatch struct {
	Matches          bool
	SourceIdentifier string
}

type ProviderRegistry struct {
	// contains filtered or unexported fields
}

type RemoteSkill struct {
	Name        string            // Display name from frontmatter
	Description string            // Description from frontmatter
	Content     string            // Full SKILL.md content
	InstallName string            // Directory name for installation
	SourceURL   string            // Original source URL
	Files       map[string]string // Additional files (for well-known multi-file skills)
	Metadata    map[string]any    // Extra frontmatter data
}

type SearchResult struct {
	ID       string `json:"id"`
	SkillID  string `json:"skillId"`
	Name     string `json:"name"`
	Installs int    `json:"installs"`
	Source   string `json:"source"`
}

type SourceType string

type WellKnownIndex struct {
	Skills []WellKnownSkillEntry `json:"skills"`
}

type WellKnownSkill struct {
	RemoteSkill
	IndexEntry WellKnownSkillEntry
}

type WellKnownSkillEntry struct {
	Name        string   `json:"name"`
	Description string   `json:"description"`
	Files       []string `json:"files"`
}