Agent Skills › vectorize-io/hindsight › hindsight-docs

hindsight-docs

GitHub

提供 Hindsight AI 代理记忆系统的完整技术文档，涵盖架构、API、SDK集成及配置指南，用于快速查阅最佳实践和解决开发问题。

skills/hindsight-docs/SKILL.md vectorize-io/hindsight

Trigger Scenarios

查询 Hindsight 架构或核心概念学习 API 操作或 SDK 集成方法排查性能问题或调试配置错误

Install

npx skills add vectorize-io/hindsight --skill hindsight-docs -g -y

More Options

Use without installing

npx skills use vectorize-io/hindsight@hindsight-docs

指定 Agent (Claude Code)

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

安装 repo 全部 skill

npx skills add vectorize-io/hindsight --all -g -y

预览 repo 内 skill

npx skills add vectorize-io/hindsight --list

SKILL.md

Frontmatter

{
    "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)

# 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)

# 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