How do I install the Project Maps skill?

Run npx skillmds@latest add majiayu000/project-maps in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Project Maps safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Project Maps?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Project Maps free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Project Maps?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Project Maps by majiayu000 — Agent Skill

Name: Project Maps
Rating: 4.5 (4 reviews)
Author: majiayu000

File contents

name: project-maps description: Use for project architecture, codebase structure, dependencies, components, tech stack. Explicit triggers: @map, map-ask, explore map, -map. Pre-computed maps faster than Glob for structural queries. allowed-tools: [Bash, Read]

Project Maps Skill

Pre-computed codebase analysis. Use instead of Glob for architecture questions.

When This Skill is Invoked

When the user asks about project architecture, structure, dependencies, components, or tech stack, execute the appropriate command below.

Execution Instructions

For Natural Language Questions

Run the ask command with the user's question:

node ${CLAUDE_PLUGIN_ROOT}/cli/session-cli.js project-maps ask "{user_question}"

If CLAUDE_PLUGIN_ROOT is not set, use the plugin cache path:

node /Users/prajyot/.claude/plugins/cache/automatewithus-plugins/session/3.38.0/cli/session-cli.js project-maps ask "{user_question}"

For Specific Query Types

Use query command for structured data:

# Architecture/structure
node ${CLAUDE_PLUGIN_ROOT}/cli/session-cli.js project-maps query summary

# Dependencies
node ${CLAUDE_PLUGIN_ROOT}/cli/session-cli.js project-maps query deps

# Components (React/Vue/etc)
node ${CLAUDE_PLUGIN_ROOT}/cli/session-cli.js project-maps query components

# Database schema
node ${CLAUDE_PLUGIN_ROOT}/cli/session-cli.js project-maps query database

# Modules
node ${CLAUDE_PLUGIN_ROOT}/cli/session-cli.js project-maps query modules

For Different Project Paths

Add --path for projects other than current directory:

node ${CLAUDE_PLUGIN_ROOT}/cli/session-cli.js project-maps ask "{question}" --path /path/to/project

When Maps Don't Exist

If command returns "No maps found", instruct user to generate:

Maps not found. Run: /session:project-maps-generate

Query Types Reference

Query Type	Returns
`summary`	Project overview, tech stack, structure
`deps`	Import/export relationships
`components`	UI components and props
`database`	Tables, columns, relationships
`modules`	Logical module boundaries
`tree`	File tree structure
`issues`	Code quality issues

Example Usage

User: "What framework does this project use?" Action: Run project-maps ask "what framework does this project use"

User: "Show me the database schema" Action: Run project-maps query database

User: "What would break if I change auth.js?" Action: Run project-maps ask "what would break if I change auth.js"

---name: project-mapsdescription: Use for project architecture, codebase structure, dependencies, components, tech stack. Explicit triggers: @map, map-ask, explore map, -map. Pre-computed maps faster than Glob for structural queries.--- --- name: project-maps description: Use for project architecture, codebase structure, dependencies, components, tech stack. Explicit triggers: @map, map-ask, explore map, -map. Pre-computed maps faster than Glob for structural queries. allowed-tools: [Bash, Read] --- # Project Maps Skill Pre-computed codebase analysis. Use instead of Glob for architecture questions. ## When This Skill is Invoked When the user asks about project architecture, structure, dependencies, components, or tech stack, execute the appropriate command below. ## Execution Instructions ### For Natural Language Questions Run the ask command with the user's question: ```bash node ${CLAUDE_PLUGIN_ROOT}/cli/session-cli.js project-maps ask "{user_question}" ``` If `CLAUDE_PLUGIN_ROOT` is not set, use the plugin cache path: ```bash node /Users/prajyot/.claude/plugins/cache/automatewithus-plugins/session/3.38.0/cli/session-cli.js project-maps ask "{user_question}" ``` ### For Specific Query Types Use query command for structured data: ```bash # Architecture/structure node ${CLAUDE_PLUGIN_ROOT}/cli/session-cli.js project-maps query summary # Dependencies node ${CLAUDE_PLUGIN_ROOT}/cli/session-cli.js project-maps query deps # Components (React/Vue/etc) node ${CLAUDE_PLUGIN_ROOT}/cli/session-cli.js project-maps query components # Database schema node ${CLAUDE_PLUGIN_ROOT}/cli/session-cli.js project-maps query database # Modules node ${CLAUDE_PLUGIN_ROOT}/cli/session-cli.js project-maps query modules ``` ### For Different Project Paths Add `--path` for projects other than current directory: ```bash node ${CLAUDE_PLUGIN_ROOT}/cli/session-cli.js project-maps ask "{question}" --path /path/to/project ``` ## When Maps Don't Exist If command returns "No maps found", instruct user to generate: ``` Maps not found. Run: /session:project-maps-generate ``` ## Query Types Reference | Query Type | Returns | |------------|---------| | `summary` | Project overview, tech stack, structure | | `deps` | Import/export relationships | | `components` | UI components and props | | `database` | Tables, columns, relationships | | `modules` | Logical module boundaries | | `tree` | File tree structure | | `issues` | Code quality issues | ## Example Usage User: "What framework does this project use?" Action: Run `project-maps ask "what framework does this project use"` User: "Show me the database schema" Action: Run `project-maps query database` User: "What would break if I change auth.js?" Action: Run `project-maps ask "what would break if I change auth.js"`

Frequently asked questions

Project Maps