Cognee Docker Setup
topoteretes/cognee
Runs the Cognee AI memory platform in Docker, from a one-file prebuilt image to a full compose stack with UI, MCP server, Postgres and Neo4j.
Define a new node schema under cartography/models/MODULENAME/, including required properties, sub-resource relationships, extra labels, conditional labels, scoped cleanup, and one-to-many transforms.
$ npx skills add cartography-cncf/cartography --skill add-node-type -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install cartography-cncf/cartography add-node-type --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/cartography-cncf/cartography.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/add-node-type .claude/skills/add-node-type && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "add-node-type" agent skill from https://github.com/cartography-cncf/cartography/tree/master/.agents/skills/add-node-type into .claude/skills/add-node-type/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add-node-type", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/cartography-cncf/cartography/tree/master/.agents/skills/add-node-typeType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add cartography-cncf/cartography --skill add-node-type -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install cartography-cncf/cartography add-node-type --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cartography-cncf/cartography.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/add-node-type .agents/skills/add-node-type && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "add-node-type" agent skill from https://github.com/cartography-cncf/cartography/tree/master/.agents/skills/add-node-type into .agents/skills/add-node-type/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add-node-type", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add cartography-cncf/cartography --skill add-node-type -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install cartography-cncf/cartography add-node-type --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cartography-cncf/cartography.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/add-node-type .cursor/skills/add-node-type && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "add-node-type" agent skill from https://github.com/cartography-cncf/cartography/tree/master/.agents/skills/add-node-type into .cursor/skills/add-node-type/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add-node-type", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/cartography-cncf/cartography.git --path .agents/skills/add-node-type--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add cartography-cncf/cartography --skill add-node-type -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install cartography-cncf/cartography add-node-type --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cartography-cncf/cartography.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/add-node-type .gemini/skills/add-node-type && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "add-node-type" agent skill from https://github.com/cartography-cncf/cartography/tree/master/.agents/skills/add-node-type into .gemini/skills/add-node-type/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add-node-type", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install cartography-cncf/cartography add-node-typeInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add cartography-cncf/cartography --skill add-node-type -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/cartography-cncf/cartography.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/add-node-type .github/skills/add-node-type && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "add-node-type" agent skill from https://github.com/cartography-cncf/cartography/tree/master/.agents/skills/add-node-type into .github/skills/add-node-type/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add-node-type", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add cartography-cncf/cartography --skill add-node-type -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install cartography-cncf/cartography add-node-type --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/cartography-cncf/cartography.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/add-node-type .opencode/skills/add-node-type && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "add-node-type" agent skill from https://github.com/cartography-cncf/cartography/tree/master/.agents/skills/add-node-type into .opencode/skills/add-node-type/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "add-node-type", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
add-node-typeDefine a new node schema under cartography/models/MODULENAME/, including required properties, sub-resource relationships, extra labels, conditional labels, scoped cleanup, and one-to-many transforms.
Add Node Type is an agent skill from cartography-cncf/cartography. Define a new node schema under cartography/models/MODULENAME/, including required properties, sub-resource relationships, extra labels, conditional labels, scoped cleanup, and one-to-many transforms. Use when the user asks to add a node type, model a new resource, configure extra Neo4j labels (Identity, Asset, UserAccount, Tenant), or wire scoped vs global cleanup.
Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/advanced-properties.md`).
It works with Neo4j. The repository describes itself as: Cartography is a Python tool that pulls infrastructure assets and their relationships into a Neo4j graph database. The licence is Apache-2.0.
8 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit e4eda50. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
No scripts in the folder and no shell commands in SKILL.md (its code samples are python).
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Add Node Type loads about 1.9k tokens when it runs, and up to ~3.8k if it reads all its reference files. Until then it costs about 96 tokens; SKILL.md has 483 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from cartography-cncf/cartography at commit e4eda50, republished under its Apache-2.0 licence (© cartography-cncf). 483 words, ~1,897 tokens.
.claude/skills/add-node-type/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.Add a new CartographyNodeSchema (and its CartographyNodeProperties) to a Cartography module. This skill assumes the surrounding module already exists; for end-to-end module creation, see the create-module skill.
@dataclass(frozen=True) everywhere, with type annotations on every field (x: PropertyRef = PropertyRef("x")). A missing annotation triggers PropertyRef validation failed.CartographyNodeSchema / CartographyRelSchema subclasses are silently ignored — see "Standard fields" below.sub_resource_relationship always points to a tenant-like node (AWSAccount, AzureSubscription, GCPProject, GitHubOrganization, your <Service>Tenant).scoped_cleanup defaults to True. Override to False only for genuinely global data (CVE feeds, public threat intel, public DNS).Every node type needs at least:
@dataclass(frozen=True)
class YourNodeProperties(CartographyNodeProperties):
id: PropertyRef = PropertyRef("id") # REQUIRED
lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True) # REQUIRED
# business properties...PropertyRef parameters:
set_in_kwargs=True.extra_index=True — add a database index for query performance.set_in_kwargs=True — value comes from load(..., KWARG=...), not the per-record dict.one_to_many=True — value is a list; expand to many edges (see "One-to-many" below).@dataclass(frozen=True)
class YourServiceUserSchema(CartographyNodeSchema):
label: str = "YourServiceUser"
properties: YourServiceUserNodeProperties = YourServiceUserNodeProperties()
sub_resource_relationship: YourServiceTenantToUserRel = YourServiceTenantToUserRel()
other_relationships: OtherRelationships = OtherRelationships([
YourServiceUserToHumanRel(),
])CartographyNodeSchema standard fields:
| Field | Type | Required | Notes |
|---|---|---|---|
label | str | Yes | Neo4j node label |
properties | CartographyNodeProperties subclass | Yes | |
sub_resource_relationship | CartographyRelSchema subclass | Yes | Tenant-like target. None only if scoped_cleanup=False. |
other_relationships | OtherRelationships | No | Additional business relationships |
extra_node_labels | ExtraNodeLabels | No | Additional Neo4j labels (e.g. Identity, UserAccount) |
scoped_cleanup | bool | No | Defaults to True. Almost never override. |
CartographyRelSchema standard fields: target_node_label, target_node_matcher, direction, rel_label, properties. Custom fields do nothing — handle conditional behaviour in transform() by setting fields to None or filtering before load().
Add additional Neo4j labels by importing reusable uppercase constants and
wrapping them in ExtraNodeLabels:
from cartography.models.core.nodes import ExtraNodeLabels
from cartography.models.ontology.labels import USER_ACCOUNT
extra_node_labels: ExtraNodeLabels = ExtraNodeLabels([USER_ACCOUNT])Produces (:YourServiceUser:UserAccount). ExtraNodeLabel is one immutable
value type, not a base class for one subclass per label. Label definitions are
exported uppercase constants; their description fields are metadata for
introspection and generated documentation. Do not rely on class docstrings.
ExtraNodeLabels stores the supplied labels as an immutable tuple.
For ontology-driven labels (UserAccount, Tenant, Database, ...) see the
enrich-ontology skill.
scoped_cleanupDefault behaviour scoped_cleanup=True is correct for almost everything: user accounts, infrastructure resources, application assets — anything scoped to a tenant.
Override to False only for genuinely global data with no tenant:
@dataclass(frozen=True)
class VulnerabilitySchema(CartographyNodeSchema):
label: str = "Vulnerability"
properties: VulnerabilityNodeProperties = VulnerabilityNodeProperties()
sub_resource_relationship: None = None
scoped_cleanup: bool = FalseExamples that justify scoped_cleanup=False: CVE databases, threat intel feeds, public certificate transparency logs, global DNS / domain info.
When one source record points to many targets, flatten the IDs in transform() and use one_to_many=True on the relationship matcher:
# transform
def transform_route_tables(route_tables):
out = []
for rt in route_tables:
out.append({
"id": rt["RouteTableId"],
"subnet_ids": [a["SubnetId"] for a in rt.get("Associations", []) if "SubnetId" in a],
})
return out
# relationship
@dataclass(frozen=True)
class RouteTableToSubnetRel(CartographyRelSchema):
target_node_label: str = "AWSEC2Subnet"
target_node_matcher: TargetNodeMatcher = make_target_node_matcher({
"subnet_id": PropertyRef("subnet_ids", one_to_many=True),
})
direction: LinkDirection = LinkDirection.OUTWARD
rel_label: str = "ASSOCIATED_WITH"
properties: RouteTableToSubnetRelProperties = RouteTableToSubnetRelProperties()Neo4j 4+ supports native datetimes and ISO 8601 strings. Pass values through directly — do not convert to epoch milliseconds.
# DO
"created_at": user_data.get("created_at")
# DON'T
"created_at": int(dt_parse.parse(user_data["created_at"]).timestamp() * 1000)from cartography.client.core.tx import load
load(neo4j_session, YourServiceTenantSchema(), [{"id": tenant_id}], lastupdated=update_tag)
load(
neo4j_session,
YourServiceUserSchema(),
data,
lastupdated=update_tag,
TENANT_ID=tenant_id,
)PropertyRef validation failed — missing frozen=True or missing type annotation.Schema is "ignored" — only standard fields are recognised.scoped_cleanup and common_job_parameters["TENANT_ID"].For the full troubleshooting list, see the troubleshooting skill.
references/advanced-properties.md — conditional labels (ECR images / attestations), MatchLink targets, deeper sub-resource rationale, ECS example.© cartography-cncf, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 1 other file (references) in .agents/skills/add-node-type of cartography-cncf/cartography.
Open the folder on GitHubat commit e4eda50
Add Node Type next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Add Node Type this skillcartography-cncf/cartography | 4.1k | — | ~1.9k | Automated safety check: Pass | Apache-2.0 | |
| Cognee Docker Setuptopoteretes/cognee | 32k | 1 repos | ~901 | Automated safety check: Notes | Apache-2.0 | |
| CodegraphcontextCodeGraphContext/CodeGraphContext | 4.2k | — | ~675 | Automated safety check: Notes | MIT | |
| Add Partial Reconsamugit83/redamon | 2.9k | — | ~1.1k | Automated safety check: Pass | MIT | |
| Project Orchestratorthis-rs/project-orchestrator | 140 | — | ~2.6k | Automated safety check: Pass | Custom licence | |
| Anylineanylineorg/anyline | 346 | — | ~1.3k | Automated safety check: Pass | Apache-2.0 |
topoteretes/cognee
Runs the Cognee AI memory platform in Docker, from a one-file prebuilt image to a full compose stack with UI, MCP server, Postgres and Neo4j.
CodeGraphContext/CodeGraphContext
Use CodeGraphContext (CGC) to index a repo into a graph DB and query it via CLI or MCP.
samugit83/redamon
Adding partial-recon support for a tool: running a single pipeline phase on demand from the workflow graph, reading its inputs from the existing Neo4j graph and merging results back.
this-rs/project-orchestrator
AI agent orchestrator with Neo4j knowledge graph, Meilisearch search, and Tree-sitter parsing.
anylineorg/anyline
AnyLine数据库操作开发规范,涵盖动态数据源注册切换注销、DDL动态建表改表、DML增删改与事务管理、DQL动态查询与聚合统计、元数据管理、查询结果集的聚合、过滤、格式转换等数学计算,AnyLine方法内部会自动适配100+数据库方言,调用方法时忽略不同数据库差异。
topoteretes/cognee
Installs the cognee AI memory library in a Python environment, sets the LLM key and gets a first remember and recall script running with the Python SDK.
cartography-cncf/cartography
Define a CartographyRelSchema (standard relationship), one-to-many edge, or MatchLink connecting existing nodes.
cartography-cncf/cartography
Add a post-ingestion typed analysis job to a Cartography module to enrich the graph after sync.
cartography-cncf/cartography
Author a new Cartography intel module end-to-end (entry point, sync GET/TRANSFORM/LOAD/CLEANUP, declarative data model, integration test, schema docs).
cartography-cncf/cartography
Author a Cartography security rule (one or more Cypher Facts plus a Pydantic Finding output model) under cartography/rules/data/rules/.
cartography-cncf/cartography
Map a Cartography node into the Ontology system using semantic labels (UserAccount, DeviceInstance, Tenant, Database, ObjectStorage, FileStorage) or canonical nodes (User, Device).
cartography-cncf/cartography
Promote provider-specific relationships to a canonical cross-provider ontology edge using the WORKLOADPARENT pattern (a parallel CartographyRelSchema with the canonical rellabel, the old edge kept…
Works with
Define a new node schema under cartography/models/MODULENAME/, including required properties, sub-resource relationships, extra labels, conditional labels, scoped cleanup, and one-to-many transforms. Add Node Type is an agent skill from cartography-cncf/cartography. Define a new node schema under cartography/models/MODULENAME/, including required properties, sub-resource relationships, extra labels, conditional labels, scoped cleanup, and one-to-many transforms.
Add Node Type fits situations like: the user asks to add a node type; model a new resource; configure extra Neo4j labels (Identity; wire scoped vs global cleanup.
Run `npx skills add cartography-cncf/cartography --skill add-node-type -a claude-code`. Or copy the skill folder (.agents/skills/add-node-type in cartography-cncf/cartography) into .claude/skills/add-node-type in your project. Claude Code loads it when a task matches its description.
Run `npx skills add cartography-cncf/cartography --skill add-node-type -a codex`. Or copy the skill folder (.agents/skills/add-node-type in cartography-cncf/cartography) into .agents/skills/add-node-type in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add cartography-cncf/cartography --skill add-node-type -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/add-node-type, .gemini/skills/add-node-type, .github/skills/add-node-type and .opencode/skills/add-node-type in your project.
SKILL.md names no scripts, command-line tools or credentials: Add Node Type is instructions for the agent only. Our summary lists: Python 3.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Add Node Type is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.9k tokens (SKILL.md is roughly 7.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.9k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Add Node Type: Cognee Docker Setup (topoteretes/cognee, 32k stars), Codegraphcontext (CodeGraphContext/CodeGraphContext, 4.2k stars), Add Partial Recon (samugit83/redamon, 2.9k stars) and Project Orchestrator (this-rs/project-orchestrator, 140 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
cartography-cncf (a GitHub organization) maintains it in cartography-cncf/cartography, which has 4,120 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 7, 2026.
Source: cartography-cncf/cartography on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.