Name: agents-md-core
Author: willhama

Imported from willhama/md-file-study (corpus_full/code-yeongyu__oh-my-openagent/files/packages/agents-md-core/AGENTS.md). Install upstream with npx skills add willhama/md-file-study --skill agents-md-core. Copyright stays with the author.

agents-md-core — AGENTS.md Discovery + Injection (Core)

Generated: 2026-06-17

OVERVIEW

Harness-neutral logic for walking a file path UP its directory tree, discovering nearby AGENTS.md files, truncating their content, and formatting them as a [Directory Context: ...] block for injection into the session. Discovery itself is delegated to rules-engine (findAgentsMdUp, AgentsMdCache); this package owns path resolution, formatting, and the per-session injected-paths cache. Package: @oh-my-opencode/agents-md-core.

PUBLIC API (`src/index.ts`)

Export	Source	Role
`AGENTS_FILENAME`	`constants.ts`	re-exported from `rules-engine` (value `"AGENTS.md"`)
`resolveFilePath(rootDir, path)`	`finder.ts`	resolve + `realpathSync` validate path is inside `rootDir`; `null` if escapes
`formatAgentsMdContextBlock({agentsPath, content, truncated})`	`formatter.ts`	wrap content in directory-context block + optional truncation notice
`getSessionCache({sessionCaches, sessionID, storage})`	`injection-cache.ts`	per-session `Set<string>` of already-injected dirs, backed by storage
`processFilePathForAgentsInjection(...)`	`injector.ts`	orchestrator: resolve → `findAgentsMdUp` → read → truncate → format → cache
types	`types.ts`	`AgentsMdTruncator`, `AgentsMdContextOutput`, `AgentsMdInjectedPathsStorage`, `TruncationResult`

DEPENDENCIES & CONSUMERS

Depends on: @oh-my-opencode/rules-engine only.
Consumed by (OpenCode edition only; no Codex consumer): omo-opencode/src/hooks/directory-agents-injector/{finder,injector}.ts (re-export) and hooks/hephaestus-agents-md-injector/hook.ts (formatAgentsMdContextBlock).

NOTES

Path-traversal guard is a security invariant. resolveFilePath canonicalizes via realpathSync and returns null when the resolved path is outside rootDirectory.
Truncator + storage are injected (AgentsMdTruncator, AgentsMdInjectedPathsStorage) — this package never implements truncation strategy or persistence itself.
Parent: packages/AGENTS.md.

Install agents-md-core and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "willhama-md-file-study-agents-md-core", "kind": "skill", "name": "agents-md-core", "description": "Harness-neutral logic for walking a file path UP its directory tree, discovering nearby `AGENTS.md` files, truncating their content, and formatting them as a `[Directory Context: ...]` block for injection into the session. Discovery itself is delegated to [`rules-engine`](../rules-engine/AGENTS.md) (`findAgentsMdUp`, `AgentsMdCache`); this package owns path resolution, formatting, and the per-session injected-paths cache. Package: `@oh-my-opencode/agents-md-core`.", "publisher": "willhama", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Harness-neutral logic for walking a file path UP its directory tree, discovering nearby `AGENTS.md` files, truncating their content, and formatting them as a `[Directory Context: ...]` block for injection into the session. Discovery itself is delegated to [`rules-engine`](../rules-engine/AGENTS.md) (`findAgentsMdUp`, `AgentsMdCache`); this package owns path resolution, formatting, and the per-session injected-paths cache. Package: `@oh-my-opencode/agents-md-core`." ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/willhama/md-file-study", "path": "corpus_full/code-yeongyu__oh-my-openagent/files/packages/agents-md-core/AGENTS.md", "ref": "c19de1e5213e9860055ac2385c28916a272efb46", "url": "https://github.com/willhama/md-file-study/blob/c19de1e5213e9860055ac2385c28916a272efb46/corpus_full/code-yeongyu__oh-my-openagent/files/packages/agents-md-core/AGENTS.md", "key": "willhama/md-file-study/corpus_full/code-yeongyu__oh-my-openagent/files/packages/agents-md-core/AGENTS.md" } }, "instructions": "# agents-md-core — AGENTS.md Discovery + Injection (Core)\n\n**Generated:** 2026-06-17\n\n## OVERVIEW\n\nHarness-neutral logic for walking a file path UP its directory tree, discovering nearby `AGENTS.md` files, truncating their content, and formatting them as a `[Directory Context: ...]` block for injection into the session. Discovery itself is delegated to [`rules-engine`](../rules-engine/AGENTS.md) (`findAgentsMdUp`, `AgentsMdCache`); this package owns path resolution, formatting, and the per-session injected-paths cache. Package: `@oh-my-opencode/agents-md-core`.\n\n## PUBLIC API (`src/index.ts`)\n", "cost": { "context_tokens": 540 } }

agents-md-core

About

agents-md-core — AGENTS.md Discovery + Injection (Core)

OVERVIEW

PUBLIC API (`src/index.ts`)

DEPENDENCIES & CONSUMERS

NOTES

Install agents-md-core and it becomes one more candidate the router can pick - when it fits.

Use it

Manifest

Reviews

About

agents-md-core — AGENTS.md Discovery + Injection (Core)

OVERVIEW

PUBLIC API (src/index.ts)

DEPENDENCIES & CONSUMERS

NOTES

Install agents-md-core and it becomes one more candidate the router can pick - when it fits.

Use it

Manifest

Reviews

PUBLIC API (`src/index.ts`)