Function LoadSkills

skills/loader.go:23–59

LoadSkills discovers SKILL.md and *.md files from multiple sources in priority order: 1. Builtin (embedded in binary) 2. Project-local (.codemap/skills/) 3. Global (~/.codemap/skills/) Later sources override earlier ones if they share the same name.

(root string)

// 3. Global (~/.codemap/skills/)
// Later sources override earlier ones if they share the same name.
func LoadSkills(root string) (*SkillIndex, error) {
	var all []Skill

	// 1. Builtin skills (embedded)
	builtins, err := loadBuiltinSkills()
	if err != nil {
		return nil, err
	}
	all = append(all, builtins...)

	// 2. Project-local skills
	projectDir := filepath.Join(root, ".codemap", "skills")
	projectSkills, _ := loadSkillsFromDir(projectDir, projectSource)
	all = append(all, projectSkills...)

	// 3. Global skills
	home, _ := os.UserHomeDir()
	if home != "" {
		globalDir := filepath.Join(home, ".codemap", "skills")
		globalSkills, _ := loadSkillsFromDir(globalDir, globalSource)
		all = append(all, globalSkills...)
	}

	// Deduplicate: later sources win (project overrides builtin, global overrides project)
	seen := make(map[string]int) // name -> index in deduped
	var deduped []Skill
	for _, s := range all {
		if idx, exists := seen[s.Meta.Name]; exists {
			deduped[idx] = s // replace
		} else {
			seen[s.Meta.Name] = len(deduped)
			deduped = append(deduped, s)
		}
	}

	return newIndex(deduped), nil
}

// loadSkillsFromDir reads all .md files in a directory as skills.
func loadSkillsFromDir(dir, source string) ([]Skill, error) {