self-hosted-companion SKILL.md skillB
self-hosted-companion from topoteretes/cognee is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add topoteretes/cognee/self-hosted-companion@git:20261006.5dcb57dPins git:20261006.5dcb57d in mdr.lock. Pin the fingerprint instead.
- Audit grade
- B, 16 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- topoteretes/cognee
- Path
.agents/skills/self-hosted-companion/SKILL.md- Versions recorded
- 4
- Latest version
- git:20261006.5dcb57d, committed Oct 6, 2026
- First version recorded
- Oct 2, 2026
- Size
- 2,785 bytes
- Repository stars
- 33,092
- License
- Apache-2.0
Chat with a companion that knows your notes folder (a journal, an Obsidian vault, any .md or .txt files) and every earlier chat, using cognee memory with local databases. Use when someone wants to ask questions about their own notes, or to talk with a companion that remembers past conversations. Runs locally; reads the notes folder, writes only to cognee's memory.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Self-hosted AI companion
Runs the self-hosted companion cookbook in `examples/cookbooks/self_hosted_companion/`. It
remembers a notes folder in the cognee dataset `self_hosted_companion`, then answers
messages about it; each chat is saved to memory, so a later one knows it. Setup, the
scripts and what each one does are in the cookbook's
[`README.md`](../../../examples/cookbooks/self_hosted_companion/README.md).
Run every command from the repo root.
## Steps
Without a notes folder of the user's own, or to see it work first, leave out `<folder>`
below: the run then uses sample notes (the `[setup]` line says so). It needs only
`LLM_API_KEY`. Tell the user the answer comes from sample notes.
1. Run
`uv run python examples/cookbooks/self_hosted_companion/self_hosted_companion.py --check <folder>`
with the notes folder the user named.
- Exit 0: go to step 2.
- Exit 2: each `[setup] MISSING:` line names one fix. Tell the user which line to fix,
using the README's "What it needs" table, and stop.
2. You can't type into the interactive chat, so pass the user's message with `--ask`:
…Read the whole file at its exact version.
How to install
mdr add topoteretes/cognee/self-hosted-companion@sha256:3690fde551399278The line at the top of this page pins the label git:20261006.5dcb57d, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_mrpzx4afrau5vsxm)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 4 versions of this file, between Oct 2, 2026 and Oct 6, 2026, about one every day.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261006.5dcb57d latest | 2026-10-06 | 5dcb57d | 2,785 B | B | view · diff |
| git:20261002.e410ff8 | 2026-10-02 | e410ff8 | 2,502 B | B | view · diff |
| git:20261002.cb4472d | 2026-10-02 | cb4472d | 2,506 B | B | view · diff |
| git:20261002.d8b95f5 | 2026-10-02 | d8b95f5 | 2,266 B | B | view |
Audit of the latest version
- fail: No instruction to read or print local credentials (matched: print `.env)
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (2785 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.
Source
topoteretes/cognee · 33,092 stars · license Apache-2.0 · pushed 2026-11-05 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_mrpzx4afrau5vsxm GET https://markdownregistry.com/api/v1/resolve?ref=topoteretes/cognee/self-hosted-companion GET https://markdownregistry.com/api/v1/blob/3690fde551399278195d7b5ea6714cb6799bfa48b0e7a93dd12dcb536e027106
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.