Skip to content

aiskillstore/marketplace / skills/23blocks-os/ai-maestro-code-graph-query

ai-maestro-code-graph-query

Verified

PROACTIVELY query the code graph database to understand relationships and impact of changes. Use this skill WHEN READING any file to understand context, when searching for files, when exploring the codebase, or when you need to understand what depends on a component. This is your primary tool for understanding code structure and avoiding breaking changes.

FileKindSize
SKILL.mdskill md5.3 KB
output.jsonconfig7.0 KB
skill-report.jsonconfig72.6 KB

output.json

View on GitHub
{
  "skill": {
    "name": "AI Maestro Code Graph Query",
    "description": "PROACTIVELY query the code graph database to understand relationships and impact of changes. Use this skill when reading any file to understand context, when searching for files, when exploring the codebase, or when you need to understand what depends on a component. This is your primary tool for understanding code structure and avoiding breaking changes.",
    "summary": "Query code dependency graphs to understand relationships and avoid breaking changes",
    "icon": "🔗",
    "version": "1.0.0",
    "author": "AI Maestro",
    "license": "MIT",
    "category": "coding",
    "tags": ["code-analysis", "dependencies", "refactoring", "codebase-understanding"],
    "supported_tools": ["claude", "claude-code"]
  },
  "security_audit": {
    "risk_level": "low",
    "is_blocked": false,
    "safe_to_publish": true,
    "summary": "Prompt-based skill providing behavioral instructions. Executes local scripts from ~/.local/bin/ and makes localhost API calls to the AI Maestro dashboard. No external network access or sensitive data exfiltration patterns detected.",
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 1,
    "total_lines": 160,
    "risk_factors": ["external_commands", "network"],
    "risk_factor_evidence": [
      {
        "factor": "external_commands",
        "evidence": [
          {"file": "SKILL.md", "line_start": 42, "line_end": 51},
          {"file": "SKILL.md", "line_start": 63, "line_end": 70}
        ]
      },
      {
        "factor": "network",
        "evidence": [
          {"file": "SKILL.md", "line_start": 145, "line_end": 146}
        ]
      }
    ]
  },
  "content": {
    "user_title": "Query Code Dependencies",
    "value_statement": "Understanding code relationships prevents breaking changes. This skill automatically queries a code graph database to find callers, callees, serializers, and associations before you modify any component.",
    "seo_keywords": [
      "code graph query",
      "dependency analysis",
      "codebase navigation",
      "Claude Code skill",
      "code relationships",
      "impact analysis",
      "refactoring tool",
      "call graph",
      "function dependencies",
      "code structure"
    ],
    "actual_capabilities": [
      "Find all functions that call a given function (callers)",
      "Find all functions called by a given function (callees)",
      "Discover model associations and serializers",
      "Find inheritance and composition relationships",
      "Trace call paths between functions",
      "Delta-index changed files for quick updates"
    ],
    "limitations": [
      "Requires AI Maestro dashboard running on localhost",
      "Requires graph database to be indexed first",
      "Only works with code files in indexed projects",
      "Cannot query non-code files or binary data"
    ],
    "use_cases": [
      {
        "target_user": "Backend Developers",
        "title": "Safe Model Changes",
        "description": "Before modifying a model, find all serializers and associations that might break."
      },
      {
        "target_user": "Feature Engineers",
        "title": "Impact Analysis",
        "description": "Understand the full impact of changing a core function before refactoring."
      },
      {
        "target_user": "Codebase Maintainers",
        "title": "Architecture Discovery",
        "description": "Explore unknown codebases by tracing relationships between components."
      }
    ],
    "prompt_templates": [
      {
        "title": "Understand a File",
        "scenario": "Reading a model or component",
        "prompt": "Read this file, then query the graph to find: what depends on this component, what it depends on, and any serializers or associations."
      },
      {
        "title": "Before Refactoring",
        "scenario": "Changing a function signature",
        "prompt": "Find all callers of this function before making changes. List each caller and its file location."
      },
      {
        "title": "Find Serializers",
        "scenario": "Updating a data model",
        "prompt": "Find all serializers for this model. Check if any serializers might be missing from the codebase."
      },
      {
        "title": "Trace Call Path",
        "scenario": "Understanding data flow",
        "prompt": "Find the call path from the API controller entry point to this internal function."
      }
    ],
    "output_examples": [
      {
        "input": "Query the graph for callers and callees of the process_payment function",
        "output": [
          "🔗 process_payment Function Analysis",
          "",
          "📥 Callers (functions that call process_payment):",
          "  • create_order (app/services/order_service.rb:42)",
          "  • process_subscription (app/services/billing.rb:18)",
          "  • refund_transaction (app/services/refund.rb:55)",
          "",
          "📤 Callees (functions called by process_payment):",
          "  • validate_amount (app/models/payment.rb:12)",
          "  • charge_card (app/services/stripe.rb:89)",
          "  • log_transaction (app/utils/logger.rb:23)"
        ]
      }
    ],
    "best_practices": [
      "Query the graph immediately after reading any code file to build context",
      "Check serializers before modifying database models",
      "Verify all callers before changing function signatures",
      "Use delta indexing to keep the graph updated with changes"
    ],
    "anti_patterns": [
      "Skipping graph queries for 'simple' changes",
      "Making modifications without checking for downstream effects",
      "Assuming you understand the full impact without querying",
      "Forgetting to update the graph index after major changes"
    ],
    "faq": [
      {
        "question": "Which AI tools support this skill?",
        "answer": "This skill works with Claude and Claude Code. It requires the AI Maestro dashboard to be running locally."
      },
      {
        "question": "How does the code graph get built?",
        "answer": "The graph is built by indexing your codebase. Run graph-index-delta.sh to update it with changes."
      },
      {
        "question": "What programming languages are supported?",
        "answer": "The skill works with any language. Language detection depends on your AI Maestro installation configuration."
      },
      {
        "question": "Is my code data sent externally?",
        "answer": "No. All graph data stays on your machine. The API calls are to localhost port 23000 only."
      },
      {
        "question": "Why are my queries returning no results?",
        "answer": "The graph needs to be indexed first. Run graph-index-delta.sh on your project directory."
      },
      {
        "question": "How is this different from grep or search?",
        "answer": "Graph queries understand relationships. Find all callers, not just text matches. Shows call paths and dependencies."
      }
    ]
  }
}
deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json.Stars: 118kUpdated Claude CodeCodexVerifiedInstall