skills

package
v1.8.13 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Apr 2, 2026 License: MIT Imports: 14 Imported by: 0

Documentation

Index

Constants

View Source 
const SkillFileName = "SKILL.md"

Variables

This section is empty.

Functions

func BuildSystemPromptInjection 

func BuildSystemPromptInjection(skills []Skill) string

func BuildSystemPromptInjectionForActivePaths added in v1.8.11 

func BuildSystemPromptInjectionForActivePaths(skills []Skill, activePaths []string) string

func BuildSystemPromptInjectionWithTriggers added in v1.8.0 

func BuildSystemPromptInjectionWithTriggers(skills []*Skill) string

Types

type ExecutionMode added in v1.6.4 

type ExecutionMode string

ExecutionMode defines how a group of skills should be executed 

const (
	ModeParallel ExecutionMode = "parallel"
	ModeSerial   ExecutionMode = "serial"
)

type ExecutionPlan added in v1.6.4 

type ExecutionPlan struct {
	Steps []ExecutionStep
}

ExecutionPlan represents the ordered execution of skills

type ExecutionStep added in v1.6.4 

type ExecutionStep struct {
	Mode   ExecutionMode
	Skills []*Skill
}

ExecutionStep represents a single step in an execution plan

type LoadOption added in v1.8.11 

type LoadOption func(*loadConfig)

func WithDedupeByRealpath added in v1.8.11 

func WithDedupeByRealpath(v bool) LoadOption
func WithResolveSymlinks(v bool) LoadOption

type Planner added in v1.6.4 

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

Planner handles skill intention recognition and execution planning

func NewPlanner added in v1.6.4 

func NewPlanner(r *Registry) *Planner

NewPlanner creates a new skill planner

func (*Planner) Plan added in v1.6.4 

func (p *Planner) Plan(ctx context.Context, input string) (*ExecutionPlan, error)

Plan creates an execution plan based on the input text

type Registry added in v1.6.4 

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

Registry manages the registration and lookup of skills

func NewRegistry added in v1.6.4 

func NewRegistry() *Registry

NewRegistry creates a new skill registry

func (*Registry) All added in v1.6.4 

func (r *Registry) All() []*Skill

All returns all registered skills

func (*Registry) Get added in v1.6.4 

func (r *Registry) Get(name string) (*Skill, bool)

Get returns a skill by name

func (*Registry) LoadFromDirs added in v1.8.0 

func (r *Registry) LoadFromDirs(ctx context.Context, l *logger.Logger, dirs []string, opts ...LoadOption) error

LoadFromDirs scans dirs for SKILL.md, loads them and registers into the registry.

func (*Registry) LoadSkills added in v1.6.4 

func (r *Registry) LoadSkills(skills []Skill)

LoadSkills registers a list of skills

func (*Registry) LookupCommand added in v1.6.4 

func (r *Registry) LookupCommand(cmd string) (*Skill, bool)

LookupCommand finds a skill by command trigger (e.g., "/help")

func (*Registry) LookupKeyword added in v1.6.4 

func (r *Registry) LookupKeyword(text string) (*Skill, bool)

LookupKeyword finds a skill by keyword trigger

func (*Registry) MatchAll added in v1.6.4 

func (r *Registry) MatchAll(text string) []*Skill

MatchAll finds all skills matching the input via command, keyword, or regex

func (*Registry) MatchRegex added in v1.6.4 

func (r *Registry) MatchRegex(text string) (*Skill, []string)

MatchRegex finds the first skill matching a regex trigger

func (*Registry) Register added in v1.6.4 

func (r *Registry) Register(skill *Skill)

Register adds a skill to the registry and indexes its triggers

type Skill 

type Skill struct {
	Name         string                 `yaml:"name"`
	Description  string                 `yaml:"description"`
	Path         string                 `yaml:"-"` // Absolute path to the SKILL.md file
	Content      string                 `yaml:"-"` // The markdown content (instructions)
	Triggers     []Trigger              `yaml:"triggers"`
	Tags         []string               `yaml:"tags"`
	Priority     int                    `yaml:"priority"`
	Timeout      time.Duration          `yaml:"timeout"`
	Retries      int                    `yaml:"retries"`
	Fallback     string                 `yaml:"fallback"`
	Dependencies []string               `yaml:"dependencies"`
	Metadata     map[string]interface{} `yaml:"metadata,omitempty"`
	Paths        []string               `yaml:"paths"`
	WhenToUse    string                 `yaml:"when_to_use"`
	AllowedTools []string               `yaml:"allowed_tools"`
}

Skill represents a loaded AgentSkill

func FilterSkillsForActivePaths added in v1.8.11 

func FilterSkillsForActivePaths(skills []Skill, activePaths []string) []Skill

func LoadSkillsFromDirs 

func LoadSkillsFromDirs(ctx context.Context, l *logger.Logger, dirs []string, opts ...LoadOption) ([]Skill, error)

LoadSkillsFromDirs scans the provided directories for **/SKILL.md files and loads them (opencode-compatible).

func (*Skill) MatchesPath added in v1.8.11 

func (s *Skill) MatchesPath(filePath string) bool

type Trigger added in v1.6.4 

type Trigger struct {
	Type    string `yaml:"type"`
	Pattern string `yaml:"pattern"`
}

Trigger represents a skill activation trigger

Source Files

View all Source files

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.