skills

type ActivateSkillError struct {
	Code            string `json:"code,omitempty"`
	Message         string `json:"message,omitempty"`
	AvailableSkills string `json:"available_skills,omitempty"`
}

type ActivateSkillErrorResponse struct {
	Error ActivateSkillError `json:"error,omitempty"`
}

type ActivateSkillRequest struct {
	Name string `json:"name" jsonschema:"required,title=Name,description=The name of the skill to activate."`
}

type ActivateSkillResponse struct {
	Skill        string `json:"skill,omitempty"`
	Instructions string `json:"instructions,omitempty"`
	Location     string `json:"location,omitempty"`
}

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

type AgentConfig struct {
	// Disabled specifies to skip the agent to load skills.
	Disabled bool `json:"disabled,omitempty" yaml:"disabled,omitempty"`
	// Paths specifies additional directories or tar archives to search for
	// skills for the agent. They are searched after Config.Paths, and a
	// skill found directly in one (./<skill>/SKILL.md) belongs to this agent
	// unless its frontmatter names other agents. ./.<agent>/ folders inside
	// still assign their skills to the agent they name.
	// Later directories override earlier ones when two skills share the same name.
	Paths []string `json:"paths,omitempty" yaml:"paths,omitempty"`
}

type Config struct {
	// Strict mode enforces that an error is returned if a skill is invalid or failed to parse.
	Strict bool `json:"strict,omitempty" yaml:"strict,omitempty"`
	// EnableDefaultSkills enables the default skills,
	// when the skill path does not include Agent name or Skill does not specify Agents field.
	EnableDefaultSkills bool `json:"enable_default_skills,omitempty" yaml:"enable_default_skills,omitempty"`
	// EnableStandardPaths enables to discover the standard paths for skills:
	//	~/.agents/skills/.<agent>/<skill>/...
	//	~/.agents/.<clientName>/skills/.<agent>/<skill>/...
	//	<cwd>/.agents/skills/.<agent>/<skill>/...
	//	<cwd>/.agents/.<clientName>/skills/.<agent>/<skill>/...
	//
	// If EnableStandardPaths is false, then only the Paths and Agents.Paths are used.
	EnableStandardPaths bool `json:"enable_standard_paths,omitempty" yaml:"enable_standard_paths,omitempty"`
	// Paths specifies the paths to search for skills.
	// The following pattern is applied to paths:
	//	./<skill>/...
	//	./.<agent>/<skill>/...
	// Later directories override earlier ones when two skills share the same name.
	Paths []string `json:"paths,omitempty" yaml:"paths,omitempty"`
	// Agents specifies override configuration for agents.
	// If an agent configuration is present, then it will override the default configuration.
	Agents map[string]*AgentConfig `json:"agents,omitempty" yaml:"agents,omitempty"`
}

type Frontmatter struct {
	Name          string `yaml:"name"`
	Description   string `yaml:"description"`
	License       string `yaml:"license"`
	Compatibility string `yaml:"compatibility"`
	// AllowedTools is a space or comma separated list of tool names that are allowed to be used in the skill.
	AllowedTools string `yaml:"allowed-tools"`
	// Agents is a space or comma separated list of agent names that are allowed to use this skill.
	Agents string `yaml:"agents"`
	// Tags is a space or comma separated list of tags for filtering skills.
	Tags string `yaml:"tags"`
	// Metadata is a map of key-value pairs for additional metadata.
	Metadata map[string]string `yaml:"metadata"`
}

type Loader interface {
	// ClientName returns the name of the client that owns the skills.
	ClientName() string
	// Skills returns all loaded skills for the given agent sorted alphabetically by name.
	// Use tags to filter skills by tags. The Skill must have all the tags provided.
	Skills(agent string, tags ...string) Skills
	// Agents returns a list agents names for which skills are loaded.
	Agents() []string
}

type Skill struct {
	Name         string
	Description  string
	AllowedTools []string
	Agents       []string
	Tags         []string
	Metadata     map[string]string
	// Body is the markdown body after the frontmatter block
	Body string
	// Location is the relative path to the skill directory
	Location string
	// contains filtered or unexported fields
}

type Skills []*Skill