Agent skill

Hindsight Docs

by vectorize-io in vectorize-io/hindsight

Complete Hindsight documentation for AI agents. An agent skill from vectorize-io/hindsight.

Install Hindsight Docs

skills CLI

$ npx skills add vectorize-io/hindsight --skill hindsight-docs -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install vectorize-io/hindsight hindsight-docs --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/vectorize-io/hindsight.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/hindsight-docs .claude/skills/hindsight-docs && rm -rf skills-src

Use ~/.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/

Paste into Claude Code

Install the "hindsight-docs" agent skill from https://github.com/vectorize-io/hindsight/tree/main/skills/hindsight-docs into .claude/skills/hindsight-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hindsight-docs", 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

$skill-installer install https://github.com/vectorize-io/hindsight/tree/main/skills/hindsight-docs

Type 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.

skills CLI

$ npx skills add vectorize-io/hindsight --skill hindsight-docs -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install vectorize-io/hindsight hindsight-docs --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/vectorize-io/hindsight.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/hindsight-docs .agents/skills/hindsight-docs && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "hindsight-docs" agent skill from https://github.com/vectorize-io/hindsight/tree/main/skills/hindsight-docs into .agents/skills/hindsight-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hindsight-docs", 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.

skills CLI

$ npx skills add vectorize-io/hindsight --skill hindsight-docs -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install vectorize-io/hindsight hindsight-docs --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/vectorize-io/hindsight.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/hindsight-docs .cursor/skills/hindsight-docs && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "hindsight-docs" agent skill from https://github.com/vectorize-io/hindsight/tree/main/skills/hindsight-docs into .cursor/skills/hindsight-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hindsight-docs", 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

$ gemini skills install https://github.com/vectorize-io/hindsight.git --path skills/hindsight-docs

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add vectorize-io/hindsight --skill hindsight-docs -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install vectorize-io/hindsight hindsight-docs --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/vectorize-io/hindsight.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/hindsight-docs .gemini/skills/hindsight-docs && rm -rf skills-src

Use ~/.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/

Paste into Gemini CLI

Install the "hindsight-docs" agent skill from https://github.com/vectorize-io/hindsight/tree/main/skills/hindsight-docs into .gemini/skills/hindsight-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hindsight-docs", 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.

GitHub CLI

$ gh skill install vectorize-io/hindsight hindsight-docs

Installs 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).

skills CLI

$ npx skills add vectorize-io/hindsight --skill hindsight-docs -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/vectorize-io/hindsight.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/hindsight-docs .github/skills/hindsight-docs && rm -rf skills-src

Use ~/.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/

Paste into GitHub Copilot

Install the "hindsight-docs" agent skill from https://github.com/vectorize-io/hindsight/tree/main/skills/hindsight-docs into .github/skills/hindsight-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hindsight-docs", 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.

skills CLI

$ npx skills add vectorize-io/hindsight --skill hindsight-docs -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install vectorize-io/hindsight hindsight-docs --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/vectorize-io/hindsight.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/hindsight-docs .opencode/skills/hindsight-docs && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "hindsight-docs" agent skill from https://github.com/vectorize-io/hindsight/tree/main/skills/hindsight-docs into .opencode/skills/hindsight-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hindsight-docs", 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.

Facts

Skill name: hindsight-docs
GitHub stars: 46k
Token cost: ~928 tokens
SKILL.md length: 235 words
Files: 164 (incl. references)
Skills in repo: 17
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Complete Hindsight documentation for AI agents. An agent skill from vectorize-io/hindsight.

Works in 3 steps: Find Files by Pattern (use Glob tool) → Search Content (use Grep tool) → Read Full Documentation (use Read tool)
Agent Workflows work in your project
SKILL.md covers When to Use This Skill, Documentation Structure, How to Find Documentation and Start Here: Best Practices, plus 2 more sections
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Hindsight Docs is an agent skill from vectorize-io/hindsight. Complete Hindsight documentation for AI agents. Use this to learn about Hindsight architecture, APIs, configuration, and best practices.

Its SKILL.md is about 930 tokens, which your agent loads only when the skill is triggered. The skill folder holds 166 other files, including reference files (for example `references/best-practices.md`, `references/changelog/index.md` and `references/changelog/integrations/ag2.md`).

It sits in Agent Workflows. The repository describes itself as: Hindsight: Agent Memory That Learns. The licence is MIT.

When your agent uses it

Agent Workflows work in your project

Example prompts

“/hindsight-docs”

Requirements

Python 3
Node.js
Docker

Workflow steps

3 steps, taken from the step headings in SKILL.md.

Find Files by Pattern (use Glob tool)
Search Content (use Grep tool)
Read Full Documentation (use Read tool)

What it can do on your machine

Read from SKILL.md and the folder at commit 9269b88. It shows what the files ask for, not the result of running them.

Tool permissions
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.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Hindsight Docs loads about 928 tokens when it runs, and up to ~811k if it reads all its reference files. Until then it costs about 38 tokens; SKILL.md has 235 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~38
When it runs · the whole SKILL.md, loaded when a task matches: ~928
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~811k

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.

Safety

Auto-check passed

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.

SKILL.md

The full file from vectorize-io/hindsight at commit 9269b88, republished under its MIT licence (© vectorize-io). 235 words, ~928 tokens.

Download SKILL.mdSave it as .claude/skills/hindsight-docs/SKILL.md (or your agent's skills folder). This skill also uses 163 other files; get the full folder from GitHub.

name: hindsight-docs
description: Complete Hindsight documentation for AI agents. Use this to learn about Hindsight architecture, APIs, configuration, and best practices.

Hindsight Documentation Skill

Complete technical documentation for Hindsight - a biomimetic memory system for AI agents.

When to Use This Skill

Use this skill when you need to:

Understand Hindsight architecture and core concepts
Learn about retain/recall/reflect operations
Configure memory banks and dispositions
Set up the Hindsight API server (Docker, Kubernetes, pip)
Integrate with Python/Node.js/Rust SDKs
Understand retrieval strategies (semantic, BM25, graph, temporal)
Debug issues or optimize performance
Review API endpoints and parameters

Documentation Structure

All documentation is in references/ organized by category:

references/
├── best-practices.md # START HERE — missions, tags, formats, anti-patterns
├── faq.md            # Common questions and decisions
├── changelog/        # Release history and version changes (index.md + integrations/)
├── openapi.json      # Full OpenAPI spec — endpoint schemas, request/response models
├── developer/
│   ├── api/          # Core operations: retain, recall, reflect, memory banks
│   └── *.md          # Architecture, configuration, deployment, performance
└── sdks/
    ├── *.md          # Python, Node.js, CLI, embedded
    └── integrations/ # Framework and tool integrations

How to Find Documentation

1. Find Files by Pattern (use Glob tool)

bash

# Core API operations
references/developer/api/*.md

# SDK documentation
references/sdks/*.md
references/sdks/integrations/*.md

# Find specific topics
references/**/configuration.md
references/**/*python*.md
references/**/*deployment*.md

2. Search Content (use Grep tool)

bash

# Search for concepts
pattern: "disposition"        # Memory bank configuration
pattern: "graph retrieval"    # Graph-based search
pattern: "helm install"       # Kubernetes deployment
pattern: "document_id"        # Document management
pattern: "HINDSIGHT_API_"     # Environment variables

# Search in specific areas
path: references/developer/api/
pattern: "POST /v1"           # Find API endpoints

path: references/sdks/
pattern: "def |async def "    # Find Python examples

3. Read Full Documentation (use Read tool)

references/developer/api/retain.md
references/sdks/python.md
references/sdks/integrations/litellm.md

Start Here: Best Practices

Before reading API docs, read the best practices guide. It covers practical rules for missions, tags, content format, observation scopes, and anti-patterns — the fastest way to integrate correctly.

references/best-practices.md

Key Concepts

Memory Banks: Isolated memory stores (one per user/agent)
Retain: Store memories (auto-extracts facts/entities/relationships)
Recall: Retrieve memories (4 parallel strategies: semantic, BM25, graph, temporal)
Reflect: Disposition-aware reasoning using memories
document_id: Groups messages in a conversation (upsert on same ID)
Dispositions: Skepticism, literalism, empathy traits (1-5) affecting reflect
Mental Models: Consolidated knowledge synthesized from facts

Notes

Code examples are inlined from working examples
Configuration uses HINDSIGHT_API_* environment variables
Database migrations run automatically on startup
Multi-bank queries require client-side orchestration
Use document_id for conversation evolution (same ID = upsert)

Auto-generated from hindsight-docs/docs/ and hindsight-docs/docs-integrations/. Run ./scripts/generate-docs-skill.sh to update.

Files

SKILL.md and 163 other files (references) in skills/hindsight-docs of vectorize-io/hindsight.

SKILL.md
references/best-practices.md
references/changelog/index.md
references/changelog/integrations/ag2.md
references/changelog/integrations/agent-framework.md
references/changelog/integrations/agentcore.md
references/changelog/integrations/agno.md
references/changelog/integrations/ai-sdk.md
references/changelog/integrations/aider.md
references/changelog/integrations/autogen.md
references/changelog/integrations/chat.md
references/changelog/integrations/claude-agent-sdk.md
references/changelog/integrations/claude-code.md
references/changelog/integrations/cline.md
references/changelog/integrations/cloudflare-oauth-proxy.md
references/changelog/integrations/codex.md
references/changelog/integrations/coding-agents.md
references/changelog/integrations/composio.md
… and 146 more

Open the folder on GitHubat commit 9269b88

Compare with similar skills

Hindsight Docs 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.

Hindsight Docs compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Hindsight Docs this skillvectorize-io/hindsight	46k	—	~928	Automated safety check: Pass	MIT	today
MCP Server Builderanthropics/skills	180k	62 repos	~2.3k	Automated safety check: Pass	Apache-2.0	2 days ago
Hook Development for Claude Code Pluginsanthropics/claude-plugins-official	37k	11 repos	~4.1k	Automated safety check: Notes	Apache-2.0	today
Using Superpowersfarm-fe/farm	5.6k	34 repos	~1.4k	Automated safety check: Pass	MIT	15 days ago
Executing Plans Inlineobra/superpowers	296k	2 repos	~5.1k	Automated safety check: Pass	MIT	today
Claude Code Agent Developmentanthropics/claude-plugins-official	37k	8 repos	~2.8k	Automated safety check: Pass	Apache-2.0	today

Similar skills

MCP Server Builder
anthropics/skills
Official
Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.
180k GitHub starsUsed in 62 repos~2.3k tokens
Agent WorkflowsAuto-check passed
Hook Development for Claude Code Plugins
anthropics/claude-plugins-official
Official
Explains how to write Claude Code plugin hooks, both prompt-based checks and bash commands, for events such as PreToolUse, Stop and SessionStart.
37k GitHub starsUsed in 11 repos~4.1k tokens
Agent WorkflowsAuto-check: notes
Using Superpowers
farm-fe/farm
A skill your agent uses when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY response including clarifying questions
5.6k GitHub starsUsed in 34 repos~1.4k tokens
Agent WorkflowsAuto-check passed
Executing Plans Inline
obra/superpowers
Has the agent carry out an implementation plan itself, task by task in the current session, keeping a ledger, proving each step with a test and ending with one whole-branch review.
296k GitHub starsUsed in 2 repos~5.1k tokens
Agent WorkflowsAuto-check passed
Claude Code Agent Development
anthropics/claude-plugins-official
Official
Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.
37k GitHub starsUsed in 8 repos~2.8k tokens
Agent WorkflowsAuto-check passed
Skill Creator
Azure/azqr
Official
Create new skills, modify and improve existing skills, and measure skill performance.
794 GitHub starsUsed in 89 repos~8.2k tokens
Agent WorkflowsAuto-check passed

Questions about Hindsight Docs

What does Hindsight Docs do?

Complete Hindsight documentation for AI agents. An agent skill from vectorize-io/hindsight. Hindsight Docs is an agent skill from vectorize-io/hindsight. Complete Hindsight documentation for AI agents.

When should I use Hindsight Docs?

Hindsight Docs fits situations like: agent Workflows work in your project.

How do I install Hindsight Docs in Claude Code?

Run `npx skills add vectorize-io/hindsight --skill hindsight-docs -a claude-code`. Or copy the skill folder (skills/hindsight-docs in vectorize-io/hindsight) into .claude/skills/hindsight-docs in your project. Claude Code loads it when a task matches its description.

How do I install Hindsight Docs in Codex?

Run `npx skills add vectorize-io/hindsight --skill hindsight-docs -a codex`. Or copy the skill folder (skills/hindsight-docs in vectorize-io/hindsight) into .agents/skills/hindsight-docs in your project. Codex loads it when a task matches its description.

Can I use Hindsight Docs in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add vectorize-io/hindsight --skill hindsight-docs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hindsight-docs, .gemini/skills/hindsight-docs, .github/skills/hindsight-docs and .opencode/skills/hindsight-docs in your project.

What does Hindsight Docs need to run?

SKILL.md names no scripts, command-line tools or credentials: Hindsight Docs is instructions for the agent only. Our summary lists: Python 3; Node.js; Docker.

Does Hindsight Docs access the network?

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.

Is Hindsight Docs safe to install?

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.

What licence does Hindsight Docs use?

Hindsight Docs is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Hindsight Docs use?

About 928 tokens (SKILL.md is roughly 3.7k 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 810k tokens, read only when the agent opens those files.

What are the alternatives to Hindsight Docs?

Skills that share tags, products or a category with Hindsight Docs: MCP Server Builder (anthropics/skills, 180k stars), Hook Development for Claude Code Plugins (anthropics/claude-plugins-official, 37k stars), Using Superpowers (farm-fe/farm, 5.6k stars) and Executing Plans Inline (obra/superpowers, 296k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hindsight Docs?

vectorize-io (a GitHub organization) maintains it in vectorize-io/hindsight, which has 46,453 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 7, 2026.

Source: vectorize-io/hindsight on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Hindsight Docs

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Hindsight Documentation Skill

When to Use This Skill

Documentation Structure

How to Find Documentation

1. Find Files by Pattern (use Glob tool)

2. Search Content (use Grep tool)

3. Read Full Documentation (use Read tool)

Start Here: Best Practices

Key Concepts

Notes

Files

Compare with similar skills

Similar skills

More from vectorize-io/hindsight

Related

Questions about Hindsight Docs