Documentation
¶
Index ¶
- func DirectoryMismatchWarning(name, directoryName string) string
- func DiscoveryRoots(root string) []string
- func FormatForPrompt(skills []Skill) string
- func ParseSlashCommand(text string) (string, bool)
- func SystemSkillsRoot() (string, error)
- type Invocation
- type Skill
- func Discover(root string) ([]Skill, error)
- func DiscoverPersonal() ([]Skill, error)
- func FindSkill(name string, skills []Skill) *Skill
- func LoadBundled(fsys fs.FS, root string) ([]Skill, error)
- func LoadBundledAt(fsys fs.FS, root, locationRoot string) ([]Skill, error)
- func LoadDir(dir string) []Skill
- func LoadFile(path string) (Skill, error)
- func Merge(bundled, discovered []Skill) []Skill
- func MustDiscover(root string) []Skill
- func MustDiscoverPersonal() []Skill
- func Rediscover(root string) ([]Skill, error)
- func RediscoverPersonal() ([]Skill, error)
- func (s *Skill) AbsoluteDir(workDir string) string
- func (s *Skill) ApplySubstitutions(content, args, skillDir, projectDir string) string
- func (s *Skill) GetContent(workingDir string) (string, error)
- func (s *Skill) InvocationHint() string
- func (s *Skill) Portable() bool
- func (s *Skill) Qualified() string
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func DirectoryMismatchWarning ¶ added in v0.17.1
DirectoryMismatchWarning returns a human-readable warning when a skill's frontmatter name differs from its containing directory name, matching the Agent Skills specification's naming convention without rejecting the skill the way Claude Code and other implementations tolerate the mismatch too. It returns "" when the names match.
func DiscoveryRoots ¶ added in v0.15.0
DiscoveryRoots returns every directory that can contribute skills to a workspace. Callers use it to grant narrow resource access before a root is created, so skills generated after a session starts remain usable.
func FormatForPrompt ¶
func ParseSlashCommand ¶ added in v0.12.9
ParseSlashCommand returns the name of a leading Wingman slash command.
func SystemSkillsRoot ¶ added in v0.15.3
SystemSkillsRoot returns Wingman's reserved bundled-skill directory.
Types ¶
type Invocation ¶ added in v0.11.7
func Invocations ¶ added in v0.11.7
func Invocations(text string, skills []Skill) []Invocation
Invocations returns every /skill or Codex $skill mention, deduplicated in order of first appearance. A mention only counts when its sigil starts a word, so paths and URLs never match.
func (Invocation) Instructions ¶ added in v0.11.7
func (inv Invocation) Instructions(workDir string) (string, error)
Instructions loads the invoked skill into the <skill-instructions> block attached (hidden) to the message invoking it.
type Skill ¶
type Skill struct {
Name string `yaml:"name"`
Description string `yaml:"description"`
License string `yaml:"license"`
Compatibility string `yaml:"compatibility"`
Metadata map[string]string `yaml:"metadata"`
AllowedTools []string `yaml:"allowed-tools"`
Arguments []string `yaml:"-"`
ArgumentHint string `yaml:"-"`
Location string `yaml:"-"`
Content string `yaml:"-"`
Bundled bool `yaml:"-"`
Plugin string `yaml:"-"`
// contains filtered or unexported fields
}
func DiscoverPersonal ¶ added in v0.6.2
func FindSkill ¶ added in v0.6.2
FindSkill resolves either a bare skill name or a "<plugin>:<skill>" name. A qualified query never falls back to a bare match, so it always reaches the plugin's own skill even when another source shadows the bare name.
func LoadBundledAt ¶ added in v0.12.4
LoadBundledAt loads bundled skill metadata and assigns each skill the corresponding directory beneath locationRoot. The caller owns copying the complete resource tree to that location.
func LoadDir ¶ added in v0.12.9
LoadDir loads skills beneath dir. Directories without SKILL.md are grouping directories and are traversed recursively; a skill directory is a leaf so supporting resources below it cannot be mistaken for additional skills. Symbolic links and Windows junctions are followed once, with their resolved paths used to prevent cycles.
func Merge ¶ added in v0.6.2
Merge layers discovered skills over bundled ones by name. A shadowed plugin skill is kept, but moved behind the winner so only its qualified name resolves; anything else that loses its name is dropped.
func MustDiscover ¶ added in v0.6.2
func MustDiscoverPersonal ¶ added in v0.6.2
func MustDiscoverPersonal() []Skill
func Rediscover ¶ added in v0.15.0
Rediscover repeats project discovery without reprinting diagnostics already reported at startup. It is intended for runtime catalog reconciliation.
func RediscoverPersonal ¶ added in v0.15.0
RediscoverPersonal repeats personal discovery without reprinting diagnostics already reported at startup.
func (*Skill) AbsoluteDir ¶ added in v0.6.2
func (*Skill) ApplySubstitutions ¶ added in v0.12.9
ApplySubstitutions renders Wingman's body-only skill extensions. The neutral directory variables have Claude-compatible aliases; argument behavior follows Claude Code, including zero-based indexed arguments and fallback appending.
func (*Skill) GetContent ¶ added in v0.6.2
func (*Skill) InvocationHint ¶ added in v0.12.9
InvocationHint returns the explicit Claude-compatible argument hint or a neutral hint derived from the declared positional argument names.
func (*Skill) Portable ¶ added in v0.12.9
Portable reports whether the skill frontmatter uses only Agent Skills fields.
Source Files