neumann-query

Write Neumann database queries across relational, graph, vector, and unified engines.

74|6|Updated Dec 23, 2025
One-click install
npx skills add https://github.com/Shadylukin/Neumann --skill neumann-query
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: neumann-query
Source: https://github.com/Shadylukin/Neumann/tree/main/.claude/skills/neumann-query
Command: npx skills add https://github.com/Shadylukin/Neumann --skill neumann-query

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers and data engineers write syntactically correct and semantically valid Neumann database queries across relational, graph, vector, and unified engines, reducing errors, parser mis-tokenization, and wasted debugging time.

Core Features & Use Cases

  • Common syntax gotchas: highlights direction keywords, colon-key tokenization, quoting rules for keys with colons, arrow and colon delimiters for edges, property block syntax, and SIMILAR metric/limit ordering.
  • Cross-engine patterns: shows combined vector+graph queries, NEIGHBORS ranked by similarity, ENTITY workflows spanning relational/graph/vector, and when to use Vault/Cache/Blob commands.
  • Authoritative references: maps commands to result types and points to parser and AST sources for precise behavior and validation.
  • Use cases: RAG retrieval combining EMBED and graph traversal, agent memory with semantic caching, and structured entity creation with embeddings and graph links.

Quick Start

Write a Neumann query that finds engineers similar to 'user:alice' who report to 'user:bob'.

Frequently Asked Questions about neumann-query

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

FAQPage Schema
How do I write graph database queries that combine vector similarity search with graph traversal in Neumann DB?

Cross-engine Neumann DB queries combine vector similarity search with graph traversal by using EMBED and SIMILAR commands for vectors alongside NODE and EDGE commands for graph relationships, connected through proper arrow and colon delimiters.

Why does my Neumann DB query fail when using keys that contain colons?

Neumann DB queries fail with colon-containing keys due to parser mis-tokenization. You must enforce quoting rules around keys containing colons to prevent the parser from interpreting the colon as a delimiter, ensuring correct tokenization and query execution.

What is the correct syntax for edge direction keywords in Neumann graph database queries?

The correct syntax for edge direction keywords in Neumann graph database queries requires specifying OUTGOING, INCOMING, or BOTH explicitly. Edge commands must use proper arrow and colon delimiters to define traversal direction and ensure the parser correctly interprets the graph relationship.

How do I use the SIMILAR command for vector search in Neumann DB without syntax errors?

To use the SIMILAR command without syntax errors in Neumann DB, ensure proper ordering of metric and limit parameters. The SIMILAR command requires the metric specification and limit values in the correct sequence to avoid parser errors and return accurate vector similarity results.

Can I cache vector embeddings and graph query results together in Neumann DB?

Yes, you can cache vector embeddings and graph query results together in Neumann DB using the CACHE and VAULT commands. This supports agent memory workflows with semantic caching, allowing combined storage of EMBED results and graph traversal data for faster subsequent retrieval.

What are the limitations when using reserved keywords as identifiers in Neumann database queries?

The main limitation when using reserved keywords as identifiers in Neumann database queries is parser mis-tokenization. Reserved keywords like OUTGOING, INCOMING, BOTH, NODE, and EDGE cannot be used as unquoted identifiers, requiring quoting rules to avoid syntax errors and ensure correct command parsing.