cognee: Skill for Claude Code

.agents/skills/cognee-improve-sessions/SKILL.md

cognee-improve-sessions is a skill for Claude Code, Codex from topoteretes/cognee. It costs 65 tokens per session (3,646 once invoked), scanned A, original, Apache-2.0.

A guide to Cognee's short-term conversation memory and `improve()` function. Session memory holds conversation turns and agent activity temporarily, while `improve()` connects that information to longer-term graph memory.

In plain words
What is it for?
Use it to save conversation turns, traces, and feedback by session, search a session alongside the graph, and move selected sessions into permanent memory.
Why use it?
It clarifies the difference between fast session storage and permanent memory, including why a background update may not finish before a script exits. It also explains status results when an update is skipped or locked.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: installed under .agents/ (shared by several agents).

This is topoteretes/cognee's own configuration. It tells Claude Code and Codex how to work on cognee itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything cognee configures →

About the project

Cognee is an AI memory platform that stores information in a self-hosted knowledge graph so agents can retain context across sessions. It ingests data, connects related information, and helps agents retrieve it for reasoning and actions. The catalogue includes skills and instructions that extend agent workflows around Cognee.

topoteretes/cognee · 33,094 stars · on GitHub · cognee.ai

Reuse

Borrowing it

Nothing to install: this file belongs to topoteretes/cognee. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/topoteretes/cognee/main/.agents/skills/cognee-improve-sessions/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/topoteretes/cognee

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for cognee-improve-sessions

README.md
[![agentmods](https://agentmods.dev/badge/skills/topoteretes/cognee/cognee-improve-sessions/github.svg)](https://agentmods.dev/skills/topoteretes/cognee/cognee-improve-sessions)
Your own site
<a href="https://agentmods.dev/skills/topoteretes/cognee/cognee-improve-sessions"><img src="https://agentmods.dev/badge/skills/topoteretes/cognee/cognee-improve-sessions/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for cognee-improve-sessions

Your own site · 80×15
<a href="https://agentmods.dev/skills/topoteretes/cognee/cognee-improve-sessions"><img src="https://agentmods.dev/badge/skills/topoteretes/cognee/cognee-improve-sessions.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 65 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,646 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00065 $0.03646
Opus 5.5 $0.00026 $0.01458
Sonnet 5.5 $0.00013 $0.00729
Haiku 4.5 $0.00006 $0.00365

Measured 7d ago against content hash c677f5e5d2e7, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

cognee-improve-sessions scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/cognee-improve-sessions/SKILL.md · 241 lines

How it starts

The opening of the file, as written. The whole thing — 241 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Session memory and improve()

cognee has two kinds of memory:

  • Session memory: a fast cache of conversation turns, agent traces, and feedback, keyed by session_id. Writing is instant, with no LLM extraction.
  • The permanent graph: what remember() builds without a session.

improve() connects them. It bridges session content into the graph and enriches the graph itself. remember() calls it automatically, so most users never call it directly.

import cognee

# Session write: returns immediately; improve() bridges it in the background
await cognee.remember("User prefers dark mode.", session_id="chat_1")

# Session-aware query: session cache first, then the graph
results = await cognee.recall("What does the user prefer?", session_id="chat_1")

# Bridge sessions into a dataset's graph explicitly
result = await cognee.improve(dataset="main_dataset", session_ids=["chat_1"])
print(result.status, result.stage_summary())

await cognee.wait_for_background_tasks()  # before a script exits

Use it

Writing session memory

What How
A fact or note remember(text, session_id=...) (stored as a Q&A entry with the text as the answer)
A Q&A turn recall(query, session_id=...) with a completion search type saves the turn itself; or remember(cognee.QAEntry(question=..., answer=...), session_id=...)
An agent step remember(cognee.TraceEntry(origin_function=..., status="success", ...), session_id=...), or the @cognee.agent_memory(save_session_traces=True) decorator
Pin a session to a project / node set node_set=[...] on the first QAEntry/TraceEntry (or as a kwarg on any session remember) pins it; later writes repeat or omit it, a different set raises cognee.SessionNodeSetConflictError (HTTP 409). improve() keeps the set on everything it bridges, so recall(node_name=[...]) scopes to the project
Feedback on an answer remember(cognee.FeedbackEntry(qa_id=..., feedback_score=...), session_id=...) or cognee.session.add_feedback(session_id, qa_id, feedback_text=..., feedback_score=...)
Read a session cognee.session.get_session(session_id, last_n=...)

Read the full file on GitHub · 241 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 7d ago Changed · -3 lines · -4 tokens per session c677f5e5d2e7
  2. 21d ago Changed · +14 lines 2aafe0300d6b
  3. 1mo ago Changed · +7 lines 9b89d0b3441d
  4. 1mo ago First seen · 223 lines · 69 tokens per session scan A bb819e4e5204

Subscribe to this mod's changes

cognee-improve-sessions is a skill published in the GitHub repository topoteretes/cognee (33,094 stars, last pushed today), licensed Apache-2.0. It adds 65 tokens to every session and 3,646 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-30.

Related

cognee-improve-sessions compared with skills from other repositories

cognee-improve-sessions next to 6 skills from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
cognee-improve-sessionstopoteretes/cogneeSkill33ktodayApache-2.0A65Claude Code, Codex
openmemoryCaviraOSS/OpenMemorySkill4.6k19d agoApache-2.0A96Claude Code, Codex
memseek-remembermemseekai/memseekSkill11yesterdayApache-2.0A24Claude Code
memseek-explainmemseekai/memseekSkill11yesterdayApache-2.0A25Claude Code
memseek-searchmemseekai/memseekSkill11yesterdayApache-2.0A22Claude Code
surface-learningsterrizoaguimor/celiums-memorySkill232mo agoApache-2.0A60Claude Code
context-recoveryterrizoaguimor/celiums-memorySkill232mo agoApache-2.0A37Claude Code