AGENTS.md

1# skills-loader-core — Skill Loading + Matching (Core)
2 
3**Generated:** 2026-06-16
4 
5## OVERVIEW
6 
7Harness-neutral skill loading, builtin skill, runtime skill, and skill matching primitives.
8Package `@oh-my-opencode/skills-loader-core`.
9Confirmed by grep: consumed by `omo-opencode` skill features in ~70 files across `src/features/builtin-skills`, `src/features/opencode-skill-loader`, `src/features/opencode-runtime-skills`, `src/tools/skill`, and `src/hooks/auto-slash-command`.
10 
11## SUBSYSTEMS
12 
13| Area | Purpose | Sub-AGENTS.md |
14|------|---------|---------------|
15| `features/opencode-skill-loader/` | 4-scope SKILL.md discovery, parse, merge, deduplication | [src/features/opencode-skill-loader/AGENTS.md](src/features/opencode-skill-loader/AGENTS.md) |
16| `features/builtin-skills/` | 12 built-in skills (git-master, playwright, frontend, review-work, etc.) | [src/features/builtin-skills/AGENTS.md](src/features/builtin-skills/AGENTS.md) |
17| `features/opencode-runtime-skills/` | Runtime security skill source (security-research, security-review) | — |
18| `tools/skill/` | Skill name matching and scope priority sorting | — |
19| `hooks/auto-slash-command/` | Slash command detection and processed command store | — |
20| `shared/` | Skill path resolver, config dir discovery, plugin identity, shell env | — |
21| `config/` | Git env prefix and skills config schema | — |
22 
23## NOTES
24 
25- **Exports:** barrel root plus subpath exports for `./opencode-skill-loader`, `./builtin-skills`, `./opencode-runtime-skills`, `./skill`, `./auto-slash-command`, `./shared/*`, and `./config/*`.
26- **Skill matching:** `tools/skill/skill-matcher.ts` provides `matchSkillByName()`, `matchCommandByName()`, and `findPartialMatches()`.
27- **Runtime skill source:** `features/opencode-runtime-skills/` exports `selectRuntimeSecuritySkills()` and `createRuntimeSkillSourceServer()`; injected into OpenCode via the runtime skill source server.
28- **121 TypeScript files** under `src/`. Barrel entry `src/index.ts`.
29 
30Parent: [packages/AGENTS.md](../AGENTS.md)
31