skills

type DiscoveredSkill struct {
	Name        string        // Skill name (directory name)
	Path        string        // Full path in repo (e.g., "skills/remotion")
	Description string        // Description from SKILL.md if available
	FileCount   int           // Total file count including subdirectories
	RepoRef     GitHubRepoRef // Reference to the source repository
}

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

type GitHubContent struct {
	Name        string `json:"name"`
	Path        string `json:"path"`
	Type        string `json:"type"` // "file" or "dir"
	Size        int    `json:"size"`
	DownloadURL string `json:"download_url"`
	URL         string `json:"url"` // API URL for this content
}

type GitHubRepoRef struct {
	Owner  string // Repository owner (user or org)
	Repo   string // Repository name
	Branch string // Branch name (default: "main", fallback: "master")
	Path   string // Path within repo to look for skills (default: "skills")
}

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

type RegistryConfig struct {
	// AutoInvoke allows model-driven skill activation
	AutoInvoke bool

	// MetadataBudgetTokens limits skill metadata in system prompt
	MetadataBudgetTokens int

	// MaxVisibleSkills limits skills shown in system prompt metadata
	MaxVisibleSkills int

	// Ecosystem integration
	IncludeProjectSkills  bool // Discover from project-local paths
	IncludeEcosystemPaths bool // Include ~/.agents/skills, ~/.codex/skills, ~/.claude/skills, ~/.gemini/skills, .skills/

	// Skill lists
	AlwaysEnabled []string // Always include in metadata
	NeverAuto     []string // Must be explicit
}

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

type RemoteSearchResult struct {
	Success bool `json:"success"`
	Data    struct {
		Skills []RemoteSkill `json:"skills"`
		Total  int           `json:"total"`
		Page   int           `json:"page"`
	} `json:"data"`
	// Flattened for convenience
	Skills []RemoteSkill `json:"-"`
}

type RemoteSkill struct {
	ID          string  `json:"id"`
	Name        string  `json:"name"`
	Description string  `json:"description"`
	Author      string  `json:"author"`
	Repository  string  `json:"githubUrl"` // GitHub URL
	Category    string  `json:"category"`
	Downloads   int     `json:"downloads"`
	Stars       int     `json:"stars"`
	URL         string  `json:"skillUrl"` // SkillsMP page URL
	RawURL      string  `json:"rawUrl"`   // Direct SKILL.md URL
	License     string  `json:"license"`
	UpdatedAt   float64 `json:"updatedAt"` // Unix timestamp
}

type Setup struct {
	Registry    *Registry
	XML         string   // Pregenerated <available_skills> XML (populated lazily)
	Skills      []*Skill // Skills included in metadata (populated lazily)
	TotalSkills int      // Total auto-invocable skills discovered (populated lazily)
	HasOverflow bool     // True when more skills exist than are shown (populated lazily)
	// contains filtered or unexported fields
}

type SetupOptions struct {
	// PromptMetadataSuppressed means the caller already has <available_skills>
	// metadata from another source (for example AGENTS.md). In that case setup only
	// verifies that at least one skill exists so activate_skill/search_skills can be
	// registered, and skips the full prompt catalog preload.
	PromptMetadataSuppressed bool

	// PromptMetadataSuppressionKnown records whether PromptMetadataSuppressed came
	// from an actual check. It lets callers avoid repeating the same AGENTS.md read
	// before deciding whether to inject metadata.
	PromptMetadataSuppressionKnown bool
}

type Skill struct {
	// Required fields
	Name        string `yaml:"name"`
	Description string `yaml:"description"`

	// Optional standard fields
	License       string            `yaml:"license,omitempty"`
	Compatibility string            `yaml:"compatibility,omitempty"`
	AllowedTools  []string          `yaml:"-"` // Parsed from allowed-tools
	Metadata      map[string]string `yaml:"metadata,omitempty"`

	// Tools declares script-backed tools that are registered when this skill is activated.
	Tools []SkillToolDef `yaml:"-"`

	// Extras stores vendor-specific/unknown frontmatter fields
	Extras map[string]any `yaml:"-"`

	// Body is the Markdown content after frontmatter
	Body string `yaml:"-"`

	// Resource discovery
	References []string `yaml:"-"` // Files in references/
	Scripts    []string `yaml:"-"` // Files in scripts/
	Assets     []string `yaml:"-"` // Files in assets/

	// Source tracking
	Source     SkillSource `yaml:"-"`
	SourcePath string      `yaml:"-"` // Directory path
	// contains filtered or unexported fields
}

type SkillSource int

type SkillToolDef struct {
	// Name is the tool name shown to the LLM. Must match ^[a-z][a-z0-9_]*$
	Name string `yaml:"name"`

	// Description is the tool description passed to the LLM.
	Description string `yaml:"description"`

	// Script is the path to the script, relative to the skill directory.
	// Subdirectories are allowed (e.g. "scripts/travel-time.sh").
	Script string `yaml:"script"`

	// Input is a JSON Schema (type: object) for the tool's input parameters.
	// If omitted, the tool accepts no parameters.
	Input map[string]interface{} `yaml:"input,omitempty"`

	// TimeoutSeconds is the execution timeout. Default 30, max 300.
	TimeoutSeconds int `yaml:"timeout_seconds,omitempty"`

	// Env is a map of additional environment variables to set when running the script.
	Env map[string]string `yaml:"env,omitempty"`

	// Call controls how arguments are passed to the script.
	//   ""       / "args"       — named flags: --key value (default)
	//   "positional"            — positional args in schema property order
	//   "json"                  — JSON object on stdin
	Call string `yaml:"call,omitempty"`
}