agentmap-read

Load and parse .agentmap.yaml orientation maps into agent context.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/jinglemansweep/agent-resources --skill agentmap-read
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agentmap-read
Source: https://github.com/jinglemansweep/agent-resources/tree/main/plugins/agentmap/skills/agentmap-read
Command: npx skills add https://github.com/jinglemansweep/agent-resources --skill agentmap-read

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reads and interprets the .agentmap.yaml codebase orientation map to give agents a navigable understanding of a repository.

Core Features & Use Cases

  • Load and parse the .agentmap.yaml from the working directory or repository root.
  • Populate context with the map's sections: meta, tasks, tree, key_symbols, conventions, and sub_maps.
  • Use the orientation data to guide task planning, code exploration, and impact analysis across monorepos.
  • Warn and guide if the map is stale or outdated.

Quick Start

Load the local .agentmap.yaml into context and confirm the loaded project meta.

Frequently Asked Questions about agentmap-read

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I parse a .agentmap.yaml file for codebase orientation in a monorepo?

To parse an .agentmap.yaml file for codebase orientation, the Skill loads the YAML map from your working directory or repository root, validates its contents, and populates context with meta, tasks, tree, key_symbols, conventions, and sub_maps for downstream decisioning.

What happens if no .agentmap.yaml orientation map is found in my repository?

If no .agentmap.yaml orientation map is found in your current working directory or repository root, the Skill reports that the file is missing and suggests running the /agentmap-init command to set one up.

Can I use agentmap context to guide code exploration and impact analysis?

Yes, you can use agentmap context to guide code exploration and impact analysis. The parsed YAML map populates context with tree structures and key_symbols, providing a navigable understanding of your repository for task planning.

How do I load project meta from a YAML orientation map into context?

To load project meta from a YAML orientation map into context, the Skill identifies and reads the .agentmap.yaml file, then extracts and validates the meta section along with tasks, tree, key_symbols, conventions, and sub_maps.

Does the agentmap reader warn if the codebase orientation map is stale or outdated?

Yes, the agentmap reader warns and guides you if the codebase orientation map is stale or outdated. It checks the loaded YAML contents to ensure your repository navigation context remains reliable and accurate.