skills

type Activation struct {
	Skill  *Skill
	Score  float64
	Reason string
}

type ActivationContext struct {
	Prompt   string
	Channels []string
	Tags     map[string]string
	Traits   []string
	Metadata map[string]any
}

type Definition struct {
	Name        string
	Description string
	Priority    int
	MutexKey    string
	// DisableAutoActivation keeps the skill available for manual invocation
	// while excluding it from automatic activation matching.
	DisableAutoActivation bool
	Metadata              map[string]string
	Matchers              []Matcher
}

type Handler interface {
	Execute(context.Context, ActivationContext) (Result, error)
}

type HandlerFunc func(context.Context, ActivationContext) (Result, error)

type KeywordMatcher struct {
	All []string
	Any []string
}

type LoaderOptions struct {
	ProjectRoot string
	// Deprecated: user-level scanning has been removed; this field is ignored.
	UserHome string
	// Deprecated: user-level scanning has been removed; this flag is ignored.
	EnableUser bool
	// FS is the filesystem abstraction layer for loading skills.
	// If nil, falls back to os.* functions for backward compatibility.
	FS *config.FS
}

type MatchResult struct {
	Matched bool
	Score   float64
	Reason  string
}

type Matcher interface {
	Match(ActivationContext) MatchResult
}

type MatcherFunc func(ActivationContext) MatchResult

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

type Result struct {
	Skill    string
	Output   any
	Metadata map[string]any
}

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

type SkillFile struct {
	Name     string
	Path     string
	Metadata SkillMetadata
	// contains filtered or unexported fields
}

type SkillMetadata struct {
	Name          string            `yaml:"name"`
	Description   string            `yaml:"description"`
	License       string            `yaml:"license,omitempty"`
	Compatibility string            `yaml:"compatibility,omitempty"`
	Metadata      map[string]string `yaml:"metadata,omitempty"`
	AllowedTools  ToolList          `yaml:"allowed-tools,omitempty"`
}

type SkillRegistration struct {
	Definition Definition
	Handler    Handler
}

type TagMatcher struct {
	Require map[string]string
	Exclude map[string]string
}

type ToolList []string

type TraitMatcher struct {
	Traits []string
}