Graph Query
FreeUnderstand code dependencies and relationships efficiently.
Free · Opens the source repo
What Graph Query does
The Graph Query skill allows developers to interact with a codebase's dependency graph, enabling them to understand the relationships between components, call chains, and the potential impact of changes before making modifications. This skill is particularly useful for scenarios where understanding code structure is critical, such as when refactoring or debugging. By querying the graph, users can obtain insights into how components are interconnected, which can prevent issues that arise from making changes without a full understanding of the code's architecture.
To use this skill, the AI Maestro platform must be installed and the codebase indexed. Once set up, users can execute various commands to gather information about components. For example, commands like graph-find-callers.sh and graph-find-callees.sh allow users to identify which functions call a specific function and which functions are called by it, respectively. This can help developers anticipate the consequences of changes and ensure that all related parts of the code are considered.
The skill also supports commands to find serializers and associations for models, making it easier to manage data structures and their relationships. Additionally, the ability to find paths between functions can clarify complex interactions within the code, aiding in both development and debugging processes. Overall, the Graph Query skill is an essential tool for developers who need to navigate and manipulate complex codebases safely and effectively.
When to use it
Use this skill when you need to understand how different parts of your codebase interact, especially before making modifications.
When not to use it
This skill is not suitable for simple projects where dependencies are minimal or well understood, as the overhead of querying may not be necessary.
What you can build with it
Refactoring a Function
Before modifying a function, use `graph-find-callers.sh` to see which parts of the code will be affected by your changes.
Understanding Model Relationships
When working with models, commands like `graph-find-serializers.sh` and `graph-find-associations.sh` help clarify how data structures are connected.
Navigating Complex Codebases
Use `graph-find-path.sh` to trace the call path between functions, aiding in debugging and understanding complex interactions.
How to install Graph Query
View source1. Install with the skills CLI
npx skills add davila7/claude-code-templates/graph-query --agent claude-code2. Or install it manually
Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.
Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs
Inside SKILL.md
Written by davila7AI Maestro Code Graph Query
Query your codebase's dependency graph to understand component relationships, call chains, and the impact of changes before making modifications. Part of the AI Maestro suite.
Prerequisites
Requires AI Maestro running locally with codebase indexed.
# Install graph tools
git clone https://github.com/23blocks-OS/ai-maestro-plugins.git
cd ai-maestro-plugins && ./install-graph-tools.sh
Core Behavior
After reading any code file, query the graph to understand dependencies:
Read file -> Query graph -> Then proceed
Commands
Query
| Command | Description |
|---|---|
graph-describe.sh <name> | Describe a component or function |
graph-find-callers.sh <fn> | Find all callers of a function |
graph-find-callees.sh <fn> | Find all functions called by this function |
graph-find-related.sh <component> | Find related components |
graph-find-by-type.sh <type> | Find all components of a type |
graph-find-serializers.sh <model> | Find serializers for a model |
graph-find-associations.sh <model> | Find model associations |
graph-find-path.sh <from> <to> | Find call path between functions |
Index
| Command | Description |
|---|---|
graph-index-delta.sh [path] | Index or update the code graph |
Component Types
Use with graph-find-by-type.sh: model, serializer, controller, service, job, concern, component, hook
Usage Examples
# After reading a model file
graph-describe.sh User
graph-find-serializers.sh User
graph-find-associations.sh User
# Before modifying a function
graph-find-callers.sh process_payment
graph-find-callees.sh process_payment
# Find call chain between components
graph-find-path.sh handleRequest sendResponse
# Index your codebase
graph-index-delta.sh /path/to/project
Why Query Before Modifying
Without checking the graph, you risk:
- Breaking callers when changing a function signature
- Missing serializers that need updating with a model change
- Overlooking child classes that inherit your modifications
Full AI Maestro Experience
This skill is part of the AI Maestro platform, which provides 6 skills for AI agent orchestration: messaging, memory, docs, graph, planning, and agent management.
Frequently asked questions about Graph Query
Similar skills
Quality Playbook Generator
Run comprehensive quality audits on any codebase.
PR Draft Summary
Automate PR summary generation for openai-agents-python.
Final Release Review
Streamline your release candidate audits with ease.
Unit Test Vue Pinia
Efficiently write and review unit tests for Vue 3 applications.
Slang Shader Expert
Optimize and integrate Slang shaders with ease.
Telemetry Standards
Ensure consistent event tracking in Supabase Studio.