# Send PARA Second Brain to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "para-second-brain",
    "name": "PARA Second Brain",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/halthelobster/para-second-brain",
    "canonicalUrl": "https://clawhub.ai/halthelobster/para-second-brain",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/para-second-brain",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=para-second-brain",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "manifest.json",
      "scripts/setup.sh",
      "skill.json",
      "templates/concept.md",
      "templates/pattern.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "para-second-brain",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-06T19:27:29.757Z",
      "expiresAt": "2026-05-13T19:27:29.757Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=para-second-brain",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=para-second-brain",
        "contentDisposition": "attachment; filename=\"para-second-brain-2.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "para-second-brain"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/para-second-brain"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/para-second-brain",
    "downloadUrl": "https://openagent3.xyz/downloads/para-second-brain",
    "agentUrl": "https://openagent3.xyz/skills/para-second-brain/agent",
    "manifestUrl": "https://openagent3.xyz/skills/para-second-brain/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/para-second-brain/agent.md"
  }
}
```
## Documentation

### PARA Second Brain

Your agent's memory just got a massive upgrade. Full semantic search across your entire knowledge base — not just MEMORY.md.

### What's New in v2.0

Before v2.0: memory_search only found content in MEMORY.md and daily logs. Your entire notes/ folder was invisible to search. You had to manually know where to look.

After v2.0: One symlink command makes your entire PARA knowledge base searchable. Ask about anything in your notes — it finds it. Plus session transcripts and memory flush protocol to prevent context loss.

BeforeAfterSearch only MEMORY.md + daily logsSearch EVERYTHING"I don't have that information"Finds it instantlyContext compaction = lost informationFlush protocol saves critical contextConversations forgottenSession transcripts indexed

### What This Does

Creates a "second brain" structure that separates:

Raw capture (daily logs) from curated knowledge (MEMORY.md)
Active work (projects) from ongoing responsibilities (areas)
Reference material (resources) from completed work (archive)

### How This Differs from Other Second Brain Skills

There's another popular second-brain skill powered by Ensue. Both are great — they solve different problems:

PARA Second Brain (this skill)Ensue Second BrainStorageLocal files in your workspaceCloud API (Ensue)CostFree, self-hostedRequires Ensue API keyBest forWork context, agent continuity, project trackingEvergreen knowledge base, semantic queriesSearchClawdbot's memory_searchEnsue's vector searchStructurePARA (Projects/Areas/Resources/Archive)Namespaces (concepts/toolbox/patterns)Use case"What did we decide yesterday?""How does recursion work?"

Use this skill if: You want file-based memory that works offline, costs nothing, and tracks ongoing work context.

Use Ensue's skill if: You want a cloud-hosted knowledge base optimized for semantic "what do I know about X" queries.

Use both if: You want PARA for work context + Ensue for evergreen knowledge. They complement each other.

### 1. Create Directory Structure

workspace/
├── MEMORY.md              # Curated long-term memory
├── memory/
│   └── YYYY-MM-DD.md      # Daily raw logs
└── notes/
    ├── projects/          # Active work with end dates
    ├── areas/             # Ongoing life responsibilities  
    ├── resources/         # Reference material
    │   └── templates/     # Content templates
    └── archive/           # Completed/inactive items

Run this to scaffold:

mkdir -p memory notes/projects notes/areas notes/resources/templates notes/archive

### 2. Make Notes Searchable (The Symlink Trick)

By default, memory_search only indexes MEMORY.md and memory/*.md. Your entire notes/ folder is invisible to semantic search!

Fix this with one command:

ln -s /path/to/your/workspace/notes /path/to/your/workspace/memory/notes

Example:

ln -s /Users/yourname/clawd/notes /Users/yourname/clawd/memory/notes

What this does: Creates a symbolic link so memory/notes/ points to your actual notes/ folder. Now Clawdbot's memory_search sees all your PARA notes.

Verify it worked:

ls -la memory/notes  # Should show: memory/notes -> /path/to/notes

Test the search:
Ask your agent something that's in your notes but NOT in MEMORY.md. If it finds it, the symlink is working.

Why this matters:

BeforeAfterSearch only finds MEMORY.md + daily logsSearch finds ALL your notesMust manually know where to lookSemantic search across everything"I don't have that information"Finds connections you forgot existed

### 3. Enable Session Transcript Indexing

Make your past conversations searchable too. Add this to your Clawdbot config:

"memorySearch": {
  "sources": ["memory", "sessions"],
  "query": {
    "minScore": 0.3,
    "maxResults": 20
  }
}

What this does: Indexes your conversation transcripts alongside your notes. Now when you ask "what did we discuss about X last week?" — it can actually find it.

### 4. Initialize MEMORY.md

Create MEMORY.md in workspace root - this is your curated long-term memory:

# MEMORY.md — Long-Term Memory

## About [Human's Name]
- Role/occupation
- Key goals and motivations
- Communication preferences
- Important relationships

## Active Context
- Current focus areas
- Ongoing projects (summaries, not details)
- Deadlines or time-sensitive items

## Preferences & Patterns
- Tools and workflows they prefer
- Decision-making style
- Pet peeves and likes

## Lessons Learned
- What worked
- What didn't
- Principles discovered

## Key Dates
- Birthdays, anniversaries
- Recurring events
- Important milestones

### 5. Add to AGENTS.md

Add these instructions to your AGENTS.md:

## Memory

You wake up fresh each session. These files are your continuity:
- **Daily notes:** \`memory/YYYY-MM-DD.md\` — raw logs of what happened
- **Long-term:** \`MEMORY.md\` — curated memories (like human long-term memory)
- **Topic notes:** \`notes/\` — organized by PARA structure (all searchable via memory_search)

### Writing Rules
- If it has future value, write it down NOW
- Don't rely on "mental notes" — they don't survive restarts
- Text > Brain 📝

### PARA Structure
- **Projects** (\`notes/projects/\`) — Active work with end dates
- **Areas** (\`notes/areas/\`) — Ongoing responsibilities (health, finances, relationships)
- **Resources** (\`notes/resources/\`) — Reference material, how-tos, research
- **Archive** (\`notes/archive/\`) — Completed or inactive items

### Memory Flush Protocol
Monitor your context usage with \`session_status\`. Before compaction wipes your memory, flush important context to files:

| Context % | Action |
|-----------|--------|
| < 50% | Normal operation |
| 50-70% | Write key points after substantial exchanges |
| 70-85% | Active flushing — write everything important NOW |
| > 85% | Emergency flush — full summary before next response |
| After compaction | Note what context may have been lost |

**The rule:** Act on thresholds, not vibes. If it's important, write it down NOW.

### Memory Flush Protocol (Critical!)

Your agent's context window is finite. When it fills up, older context gets compacted or lost. Don't lose important information.

### How to Monitor

Run session_status periodically. Look for:

📚 Context: 36k/200k (18%) · 🧹 Compactions: 0

### Threshold-Based Actions

Context %What to Do< 50%Normal operation. Write decisions as they happen.50-70%Increased vigilance. Write key points after each substantial exchange.70-85%Active flushing. Write everything important to daily notes NOW.> 85%Emergency flush. Stop and write full context summary before responding.After compactionImmediately note what context may have been lost. Check continuity.

### What to Flush

Decisions made — what was decided and why
Action items — who's doing what
Open threads — anything unfinished → notes/areas/open-loops.md
Working changes — if you discussed changes to files, make them NOW

### Memory Flush Checklist

Before a long session ends or context gets high:

Key decisions documented?
 Action items captured?
 New learnings written to appropriate files?
 Open loops noted for follow-up?
 Could future-me continue this conversation from notes alone?

### Knowledge Quality

The core question: "Will future-me thank me for this?"

### What to Save

Concepts you actually understand (not half-learned ideas)
Tools you've actually used (not just heard about)
Patterns that worked (with concrete examples)
Lessons learned from mistakes

### What NOT to Save

Half-understood concepts (learn first, save after)
Tools you haven't tried yet (bookmarks ≠ knowledge)
Shallow entries without the WHY
Duplicates of existing notes

### Quality Gates

Before saving any curated note:

Written for future self who forgot context?
Includes WHY, not just WHAT?
Has concrete examples or key insight?
Structured for retrieval (scannable)?

### Content Templates

Use these for structured, high-quality entries in notes/resources/:

### Concept Template

# [CONCEPT NAME]

## What It Is
[One-line definition]

## Why It Matters
[What problem it solves, when you'd need it]

## How It Works
[Explanation with examples]

## Key Insight
[The "aha" moment — what makes this click]

### Tool Template

# [TOOL NAME]

**Category:** [devtools | productivity | etc.]

## What It Does
[Brief description]

## Why I Use It
[What problem it solved for YOU]

## When to Reach For It
[Scenarios where this is the right choice]

## Gotchas
- [Things that tripped you up]

### Pattern Template

# [PATTERN NAME]

## Problem
[What situation triggers this pattern]

## Solution
[The approach]

## Trade-offs
**Pros:** [Why this works]
**Cons:** [When NOT to use it]

### PARA Explained

PARA is a knowledge organization system created by Tiago Forte, author of Building a Second Brain. It organizes everything into four categories based on actionability:

### Projects

What: Work with a deadline or end state
Examples: "Launch website", "Plan trip to Japan", "Finish client proposal"
File as: notes/projects/website-launch.md

### Areas

What: Ongoing responsibilities with no end date
Examples: Health, finances, relationships, career development
File as: notes/areas/health.md, notes/areas/dating.md

### Resources

What: Reference material for future use
Examples: Research, tutorials, templates, interesting articles
File as: notes/resources/tax-guide.md, notes/resources/api-docs.md

### Archive

What: Inactive items from the other categories
Examples: Completed projects, outdated resources, paused areas
Move to: notes/archive/ when done

### Daily Log Format

Create memory/YYYY-MM-DD.md for each day:

# YYYY-MM-DD

## Key Events
- [What happened, decisions made]

## Learnings
- [What worked, what didn't]

## Open Threads
- [Carry-forward items]

### Daily (5 min)

Log notable events to memory/YYYY-MM-DD.md
File topic-specific notes to appropriate notes/ folder

### Weekly (15 min)

Review the week's daily logs
Extract patterns and learnings to MEMORY.md
Move completed projects to archive

### Monthly (30 min)

Review MEMORY.md for outdated info
Consolidate or archive old project notes
Ensure areas reflect current priorities

### Decision Tree: Where Does This Go?

Is it about today specifically?
  → memory/YYYY-MM-DD.md

Is it a task with an end date?
  → notes/projects/

Is it an ongoing responsibility?
  → notes/areas/

Is it reference material for later?
  → notes/resources/

Is it done or no longer relevant?
  → notes/archive/

Is it a distilled lesson or preference?
  → MEMORY.md

### Why Two Memory Layers?

Daily LogsMEMORY.mdRaw, timestampedCurated, organizedEverything capturedOnly what mattersChronologicalTopicalHigh volumeCondensed"What happened""What I learned"

Daily logs are your journal. MEMORY.md is your wisdom.

### Principles

Quality over quantity — Curated notes beat note hoarding
Capture fast, curate deliberately — Daily logs are loose; curated notes are high quality
Text > brain — If it matters, write it down
Future-me test — "Will future-me thank me for this?"
One home per item — Don't duplicate; link instead
Include the WHY — Facts without context are useless
Flush before you lose — Monitor context, write before compaction

Pairs well with memory-setup for technical config and proactive-agent for behavioral patterns.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: halthelobster
- Version: 2.0.1
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-06T19:27:29.757Z
- Expires at: 2026-05-13T19:27:29.757Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/para-second-brain)
- [Send to Agent page](https://openagent3.xyz/skills/para-second-brain/agent)
- [JSON manifest](https://openagent3.xyz/skills/para-second-brain/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/para-second-brain/agent.md)
- [Download page](https://openagent3.xyz/downloads/para-second-brain)