// Package skills provides skill discovery and semantic matching.
//
// Skills are markdown knowledge modules with YAML frontmatter. They inject
// domain expertise into the agent's context when semantically relevant to
// the user's request.
//
// # Skill Format
//
// Skills are markdown files with YAML frontmatter:
//
//	---
//	name: git
//	description: Git version control operations
//	tags: [vcs, commit, branch]
//	---
//
//	# Git Skill
//
//	Common operations...
//
// # Discovery
//
// LoadSkills scans the skills directory ($XDG_CONFIG_HOME/ollie/skills)
// and parses skill metadata. Skills are indexed by name for lookup and
// by description for semantic matching.
//
// # Matching
//
// MatchSkills uses embedding similarity to find skills relevant to a
// query. The top matches (up to a configured limit) are injected into
// the agent's context. This enables capability discovery without
// requiring exact skill names.
package skills