discovery

type Skill struct {
	Name           string
	Description    string   // short description from SKILL.md frontmatter or first paragraph
	RawDescription string   // untruncated description from SKILL.md frontmatter or first paragraph
	Source         Source   // optional upstream attribution from SKILL.md frontmatter
	Package        string   // parent package name if skill is a symlink sub-skill (e.g. "gstack")
	LocalPath      string   // absolute path on disk
	ContentHash    string   // deterministic content fingerprint
	Targets        []string // from state if tracked, else inferred from location
	Modified       bool     // SKILL.md hash differs from installed_hash in state
	Conflicted     bool     // SKILL.md contains unresolved merge conflict markers
	Revision       int      // from state
	Managed        bool     // tracked in state AND LocalPath is inside ~/.scribe/skills/
	// IsPackage reports whether this row represents a ~/.scribe/packages/<name>/
	// tree package rather than a regular skill. Packages self-install and
	// don't get projected into tool skill dirs.
	IsPackage bool
}

type SkillMeta struct {
	Name           string
	Description    string
	RawDescription string
	Version        string
	Author         string
	Source         Source
}

type Source struct {
	URL    string `yaml:"url" json:"url,omitempty"`
	Author string `yaml:"author" json:"author,omitempty"`
	Note   string `yaml:"note" json:"note,omitempty"`
}