skill

Documentation

Overview

Package skill implements the offline Agent Skill workflow.

Index

• Constants
• func Execute(ctx context.Context, options Options, bundle Bundle) (int, error)
• type Bundle
  • func NewBundle(fetchVersion string, files []File) (Bundle, error)
• type File
• type Options

Constants

const (
	SkillVersion = "1"
)

Functions

func Execute

func Execute(ctx context.Context, options Options, bundle Bundle) (int, error)

Execute runs exactly one skill action and returns its process status.

Types

type Bundle

type Bundle struct {
	FetchVersion string
	Files        []File
}

Bundle is the embedded, read-only skill payload.

func NewBundle

func NewBundle(fetchVersion string, files []File) (Bundle, error)

NewBundle validates and copies embedded files. It also validates the evaluation fixture so a broken skill cannot be built into a release.

type File

type File struct {
	Path string
	Data []byte
}

File is one file in the portable skill bundle. Path uses forward slashes.

type Options

type Options struct {
	Print          bool
	InstallAgent   string
	UninstallAgent string
	Scope          string
	Force          bool
	DryRun         bool

	HomeDir     string
	ProjectDir  string
	Stdin       io.Reader
	Stdout      io.Writer
	Stderr      io.Writer
	Interactive bool
}

Options controls one skill action. Writers and paths are injectable to keep the filesystem workflow deterministic in tests.