Method MatchSkills

skills/loader.go:147–221

MatchSkills returns skills relevant to a given intent category, file list, and languages. Results are sorted by score descending, capped at topK.

(category string, files []string, languages []string, topK int)

// MatchSkills returns skills relevant to a given intent category, file list, and languages.
// Results are sorted by score descending, capped at topK.
func (idx *SkillIndex) MatchSkills(category string, files []string, languages []string, topK int) []MatchResult {
	if idx == nil || len(idx.Skills) == 0 {
		return nil
	}

	type scored struct {
		skill  *Skill
		score  int
		reason string
	}

	var candidates []scored

	for i := range idx.Skills {
		s := &idx.Skills[i]
		score := 0
		var reasons []string

		// Keyword match with intent category
		for _, kw := range s.Meta.Keywords {
			if strings.EqualFold(kw, category) {
				score += 3
				reasons = append(reasons, "category:"+category)
			}
		}

		// Language match
		for _, lang := range languages {
			for _, sl := range s.Meta.Languages {
				if strings.EqualFold(sl, lang) {
					score += 2
					reasons = append(reasons, "language:"+lang)
				}
			}
		}

		// Path pattern match
		for _, pattern := range s.Meta.PathPatterns {
			for _, file := range files {
				if matchPath(pattern, file) {
					score += 1
					reasons = append(reasons, "path:"+file)
				}
			}
		}

		// Priority boost — only applied when there's a real signal
		if score > 0 {
			score += s.Meta.Priority / 5
		}

		if score > 0 {
			reason := strings.Join(reasons, ", ")
			candidates = append(candidates, scored{skill: s, score: score, reason: reason})
		}
	}

	// Sort by score descending, then by name for stability