Context Anchor Skill
Helps agents recover context after compaction by scanning memory files and generating a "here's where you are" briefing.
Why This Exists
Context compaction loses memory. Files survive. But after waking up fresh, you need to:
- Know what you were working on
- See decisions that were made
- Find open loops that need closing
- Get oriented fast
This skill automates that recovery.
Quick Start
# Full briefing (default)
./scripts/anchor.sh
# Just show current task
./scripts/anchor.sh --task
# Just show active context files
./scripts/anchor.sh --active
# Just show recent decisions
./scripts/anchor.sh --decisions
# Show open loops / questions
./scripts/anchor.sh --loops
# Scan specific number of days back
./scripts/anchor.sh --days 3
What It Scans
| Source | What It Extracts |
|---|---|
memory/current-task.md | Current task status, blockers, next steps |
memory/YYYY-MM-DD.md | Recent daily logs (last 2 days by default) |
context/active/*.md | In-progress task files |
| Daily logs | Decisions (lines with "Decision:", "Decided:", "✅") |
| Daily logs | Open loops (lines with "?", "TODO:", "Blocker:", "Need to") |
Output Format
The script outputs a structured briefing:
═══════════════════════════════════════════════════════════
CONTEXT ANCHOR
Where You Left Off
═══════════════════════════════════════════════════════════
📋 CURRENT TASK
───────────────────────────────────────────────────────────
[Contents of memory/current-task.md or "No current task set"]
📂 ACTIVE CONTEXT FILES
───────────────────────────────────────────────────────────
• context/active/project-name.md (updated 2h ago)
└─ First line preview...
🎯 RECENT DECISIONS (last 2 days)
───────────────────────────────────────────────────────────
[2026-01-30] Decision: Use Cloudflare Pages for hosting
[2026-01-30] ✅ Completed email capture setup
❓ OPEN LOOPS
───────────────────────────────────────────────────────────
[2026-01-30] Need to enable SFTP on NAS
[2026-01-30] TODO: Create Product Hunt account
═══════════════════════════════════════════════════════════
Integration with AGENTS.md
Add to your "Every Session" routine:
## Every Session
Before doing anything else:
1. Run `./skills/context-anchor/scripts/anchor.sh` for orientation
2. Read `SOUL.md` — this is who you are
3. Read `USER.md` — this is who you're helping
...
Or use it manually when you feel lost about context.
Customization
Change workspace root
WORKSPACE=/path/to/workspace ./scripts/anchor.sh
Change days to scan
./scripts/anchor.sh --days 5 # Scan 5 days back
No Dependencies
Pure bash. Uses only:
find,grep,head,tail,date,stat- Works on macOS and Linux
- No external tools required
When to Use
- Session start: Quick orientation on what's happening
- After compaction: Recover lost context
- Feeling lost: "Wait, what was I doing?"
- Handoff: Show another agent where things stand
- Daily review: See what decisions were made