Versions in this module Expand all Collapse all v0 v0.0.6 Mar 23, 2026 Changes in this version + var ErrDefaultBranchNotFound = errors.New("default branch not found") v0.0.5 Mar 18, 2026 v0.0.3 Mar 17, 2026 Changes in this version type GetOptions + BundledSkills []Skill type ListOptions + BundledSkills []Skill v0.0.2 Feb 27, 2026 v0.0.1 Feb 20, 2026 Changes in this version + var ErrAgentDiscoveryRequired = errors.New("target dirs are required when agent discovery is disabled") + var ErrHomeNotFound = errors.New("home directory not found") + var ErrMissingDescription = errors.New("frontmatter missing description") + var ErrMissingFrontmatter = errors.New("missing frontmatter") + var ErrMissingName = errors.New("frontmatter missing name") + var ErrMultipleSkills = errors.New("multiple skills found; specify --skill or --yes") + var ErrMultipleWellKnown = errors.New("multiple well-known skills found; specify --skill or --yes") + var ErrNoSkillsFound = errors.New("no skills found") + var ErrNoSkillsSpecified = errors.New("no skills specified") + var ErrNoTargetDirs = errors.New("no target dirs specified") + var ErrNoWellKnownIndex = errors.New("no well-known skills index found") + var ErrSkillAlreadyExists = errors.New("SKILL.md already exists") + var ErrSkillNameRequired = errors.New("skill name is required") + var ErrSkillNotFound = errors.New("skill not found") + var ErrSourceRequired = errors.New("source is required") + var ErrUnknownInstallMode = errors.New("unknown install mode") + var ErrUnrecognizedSource = errors.New("unrecognized source format") + var ErrUnsafeFilePath = errors.New("unsafe file path in well-known index") + var ErrUnsupportedSourceType = errors.New("unsupported source type") + func AddSkillToLock(lock *SkillLock, installName string, entry LockEntry) + func AgentSkillsDir(agent AgentType, global bool, cwd string) (string, error) + func CanonicalSkillsDir(global bool, cwd string) (string, error) + func ClaudeHome() (string, error) + func CodexHome() (string, error) + func FetchGitHubSkillFolderHash(ctx context.Context, ownerRepo string, skillPath string, token string) (string, error) + func GetGitHubToken() string + func HomeDir() (string, error) + func Init(opts InitOptions) (string, error) + func IsUniversalAgent(agent AgentType) (bool, error) + func RemoveSkillFromLock(lock *SkillLock, installName string) + func SkillLockPath() (string, error) + func SkillsAPIURL() string + func WriteSkillLock(lock *SkillLock) error + func XDGConfigHome() (string, error) + type AddOptions struct + Agents []AgentType + All bool + Dirs []string + EnableAgentDiscovery bool + FullDepth bool + Global bool + ListOnly bool + Mode InstallMode + Skills []string + Source string + Yes bool + type AddResult struct + Available []Skill + Installed []InstalledSkill + func Add(ctx context.Context, opts AddOptions) (AddResult, error) + type AgentConfig struct + DetectGlobalPath string + DetectProjectPath string + DisplayName string + GlobalSkillsDir string + Name AgentType + ProjectSkillsDir string + ShowInUniversal bool + func AgentConfigFor(agent AgentType) (AgentConfig, error) + type AgentType string + func AllAgentTypes() []AgentType + func DetectInstalledAgents(cwd string) ([]AgentType, error) + type GetOptions struct + Agents []AgentType + Dirs []string + EnableAgentDiscovery bool + Global bool + Skill string + type GetResult struct + InstallName string + Skill Skill + func Get(opts GetOptions) (GetResult, error) + type InitOptions struct + Dir string + Name string + type InstallMode string + const InstallModeCopy + const InstallModeSymlink + type InstalledSkill struct + Agents []AgentType + Description string + Global bool + InstallName string + Name string + Source SkillSource + type ListOptions struct + Agents []AgentType + Dirs []string + EnableAgentDiscovery bool + Global bool + type ListedSkill struct + Agents []AgentType + Description string + Global bool + InstallName string + Name string + func List(opts ListOptions) ([]ListedSkill, error) + type LockEntry struct + InstalledAt time.Time + SkillFolderHash string + SkillPath string + Source SkillSource + SourceType string + SourceURL string + UpdatedAt time.Time + func (e *LockEntry) UnmarshalJSON(b []byte) error + type RemoveOptions struct + Agents []AgentType + All bool + Dirs []string + EnableAgentDiscovery bool + Global bool + Skills []string + Yes bool + type RemoveResult struct + Removed []InstalledSkill + func Remove(opts RemoveOptions) (RemoveResult, error) + type SearchResult struct + ID string + Installs int + Name string + SkillID string + Source string + func Search(ctx context.Context, query string, limit int) ([]SearchResult, error) + func SearchSkills(ctx context.Context, query string, limit int) ([]SearchResult, error) + func (r *SearchResult) UnmarshalJSON(b []byte) error + type Skill struct + AllowedTools []string + Compatibility string + Content string + Description string + Dir string + Metadata map[string]any + Name string + func DiscoverSkills(baseDir string, fullDepth bool) ([]Skill, error) + func FetchDirectSkillToDir(ctx context.Context, skillURL string) (dir string, skill Skill, installName string, err error) + func FetchWellKnownSkillToDir(ctx context.Context, resolvedBase string, entry WellKnownSkillEntry) (dir string, skill Skill, installName string, err error) + func ParseSkillMarkdown(content string) (Skill, error) + type SkillLock struct + Dismissed map[string]bool + LastSelectedAgents []AgentType + Skills map[string]LockEntry + func ReadSkillLock() (*SkillLock, error) + func (l *SkillLock) UnmarshalJSON(b []byte) error + type SkillSource struct + InstallName string + Owner string + ProviderID string + Ref string + Repo string + SkillFilter string + SourceURL string + Subpath string + Type SkillSourceType + WellKnownURL string + func ParseSource(input string) (SkillSource, error) + func (s *SkillSource) UnmarshalJSON(b []byte) error + type SkillSourceType string + const SkillSourceTypeDirectURL + const SkillSourceTypeGit + const SkillSourceTypeGitHub + const SkillSourceTypeGitLab + const SkillSourceTypeLocal + const SkillSourceTypeSearchHint + const SkillSourceTypeWellKnown + type UpdateCheck struct + CurrentHash string + Entry LockEntry + InstallName string + RemoteHash string + func CheckUpdates(ctx context.Context) ([]UpdateCheck, error) + func Update(ctx context.Context) ([]UpdateCheck, error) + type WellKnownIndex struct + Skills []WellKnownSkillEntry + func FetchWellKnownIndex(ctx context.Context, baseURL string) (index WellKnownIndex, resolvedBase string, err error) + type WellKnownSkillEntry struct + Description string + Files []string + Name string