Agent Context Loader

Overview

Automatic discovery and loading of AGENTS.md files across project hierarchies for AI coding agents. This skill scans the current workspace and its parent directories to locate agent instruction files, then surfaces their contents so the active agent session has full operational context.

Prerequisites

• A project workspace containing one or more AGENTS.md files at any directory depth
• Read and Glob permissions to traverse the directory tree
• Grep access for searching file contents when multiple candidates exist

Instructions

1. Scan the current working directory and all ancestor directories (up to the filesystem root or repository root) for files named AGENTS.md or agents.md.
2. Search subdirectories of the current workspace for additional AGENTS.md files that may apply to sub-projects or modules.
3. Determine load order: files closer to the repository root load first (global context), files in deeper directories load later (override or supplement).
4. Read each discovered AGENTS.md file and extract its instruction blocks, workflow definitions, and constraint declarations.
5. Merge instructions into a unified context, noting any conflicts between levels (e.g., a subdirectory agent overriding a root-level rule).
6. Present the loaded context as a structured summary: source file path, instruction count, and any detected conflicts.
7. Cache the discovery results for the current session to avoid redundant filesystem scans on subsequent activations.

Output

• Ordered list of discovered AGENTS.md file paths with their directory depth
• Merged instruction set combining all discovered agent contexts
• Conflict report highlighting any contradictory directives between levels
• Session cache status indicating whether results are fresh or reused

Error Handling