← 返回 Skills 市场
codezz

BrainRepo

作者 codezz · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
2583
总下载
4
收藏
9
当前安装
1
版本数
在 OpenClaw 中安装
/install brainrepo
功能描述
Your personal knowledge repository — capture, organize, and retrieve everything using PARA + Zettelkasten. Triggers on: "save this", "remember", "note", "capture", "brain dump", daily/weekly reviews, searching stored knowledge, managing projects/areas/people. Works with any AI agent that reads markdown. Stores everything as .md files in a Git repo for Obsidian, VS Code, or any editor.
使用说明 (SKILL.md)

BrainRepo

Your personal knowledge repository. Capture fast, organize automatically, retrieve instantly.

Brain Location

Fixed path: ~/Documents/brainrepo/

This is not configurable. All brain data lives here.

First Run Check

Before any action, check if brainrepo is initialized:

  1. Check if ~/Documents/brainrepo/ exists with expected structure (Inbox/, Projects/, Areas/)
  2. If NOT found → Run onboarding automatically
  3. If found → Proceed with user request

Onboarding

Triggers automatically on first interaction, or when user says "set up brainrepo":

  1. Create brain at ~/Documents/brainrepo/
  2. Create the folder structure:
mkdir -p \x3Cpath>/{Inbox,Projects,Areas/personal-growth,Areas/family,Notes,Resources,Journal,People,Tasks,Archive}

  1. Create initial files from templates in assets/templates/:

    • Tasks/index.md — task hub
    • Areas/personal-growth/index.md — personal growth area
    • Areas/family/index.md — family area

  2. Initialize git (optional):

cd \x3Cpath> && git init && git add -A && git commit -m "init: brainrepo"
  1. Confirm setup and show quick start commands

Core Concept

DUMP → PROCESS → RETRIEVE

  1. Dump — Capture everything to Inbox/ (don't organize yet)
  2. Process — Evening review: Inbox → permanent home
  3. Retrieve — Ask AI to find anything

Repository Structure

brainrepo/
├── Inbox/          # Quick capture (clear daily)
├── Projects/       # Active work with deadlines
├── Areas/          # Ongoing responsibilities (no deadline)
├── Notes/          # Permanent atomic knowledge
├── Resources/      # External links, articles, references
├── Journal/        # Daily notes (YYYY-MM-DD.md)
├── People/         # One note per person
├── Tasks/          # Centralized task tracking
└── Archive/        # Completed projects

See references/structure.md for detailed breakdown.

Capture Rules

What to Capture (Immediately)

Type Destination Example
Quick thought Inbox/ "Maybe we should..."
Decision made Inbox/ or Notes/ "Decided to use Next.js"
Person info People/ New contact or update
Project update Projects/\x3Cname>/ Meeting notes, progress
Task/Todo Tasks/index.md "Need to finish X"
Link/Article Resources/ or Inbox/ URL with context
Personal growth Areas/personal-growth/ Health, habits, learning
Family info Areas/family/ Important dates, notes

What NOT to Capture

  • Casual chat without information value
  • Temporary queries ("what time is it")
  • Information easily searchable online

Note Format

Every note uses minimal frontmatter:

---
created: YYYY-MM-DD
tags: [tag1, tag2]
related: ["[[Other Note]]"]
---

# Title

Content here. Link to [[Related Notes]] freely.

Use templates from assets/templates/ when creating new notes.

Daily Workflow

During Day

  • Dump everything to Inbox/
  • Don't organize — just capture

Evening (5-10 min)

Process Inbox/:

  1. Each item → permanent home or delete
  2. Update Journal/YYYY-MM-DD.md with summary
  3. git commit -am "daily processing"

Weekly Review (Sunday, 15 min)

  1. Review all Projects/ — still active?
  2. Check Areas/ — anything neglected?
  3. Move completed projects to Archive/
  4. Update Tasks/index.md

See references/workflows.md for detailed workflows.

Commands

User says Action
"Set up brainrepo" Run onboarding, create structure
"Save this: [text]" Capture to Inbox/
"New project: [name]" Create Projects/name/ with template
"Add person: [name]" Create People/name.md with template
"What do I know about X?" Search & retrieve
"Daily review" Process Inbox/, update Journal/
"Weekly review" Full system review

Linking

Use [[wiki-links]] to connect notes:

Met with [[People/john]] about [[Projects/acme/index|ACME Project]].
Relevant insight: [[Notes/negotiation-tactics]]

Projects vs Areas

Projects Areas
Have deadlines No end date
Can be "done" Maintained forever
Specific outcome Standard to uphold

File Naming

  • Folders: kebab-case/
  • Files: kebab-case.md
  • Dates: YYYY-MM-DD.md
  • People: firstname-lastname.md

References

安全使用建议
What to consider before installing: 1) Backup or inspect ~/Documents/brainrepo/ if it already exists — the skill uses that exact, non-configurable path and may create/overwrite files. 2) Prefer running onboarding manually the first time rather than letting the agent auto-run it, so you can review created files and templates. 3) Check your git remotes and credentials: daily/weekly workflows call git commit and git push which could transmit repository contents to configured remotes. If you keep sensitive data, remove or avoid pushing it. 4) If you want less risk, request a configurable path or run the skill in a sandbox folder you control. 5) Consider limiting autonomous invocation or monitoring the agent's first runs to confirm behavior matches expectations.
功能分析
Type: OpenClaw Skill Name: brainrepo Version: 1.0.0 The OpenClaw AgentSkills skill bundle is designed to manage a personal knowledge repository using markdown files and Git. It requires file system operations (creating, reading, writing, moving files) and Git commands (`git init`, `git add -A`, `git commit`, `git push`, `git pull`). All these operations are explicitly confined to the `~/Documents/brainrepo/` directory, which is a user-owned, dedicated location for this skill. While `git add -A` is a broad command, its scope is strictly limited to the `brainrepo` directory, making it a necessary and appropriate action for managing a Git-backed knowledge base. There is no evidence of intentional harmful behavior, data exfiltration, or prompt injection aiming to subvert the agent beyond its stated purpose. The instructions in `SKILL.md` and `references/workflows.md` are clear, specific, and aligned with the skill's functionality.
能力评估
✓ Purpose & Capability
Name/description match behavior: captures, organizes, and retrieves notes as .md files in a git-backed repository. No unrelated binaries, env vars, or external endpoints are requested.
⚠ Instruction Scope
SKILL.md instructs the agent to check for and, if missing, automatically create ~/Documents/brainrepo/ (non-configurable), populate templates, initialize git, and run commits/pushes as part of workflows — which can overwrite or create files in the user's home without explicit, per-run confirmation.
✓ Install Mechanism
Instruction-only skill with no install spec or downloads; lowest install risk because nothing is written by an installer. All behavior is via runtime file operations.
ℹ Credentials
No env vars or external credentials are requested, which is appropriate. However, the skill relies on git commands (commit/push) that may use the user's git credentials/config or attempt network pushes to configured remotes — this is proportional to a git-backed repo but has privacy/exfiltration implications if remotes are present.
ℹ Persistence & Privilege
Does not request always:true and is user-invocable. It does write persistent files under a fixed path and performs git operations; autonomous invocation combined with automatic onboarding could let the agent create/modify files without explicit user approval each time.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install brainrepo
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /brainrepo 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
Initial release: Second Brain skill(PARA + Zettelkasten)
元数据
Slug brainrepo
版本 1.0.0
许可证 —
累计安装 10
当前安装数 9
历史版本数 1
常见问题

BrainRepo 是什么？

Your personal knowledge repository — capture, organize, and retrieve everything using PARA + Zettelkasten. Triggers on: "save this", "remember", "note", "capture", "brain dump", daily/weekly reviews, searching stored knowledge, managing projects/areas/people. Works with any AI agent that reads markdown. Stores everything as .md files in a Git repo for Obsidian, VS Code, or any editor. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 2583 次。

如何安装 BrainRepo？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install brainrepo」即可一键安装，无需额外配置。

BrainRepo 是免费的吗？

是的，BrainRepo 完全免费（开源免费），可自由下载、安装和使用。

BrainRepo 支持哪些平台？

BrainRepo 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 BrainRepo？

由 codezz（@codezz）开发并维护，当前版本 v1.0.0。

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 留言讨论