ollie/skills/doc.go

34 lines
953 B
Go

// 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