skill

type InstalledHook func(name, path string, scope Scope)

type Options struct {
	HomeDir         string
	ProjectRoot     string
	CustomPaths     []string
	ExcludedPaths   []string
	DisabledNames   []string
	MaxDepth        int
	DisableBuiltins bool // suppress shipped built-ins (test-only knob)
	// Stderr is the writer for diagnostic warnings. When nil, defaults to
	// os.Stderr. Set to io.Discard to suppress output (e.g. during model
	// switch inside a bubbletea session).
	Stderr io.Writer
	// StateDir is the directory holding skill_usage.json (cross-session usage
	// tracking for cold-skill retirement). Empty disables usage tracking —
	// Store.Usage() then returns a no-op tracker.
	StateDir string
	// LegacyStatePath is a pre-profile-partition fallback location read when
	// StateDir's file is absent, so usage recorded before the session dir moved
	// isn't lost. Empty = no fallback.
	LegacyStatePath string
}

type PathStatus string

type ProfileResolver func(sk Skill) *event.Profile

type Root struct {
	Dir      string
	Scope    Scope
	Priority int
	Status   PathStatus
}

type RunAs string

type Scope string

type Skill struct {
	Name        string // canonical identifier; matches the directory / filename stem
	Description string // one-liner shown in the pinned index
	Body        string // full markdown body (post-frontmatter), loaded eagerly
	Scope       Scope  // where it came from
	Path        string // absolute path to the SKILL.md / <name>.md, or "(builtin)"
	// AllowedTools, when non-empty, scopes a subagent skill's tool registry to
	// these literal tool names (from the `allowed-tools` frontmatter).
	AllowedTools []string
	RunAs        RunAs  // inline | subagent
	Model        string // optional model override for runAs=subagent (frontmatter `model:`)
	Effort       string // optional effort for runAs=subagent (frontmatter `effort:`)
	// Disabled marks a skill the user turned off. It stays in the pinned skills
	// index (so the model knows it exists and can suggest re-enabling) but is
	// not callable via run_skill until re-enabled. Set by callers building the
	// index from the full (unfiltered) store; the filtered store still omits
	// disabled skills entirely, keeping them uncallable.
	Disabled bool
	// ProfileHidden marks a skill the active product profile's whitelist hides
	// (e.g. the dev/coding profile hides office skills), NOT a user choice.
	// Unlike Disabled, a profile-hidden skill is fully OMITTED from the pinned
	// index: the model neither sees it nor suggests re-enabling it, since the
	// user didn't turn it off — switching profile brings it back automatically.
	// This keeps the coding model's prompt free of office-skill descriptions the
	// user never asked to see. It is still uncallable (the live store filters it
	// via the profile-disabled name set). Set by callers (boot) when applying a
	// profile whitelist; mutually exclusive with Disabled for the same skill.
	ProfileHidden bool
	// Cold marks a skill whose last use is older than the configured retirement
	// threshold, so the index tags it [休眠]. Set by callers (boot) from a
	// UsageTracker; built-in skills are never marked cold. Cosmetic only — a
	// cold skill is still callable, just de-emphasized in the prompt index.
	Cold bool
}

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

type SubagentRunOptions struct {
	ContinueFrom string
	ForkFrom     string
}

type SubagentRunner func(ctx context.Context, sk Skill, task string, opts SubagentRunOptions) (string, error)

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