/graph-query

Query JSON knowledge graph indexes via CLI with natural language or structured parameters.

49|12|Updated Jan 8, 2026
One-click install
npx skills add https://github.com/DavidROliverBA/ArchitectKB --skill graph-query-davidroliverba
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: /graph-query
Source: https://github.com/DavidROliverBA/ArchitectKB/tree/main/.claude/skills/graph-query
Command: npx skills add https://github.com/DavidROliverBA/ArchitectKB --skill graph-query-davidroliverba

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @anthropic-ai/sdk, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill allows you to query your knowledge graph index using natural language or structured queries, making it easy to find specific information within your vault.

Core Features & Use Cases

  • Natural Language Queries: Ask questions like "ADRs with status proposed" or "high priority tasks".
  • Structured Queries: Use parameters like --type=Adr or --status=proposed for precise filtering.
  • Special Queries: Identify "orphaned notes" or "broken links" within your graph.
  • Use Case: Quickly find all accepted Architecture Decision Records (ADRs) related to a specific project by asking "ADRs with status accepted for Project X".

Quick Start

Run the command /graph-query to find all ADRs with the status proposed.

Frequently Asked Questions about /graph-query

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

FAQPage Schema
How do I query a knowledge graph to find notes by status or priority?

You can query a knowledge graph using natural language requests like "high priority tasks" or structured command-line parameters such as --status or --priority to filter and retrieve specific notes. This allows precise filtering of your JSON index without manual searching.

What is the best way to find orphaned notes and broken links in a knowledge base?

Finding orphaned notes and broken links in a knowledge base is done by running special graph queries that scan the JSON index to identify disconnected content and invalid references. This surfaces isolated documents and broken connections directly.

How do I search for Architecture Decision Records with a specific status in my notes?

Searching for Architecture Decision Records (ADRs) with a specific status is done by querying the knowledge graph index using natural language phrases like "ADRs with status proposed". You can also use structured parameters like --type=Adr for precise filtering.

Can I use natural language to search a JSON knowledge graph index?

Yes, you can use natural language to search a JSON knowledge graph index by asking questions that filter notes by type, status, priority, or content. The command-line interface script interprets these queries to return matching records.

Does the graph query tool require a specific format for the knowledge base index?

The graph query tool requires the knowledge base index to be stored in JSON format. It relies on the @anthropic-ai/sdk dependency to process natural language and structured parameter-based queries against this JSON data.

What are the limitations of using command-line parameters for graph queries?

Using command-line parameters for graph queries limits you to filtering by predefined fields like type, status, and priority. For complex discovery tasks like mapping relationships, you must rely on the script's built-in special query functions rather than custom parameter combinations.