nanograph-ops

Manage nanograph graph databases with schema-first workflows and mutation-safe operations.

1|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/nanograph/nanograph-skills --skill nanograph-ops
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nanograph-ops
Source: https://github.com/nanograph/nanograph-skills/tree/main/skills/nanograph-ops
Command: npx skills add https://github.com/nanograph/nanograph-skills --skill nanograph-ops

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

nanograph-ops provides an operational guide to safely manage embedded nanograph databases, preventing common mistakes and enabling reliable day-to-day work.

Core Features & Use Cases

  • Schema-first workflow with .pg and .gq files, including linting and migration steps
  • Post-change practices like describe, doctor, and changes for CDC visibility
  • Day-to-day operations guidance covering storage generation, compact, embed, and mutation-safe workflows

Quick Start

Use nanograph describe --format json at the project root to inspect the current graph metadata and readiness.

Frequently Asked Questions about nanograph-ops

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

FAQPage Schema
How do I manage schema migrations for an embedded graph database without losing data?

Manage graph database migrations using a schema-first workflow with .pg and .gq files. This approach enforces linting and structured migration steps to prevent stale schemas and ensure data integrity during updates.

What's the best way to inspect graph metadata before running database operations?

Inspect graph metadata by running nanograph describe --format json at the project root. This checks the current graph database state and readiness before executing any operational changes or mutations.

Why should I use parameterized queries and a mutation-first workflow in graph operations?

A mutation-first workflow with parameterized queries prevents incorrect CLI usage and avoids stale schemas. It ensures safe graph mutations by validating changes before they are applied to the database.

How do I track Change Data Capture (CDC) visibility after modifying a graph database?

Track CDC visibility by running post-change practices like describe, doctor, and changes commands. These operations verify graph database state and monitor data capture events after mutations are applied.

Can I generate embeddings and compact storage for local graph databases?

Yes, day-to-day operations support storage generation, compact, and embed functions for local or embedded graphs. These features manage storage efficiency and generate vector embeddings directly within the graph database.

What are the limitations when operating local or embedded graph databases?

Limitations include risks of stale schemas and incorrect CLI usage if operational guidelines are bypassed. Skipping the post-change checklist or avoiding linting steps can lead to unsafe graph mutations and data inconsistencies.