Function discoverEntities

internal/cli/management.go:1682–1730

discoverEntities walks a directory and finds entities using the same conventions as `gh skill install --from-local`: 1. skills/*/SKILL.md → standard flat layout 2. skills/{scope}/*/SKILL.md → namespaced layout 3. {prefix}/skills/*/SKILL.md → deeply nested skills/ dir 4. */SKILL.md

(kind entities.Kind, root string)

// Hidden directories (dot-prefixed like .claude/, .github/) are skipped.
// Duplicates (same name) are deduplicated — first discovered wins.
func discoverEntities(kind entities.Kind, root string) []discoveredItem {
	fileTarget := defaultManifestName(kind)
	seen := make(map[string]bool)
	var items []discoveredItem

	_ = filepath.WalkDir(root, func(p string, d os.DirEntry, err error) error {
		if err != nil {
			return err
		}

		// Skip hidden directories (dot-prefixed).
		if d.IsDir() && strings.HasPrefix(d.Name(), ".") {
			return filepath.SkipDir
		}
		if d.IsDir() {
			return nil
		}

		if filepath.Base(p) != fileTarget {
			return nil
		}

		// Get path relative to root for convention matching.
		relPath, relErr := filepath.Rel(root, p)
		if relErr != nil {
			return nil
		}
		relPath = filepath.ToSlash(relPath)

		// Check if path matches a known skill convention.
		if !matchesSkillConvention(relPath) {
			return nil
		}

		name := filepath.Base(filepath.Dir(p))
		if seen[name] {
			return nil // deduplicate
		}
		seen[name] = true

		data, readErr := os.ReadFile(p)
		if readErr != nil {
			return nil
		}
		items = append(items, discoveredItem{name: name, content: string(data), path: p})
		return nil
	})
	return items
}

// matchesSkillConvention checks whether a relative SKILL.md path matches
// any recognized skill directory convention, mirroring `gh skill install`