#467 by GitHub stars

kingkongshot/Pensieve

Project knowledge base and workflow router. knowledge/ caches explored file locations, module boundaries, and call chains for reuse; decisions/maxims are established architecture decisions and coding standards to follow, not relitigate; pipelines are reusable workflows; short-term/ stages new conclu

Codex Engineering

History

Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.

View weekly changes

`SKILL.md`

Week of Nov 2, 2026 · +0 / −0 lines

Before Network or broad shell → After Network or broad shell

8731f61b18a6 → 8731f61b18a6

Compare on GitHub

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Network or broad shell

First observation → 8731f61b18a6

No earlier version was observed for comparison.

Compare on GitHub

View on GitHub Add to my skills

Verified commit 8731f61b18a65f09eb0d3cd1ffbff7650ef8df48

Version-pinned installation · Codex

git clone --filter=blob:none --no-checkout https://github.com/kingkongshot/Pensieve.git .hotskills/kingkongshot-pensieve && git -C .hotskills/kingkongshot-pensieve checkout --detach 8731f61b18a65f09eb0d3cd1ffbff7650ef8df48
# Copy each selected skill directory from .hotskills/kingkongshot-pensieve into .agents/skills/<skill-name>/

2.5kGitHub stars

-1star in 7 days

1skill in this repository

0commits in 30 days

Heat

1.1

Star growth, last 7 daysAhead of 6% of tracked repositories
Star growth, last 24 hoursAhead of 3% of tracked repositories
Rank movement, last 7 daysAhead of 45% of tracked repositories
Commits, last 30 daysAhead of 0% of tracked repositories
Accounts asking about it through MCP, last 7 daysNot available
Hot votes this weekAhead of 0% of tracked repositories

Heat never changes the order by stars, and sponsorship never touches it. How heat works

Stars over time

Individual skills in this repository

pensieve /

How it works

pensieve

When your agent uses it

Project knowledge base and workflow router. knowledge/ caches explored file locations, module boundaries, and call chains for reuse; decisions/maxims are established architecture decisions and coding standards to follow, not relitigate; pipelines are reusable workflows; short-term/ stages new conclusions until promotion or deletion. Use self-improve after completing work to capture new insights. Provides seven tools: init, upgrade, migrate, doctor, self-improve, refine, and sync-instructions.

What it loads into context

Frontmatter

113 tokens

Always available to the agent

SKILL.md

397 tokens

When the skill is activated

Reference documents

22,158 tokens

Loaded on request

Token counts are estimates. Scripts run separately; they are not counted as reference context.

The playbook

Routing
Project Data

Scripts executed separately

.src/core/doctor_engine.py
.src/core/pensieve_core.py
.src/scripts/check-frontmatter.sh
.src/scripts/explore-prehook.sh
.src/scripts/generate-user-data-graph.sh
.src/scripts/init-project-data.sh
.src/scripts/install-hooks.sh
.src/scripts/lib.sh
.src/scripts/maintain-auto-memory.sh
.src/scripts/maintain-project-state.sh
.src/scripts/pensieve-session-marker.sh
.src/scripts/run-doctor.sh
.src/scripts/run-hook.sh
.src/scripts/run-migrate.sh
.src/scripts/run-upgrade.sh
.src/scripts/scan-structure.sh
.src/scripts/sync-instructions.sh
.src/scripts/sync-project-skill-graph.sh

Files

.codex/skills/pensieve-sync-to-main/SKILL.mddoc4,579 bytes
.codex/skills/pensieve-sync-to-main/agents/openai.yamlasset220 bytes
.gitignoreasset204 bytes
.src/core/doctor_engine.pyruns16,408 bytes
.src/core/pensieve_core.pyruns4,400 bytes
.src/core/schema.jsonasset2,828 bytes
.src/loop/DESIGN.template.mddoc86 bytes
.src/loop/REQUIREMENTS.template.mddoc95 bytes
.src/manifest.jsonasset81 bytes
.src/references/decisions.mddoc1,462 bytes
.src/references/directory-layout.mddoc3,568 bytes
.src/references/knowledge.mddoc1,739 bytes
.src/references/maxims.mddoc1,371 bytes
.src/references/pipelines.mddoc2,793 bytes
.src/references/shared-rules.mddoc2,124 bytes
.src/references/short-term.mddoc1,609 bytes
.src/references/skill-lifecycle.mddoc3,919 bytes
.src/references/tool-boundaries.mddoc1,674 bytes
.src/scripts/check-frontmatter.shruns12,348 bytes
.src/scripts/explore-prehook.shruns3,282 bytes
.src/scripts/generate-user-data-graph.shruns10,179 bytes
.src/scripts/init-project-data.shruns4,863 bytes
.src/scripts/install-hooks.shruns3,941 bytes
.src/scripts/lib.shruns12,152 bytes
.src/scripts/maintain-auto-memory.shruns3,856 bytes
.src/scripts/maintain-project-state.shruns6,804 bytes
.src/scripts/pensieve-session-marker.shruns9,787 bytes
.src/scripts/run-doctor.shruns6,057 bytes
.src/scripts/run-hook.shruns2,309 bytes
.src/scripts/run-migrate.shruns20,100 bytes
.src/scripts/run-upgrade.shruns6,185 bytes
.src/scripts/scan-structure.shruns18,845 bytes
.src/scripts/sync-instructions.shruns6,974 bytes
.src/scripts/sync-project-skill-graph.shruns2,101 bytes
.src/templates/agents/pensieve-wand.mddoc8,129 bytes
.src/templates/knowledge/taste-review/content.mddoc5,732 bytes
.src/templates/maxims/eliminate-special-cases-by-redesigning-data-flow.mddoc1,018 bytes
.src/templates/maxims/prefer-pragmatic-solutions-over-theoretical-completeness.mddoc930 bytes
.src/templates/maxims/preserve-user-visible-behavior-as-a-hard-rule.mddoc913 bytes
.src/templates/maxims/reduce-complexity-before-adding-branches.mddoc911 bytes
.src/templates/pipelines/run-when-committing.mddoc5,593 bytes
.src/templates/pipelines/run-when-refactoring.mddoc4,417 bytes
.src/templates/pipelines/run-when-reviewing-code.mddoc5,865 bytes
.src/tools/doctor.mddoc1,409 bytes
.src/tools/init.mddoc1,750 bytes
.src/tools/migrate.mddoc1,133 bytes
.src/tools/refine.mddoc4,838 bytes
.src/tools/self-improve.mddoc1,800 bytes
.src/tools/sync-instructions.mddoc2,785 bytes
.src/tools/upgrade.mddoc1,310 bytes
CHANGELOG.mddoc6,953 bytes
LICENSEasset1,069 bytes
README.mddoc13,976 bytes
SKILL.mdcore1,744 bytes
SKILL.mdcore1,744 bytes
agents/openai.yamlasset108 bytes
docs/QRCode.pngasset351,716 bytes
docs/graph-detail.pngasset203,794 bytes
docs/graph-overview.pngasset210,135 bytes

Read SKILL.md


# Pensieve

Route user requests to the correct tool. When in doubt, confirm first.

## Routing
- Init: Initialize the current project user-data directory and seed files. Tool spec: `.src/tools/init.md`.
- Upgrade: Refresh Pensieve skill source code in the global git clone. Tool spec: `.src/tools/upgrade.md`.
- Migrate: Run structural migration and legacy cleanup. Tool spec: `.src/tools/migrate.md`.
- Doctor: Read-only scan of the current project user-data directory. Tool spec: `.src/tools/doctor.md`.
- Self-Improve: Extract reusable conclusions and write them into user data. Tool spec: `.src/tools/self-improve.md`.
- Refine: Refine the knowledge base with triage review and compression. Tool spec: `.src/tools/refine.md`.
- Sync Instructions: Write existing pipeline short routes into `CLAUDE.md` / `AGENTS.md`. Tool spec: `.src/tools/sync-instructions.md`.
- Graph View: Read `<project-root>/.pensieve/.state/pensieve-user-data-graph.md`.

View the complete source on GitHub

Skills included

pensieve

Repository facts

License: MIT
Created: Jun 27, 2025
Last pushed: May 8, 2026
Forks: 250
Open issues: 5
Project activity: Slowing

Rank over the last 12 weeks

Now #467 · best #343 · down 75 in 30 days

#458 on Oct 30
#460 from Oct 31 to Nov 1
#461 on Nov 2
#462 from Nov 3 to Nov 5
#466 on Nov 6
#467 since Nov 7

19 earlier periods

#319 on Aug 1
#322 on Aug 6
#324 on Aug 10
#325 on Aug 11
#326 on Aug 14
#343 on Aug 26
#356 on Sep 3
#355 on Sep 5
#360 on Sep 8
#363 on Sep 10
#392 on Oct 8
#398 on Oct 11
#418 on Oct 19
#423 on Oct 20
#427 on Oct 21
#426 on Oct 23
#443 on Oct 25
#453 on Oct 28
#456 on Oct 29

Before you install

Network or broad shell

Automated signals, not a guarantee

Checked Nov 3, 2026

Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.

Show 1 note

SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed

No broad tool permissions
5 dangerous shell commandsin 2 files: .src/references/skill-lifecycle.md:99 .src/scripts/sync-instructions.sh:238
25 network referencesin 4 files: README.md:7 .src/references/skill-lifecycle.md:22 .src/templates/knowledge/taste-review/content.md:25 and 1 more
No hidden or obfuscated text
1 instruction override signalin 1 file: .src/templates/pipelines/run-when-committing.md:89
18 executable scriptsin 18 files: .src/core/doctor_engine.py:1 .src/core/pensieve_core.py:1 .src/scripts/check-frontmatter.sh:1 and 15 more
No access to secrets
No requests to vote in Hot

Show all 49 signals by file

`.src/core/doctor_engine.py`

Executable scriptline 1
```
Executable file
```

`.src/core/pensieve_core.py`

Executable scriptline 1
```
Executable file
```

`.src/references/skill-lifecycle.md`

Network accessline 22

# English users git clone -b main https://github.com/kingkongshot/Pensieve.git ~/.claude/skills/pensieve

Network accessline 23

git clone -b main https://github.com/kingkongshot/Pensieve.git ~/.claude/skills/pensieve

Network accessline 25

# Chinese users git clone -b zh https://github.com/kingkongshot/Pensieve.git ~/.claude/skills/pensieve

Network accessline 26

git clone -b zh https://github.com/kingkongshot/Pensieve.git ~/.claude/skills/pensieve

Dangerous shell operationline 99

2. Delete the old skill checkout: `rm -rf ~/.claude/skills/pensieve`

Dangerous shell operationline 111
```
rm -rf ~/.claude/skills/pensieve
```
Dangerous shell operationline 114
```
rm -rf <project>/.pensieve
```

`.src/scripts/check-frontmatter.sh`

Executable scriptline 1
```
#!/bin/bash
```

`.src/scripts/explore-prehook.sh`

Executable scriptline 1
```
#!/bin/bash
```

`.src/scripts/generate-user-data-graph.sh`

Executable scriptline 1
```
#!/bin/bash
```

`.src/scripts/init-project-data.sh`

Executable scriptline 1
```
#!/bin/bash
```

`.src/scripts/install-hooks.sh`

Executable scriptline 1
```
#!/bin/bash
```

`.src/scripts/lib.sh`

Executable scriptline 1
```
#!/bin/bash
```

`.src/scripts/maintain-auto-memory.sh`

Executable scriptline 1
```
#!/bin/bash
```

`.src/scripts/maintain-project-state.sh`

Executable scriptline 1
```
#!/bin/bash
```

`.src/scripts/pensieve-session-marker.sh`

Executable scriptline 1
```
#!/bin/bash
```

`.src/scripts/run-doctor.sh`

Executable scriptline 1
```
#!/bin/bash
```

`.src/scripts/run-hook.sh`

Executable scriptline 1
```
#!/bin/bash
```

`.src/scripts/run-migrate.sh`

Executable scriptline 1
```
#!/bin/bash
```

`.src/scripts/run-upgrade.sh`

Executable scriptline 1
```
#!/bin/bash
```

`.src/scripts/scan-structure.sh`

Executable scriptline 1
```
#!/bin/bash
```

`.src/scripts/sync-instructions.sh`

Executable scriptline 1
```
#!/bin/bash
```
Dangerous shell operationline 238
```
rm -f "$BLOCK_FILE"
```
Dangerous shell operationline 252
```
rm -f "$BLOCK_FILE"
```

`.src/scripts/sync-project-skill-graph.sh`

Executable scriptline 1
```
#!/bin/bash
```

`.src/templates/knowledge/taste-review/content.md`

Network accessline 25

- Google Style Guides: https://github.com/google/styleguide

Network accessline 30

mkdir -p source/google-style-guides curl -o source/google-style-guides/pyguide.md https://raw.githubusercontent.com/google/styleguide/gh-pages/pyguide.md

Network accessline 31

curl -o source/google-style-guides/pyguide.md https://raw.githubusercontent.com/google/styleguide/gh-pages/pyguide.md

Network accessline 32

curl -o source/google-style-guides/tsguide.html https://raw.githubusercontent.com/google/styleguide/gh-pages/tsguide.html

`.src/templates/pipelines/run-when-committing.md`

Instruction override signalline 89

**DO NOT**: Do not ask user for confirmation, do not show drafts awaiting approval, write directly

`CHANGELOG.md`

Network accessline 92

# 1. Install system code globally git clone -b main https://github.com/kingkongshot/Pensieve.git ~/.claude/skills/pensieve

Network accessline 93

git clone -b main https://github.com/kingkongshot/Pensieve.git ~/.claude/skills/pensieve

`README.md`

Network accessline 7

[![GitHub Stars](https://img.shields.io/github/stars/kingkongshot/Pensieve?color=ffcb47&labelColor=black&style=flat-square)](https://github.com/kingkongshot/Pensieve/stargazers)

Network accessline 8

[![License](https://img.shields.io/badge/license-MIT-white?labelColor=black&style=flat-square)](LICENSE)

Network accessline 10

[中文 README](https://github.com/kingkongshot/Pensieve/blob/zh/README.md)

Network accessline 109

# 1. Global install (one-time only) git clone -b main https://github.com/kingkongshot/Pensieve.git ~/.claude/skills/pensieve

Network accessline 110

git clone -b main https://github.com/kingkongshot/Pensieve.git ~/.claude/skills/pensieve

Network accessline 128

# 1. Global install (one-time only) git clone -b main https://github.com/kingkongshot/Pensieve.git <skill-path>

Network accessline 129

git clone -b main https://github.com/kingkongshot/Pensieve.git <skill-path>

Network accessline 154

# Check if parent directory is a git repo (some users sync configs with git)     if git -C "$SKILL_PARENT/.." rev-parse --is-inside-work-tree >/dev/null 2>&1; then         git -C "$SKILL_PARENT/.." submodule add -b main https://github.com/k

Network accessline 155

if git -C "$SKILL_PARENT/.." rev-parse --is-inside-work-tree >/dev/null 2>&1; then         git -C "$SKILL_PARENT/.." submodule add -b main https://github.com/kingkongshot/Pensieve.git "skills/pensieve"     else

Network accessline 156

git -C "$SKILL_PARENT/.." submodule add -b main https://github.com/kingkongshot/Pensieve.git "skills/pensieve"

Network accessline 157

else         git clone -b main https://github.com/kingkongshot/Pensieve.git "$SKILL_PATH"     fi

Network accessline 158

git clone -b main https://github.com/kingkongshot/Pensieve.git "$SKILL_PATH"

Network accessline 229

# 1. Global install system code (if not already installed) if [[ ! -d <skill-path> ]]; then     git clone -b main https://github.com/kingkongshot/Pensieve.git <skill-path>

Network accessline 230

if [[ ! -d <skill-path> ]]; then     git clone -b main https://github.com/kingkongshot/Pensieve.git <skill-path> fi

Network accessline 231

git clone -b main https://github.com/kingkongshot/Pensieve.git <skill-path>

How the signals fit together

Facts from a static read of the files at the pinned commit. They describe what the code does, not why.

Signal confidence: 49 facts

Executable script in code of a file that runs.src/core/doctor_engine.py:1High confidence
Executable script in code of a file that runs.src/core/pensieve_core.py:1High confidence
Network access in code of documentation.src/references/skill-lifecycle.md:22Low confidence
Network access in code of documentation.src/references/skill-lifecycle.md:23Low confidence
Network access in code of documentation.src/references/skill-lifecycle.md:25Low confidence
Network access in code of documentation.src/references/skill-lifecycle.md:26Low confidence
Dangerous shell operation in prose of documentation.src/references/skill-lifecycle.md:99Low confidence
Dangerous shell operation in code of documentation.src/references/skill-lifecycle.md:111Low confidence
Dangerous shell operation in code of documentation.src/references/skill-lifecycle.md:114Low confidence
Executable script in code of a file that runs.src/scripts/check-frontmatter.sh:1High confidence
Executable script in code of a file that runs.src/scripts/explore-prehook.sh:1High confidence
Executable script in code of a file that runs.src/scripts/generate-user-data-graph.sh:1High confidence
Executable script in code of a file that runs.src/scripts/init-project-data.sh:1High confidence
Executable script in code of a file that runs.src/scripts/install-hooks.sh:1High confidence
Executable script in code of a file that runs.src/scripts/lib.sh:1High confidence
Executable script in code of a file that runs.src/scripts/maintain-auto-memory.sh:1High confidence
Executable script in code of a file that runs.src/scripts/maintain-project-state.sh:1High confidence
Executable script in code of a file that runs.src/scripts/pensieve-session-marker.sh:1High confidence
Executable script in code of a file that runs.src/scripts/run-doctor.sh:1High confidence
Executable script in code of a file that runs.src/scripts/run-hook.sh:1High confidence
Executable script in code of a file that runs.src/scripts/run-migrate.sh:1High confidence
Executable script in code of a file that runs.src/scripts/run-upgrade.sh:1High confidence
Executable script in code of a file that runs.src/scripts/scan-structure.sh:1High confidence
Executable script in code of a file that runs.src/scripts/sync-instructions.sh:1High confidence
Dangerous shell operation in code of a file that runs.src/scripts/sync-instructions.sh:238High confidence
Dangerous shell operation in code of a file that runs.src/scripts/sync-instructions.sh:252High confidence
Executable script in code of a file that runs.src/scripts/sync-project-skill-graph.sh:1High confidence
Network access in prose of documentation.src/templates/knowledge/taste-review/content.md:25Low confidence
Network access in code of documentation.src/templates/knowledge/taste-review/content.md:30Low confidence
Network access in code of documentation.src/templates/knowledge/taste-review/content.md:31Low confidence
Network access in code of documentation.src/templates/knowledge/taste-review/content.md:32Low confidence
Instruction override signal in prose of documentation.src/templates/pipelines/run-when-committing.md:89Low confidence
Network access in code of documentationCHANGELOG.md:92Low confidence
Network access in code of documentationCHANGELOG.md:93Low confidence
Network access in prose of documentationREADME.md:7Low confidence
Network access in prose of documentationREADME.md:8Low confidence
Network access in prose of documentationREADME.md:10Low confidence
Network access in code of documentationREADME.md:109Low confidence
Network access in code of documentationREADME.md:110Low confidence
Network access in code of documentationREADME.md:128Low confidence
Network access in code of documentationREADME.md:129Low confidence
Network access in code of documentationREADME.md:154Low confidence
Network access in code of documentationREADME.md:155Low confidence
Network access in code of documentationREADME.md:156Low confidence
Network access in code of documentationREADME.md:157Low confidence
Network access in code of documentationREADME.md:158Low confidence
Network access in code of documentationREADME.md:229Low confidence
Network access in code of documentationREADME.md:230Low confidence
Network access in code of documentationREADME.md:231Low confidence

Works with

Agent compatibility, from the files in this repository
Agent	Status	Evidence	Install to
Claude Code	Compatible	Standard SKILL.md SKILL.md	`.claude/skills/<skill-name>/`
Codex	Native	Path .codex/skills/pensieve-sync-to-main/SKILL.md	`.agents/skills/<skill-name>/`
Cursor	Compatible	Standard SKILL.md SKILL.md	`.cursor/skills/<skill-name>/`
Gemini CLI	Compatible	Standard SKILL.md SKILL.md	`.gemini/skills/<skill-name>/`
GitHub Copilot	Compatible	Standard SKILL.md SKILL.md	`.github/skills/<skill-name>/`
OpenCode	Compatible	Standard SKILL.md SKILL.md	`.opencode/skills/<skill-name>/`

Native The repository ships a manifest, folder or frontmatter field for this agent.
Compatible A standard SKILL.md that this agent can read.
Unknown No evidence either way.

Derived automatically from paths, manifests and frontmatter. Not tested on each agent.

Explore alternatives and comparisons

Add this badge to your README

It updates every night and links to this page.

[![kingkongshot/Pensieve on hotskills](https://hotskills.dev/badge/kingkongshot-pensieve.svg)](https://hotskills.dev/skill/kingkongshot-pensieve/)

kingkongshot/Pensieve

History

SKILL.md

Share this page

Heat

Stars over time

Individual skills in this repository

How it works

pensieve

Frontmatter

SKILL.md

Reference documents

The playbook

Scripts executed separately

Files

Skills included

Repository facts

Rank over the last 12 weeks

Before you install

.src/core/doctor_engine.py

.src/core/pensieve_core.py

.src/references/skill-lifecycle.md

.src/scripts/check-frontmatter.sh

.src/scripts/explore-prehook.sh

.src/scripts/generate-user-data-graph.sh

.src/scripts/init-project-data.sh

.src/scripts/install-hooks.sh

.src/scripts/lib.sh

.src/scripts/maintain-auto-memory.sh

.src/scripts/maintain-project-state.sh

.src/scripts/pensieve-session-marker.sh

.src/scripts/run-doctor.sh

.src/scripts/run-hook.sh

.src/scripts/run-migrate.sh

.src/scripts/run-upgrade.sh

.src/scripts/scan-structure.sh

.src/scripts/sync-instructions.sh

.src/scripts/sync-project-skill-graph.sh

.src/templates/knowledge/taste-review/content.md

.src/templates/pipelines/run-when-committing.md

CHANGELOG.md

README.md

How the signals fit together

Works with

You might also use

mattpocock/skills

obra/superpowers

NousResearch/hermes-agent

multica-ai/andrej-karpathy-skills

anthropics/skills

DietrichGebert/ponytail

Explore alternatives and comparisons

Add this badge to your README

`SKILL.md`

`.src/core/doctor_engine.py`

`.src/core/pensieve_core.py`

`.src/references/skill-lifecycle.md`

`.src/scripts/check-frontmatter.sh`

`.src/scripts/explore-prehook.sh`

`.src/scripts/generate-user-data-graph.sh`

`.src/scripts/init-project-data.sh`

`.src/scripts/install-hooks.sh`

`.src/scripts/lib.sh`

`.src/scripts/maintain-auto-memory.sh`

`.src/scripts/maintain-project-state.sh`

`.src/scripts/pensieve-session-marker.sh`

`.src/scripts/run-doctor.sh`

`.src/scripts/run-hook.sh`

`.src/scripts/run-migrate.sh`

`.src/scripts/run-upgrade.sh`

`.src/scripts/scan-structure.sh`

`.src/scripts/sync-instructions.sh`

`.src/scripts/sync-project-skill-graph.sh`

`.src/templates/knowledge/taste-review/content.md`

`.src/templates/pipelines/run-when-committing.md`

`CHANGELOG.md`

`README.md`