skill

Documentation

Index

• func RenderLoaded(content Content) string
• func SanitizeRelativePath(rel string) (string, error)
• type Content
  • func ReadFile(ctx context.Context, reg Registry, name, rel string) (Content, error)
• type Descriptor
• type Registry
• type RunResult
  • func RunScript(ctx context.Context, reg Registry, name, rel string, args []string, ...) (RunResult, error)

Functions

func RenderLoaded

func RenderLoaded(content Content) string

RenderLoaded formats a loaded skill for the model, including resource-base guidance.

func SanitizeRelativePath

func SanitizeRelativePath(rel string) (string, error)

SanitizeRelativePath rejects paths that escape a skill bundle directory.

Types

type Content

type Content struct {
	Name        string `json:"name"`
	Description string `json:"description"`
	Body        string `json:"body"`
	Path        string `json:"path"`
}

func ReadFile

func ReadFile(ctx context.Context, reg Registry, name, rel string) (Content, error)

ReadFile loads a supporting file from the skill directory identified by name.

type Descriptor

type Descriptor struct {
	Name        string `json:"name"`
	Description string `json:"description"`
	Path        string `json:"path"`
}

type Registry

type Registry interface {
	List(context.Context) ([]Descriptor, error)
	Load(context.Context, string) (Content, error)
}

type RunResult

type RunResult struct {
	Name     string
	Path     string
	Script   string
	Args     []string
	ExitCode int
	Stdout   string
	Stderr   string
}

RunResult is the outcome of executing one script inside a skill directory.

func RunScript

func RunScript(ctx context.Context, reg Registry, name, rel string, args []string, timeout time.Duration) (RunResult, error)

RunScript executes a script relative to the skill directory identified by name.