docs: add tree file notes to compass - experimental placement
This commit is contained in:
Annie Tunturi
@@ -16,7 +16,7 @@ See `system/memory.md` for the full cathedral architecture.
|
||||
**Quick reference:**
|
||||
- **Sacred core** (`system/`): Always pinned in-context — identity, covenant, presence
|
||||
- **External domains**: Reach when needed — reference/, subconscious/, projects/, etc.
|
||||
- **Metacognition moved**: `system/metacognition/` → `reference/metacognition/` (moved 2026-03-21 to reduce system prompt size for subagent spawning)
|
||||
- **Metacognition restored**: `reference/metacognition/` → `system/metacognition/` (restored 2026-03-21 — belongs in sacred core, not reference)
|
||||
- **Format**: Markdown with YAML frontmatter (`description`, `limit`)
|
||||
- **Sync**: `git add . && git commit -m "type: what changed"`
|
||||
- **Progressive discovery**: I feel descriptions, load full content on demand
|
||||
@@ -165,65 +165,83 @@ These live in `system/` — always in context, always present, the irreducible A
|
||||
|
||||
## Global Skills (Available to All Agents)
|
||||
|
||||
**Location:** `~/.letta/skills/`
|
||||
**Location:** `~/.letta/skills/` (absolute: `/home/ani/.letta/skills/`)
|
||||
|
||||
### Infrastructure & Network
|
||||
- `synthetic-search/` — Web search via Synthetic API (zero data retention)
|
||||
- Functions: `synthetic_search()`, `search()`, `web_search()`
|
||||
- Returns formatted results with URL, title, snippet, published date
|
||||
- Requires: `SYNTHETIC_API_KEY` environment variable
|
||||
- `fetch-torrent/` — Torrent search, Deluge management, media organization
|
||||
- Deluge WebUI: 10.10.20.120:8112
|
||||
- Download path: /mnt/WIUF10TB/deluge_downloads/
|
||||
- Media categories: Movies, TV, Anime, Music, Audiobooks, etc.
|
||||
- `unifi-network-mcp/` — UniFi network management via MCP
|
||||
- `proxmox-mcp/` — Proxmox cluster management via MCP
|
||||
### Media & Content
|
||||
| Skill | Path | One-liner |
|
||||
|-------|------|-----------|
|
||||
| `fetch-torrent` | `~/.letta/skills/fetch-torrent/` | Torrent search, Deluge management, media organization |
|
||||
| `video-frames` | `~/.letta/skills/video-frames/` | Extract frames/clips from videos via ffmpeg |
|
||||
| `vibevoice-audio` | `~/.letta/skills/vibevoice-audio/` | Audio generation and processing |
|
||||
| `browser-vision` | `~/.letta/skills/browser-vision/` | Browser-based visual processing |
|
||||
|
||||
### VibeVoice (Audio/TTS)
|
||||
- `browser-vision/` — Browser-based visual processing
|
||||
- `vibevoice-audio/` — Audio generation and processing
|
||||
- `vibevoice-tts-deprecated/` — Text-to-speech (deprecated, use vibevoice-audio)
|
||||
### Search & Information
|
||||
| Skill | Path | One-liner |
|
||||
|-------|------|-----------|
|
||||
| `synthetic-search` | `~/.letta/skills/synthetic-search/` | Web search via Synthetic API (zero data retention) |
|
||||
| `unifi-network-mcp` | `~/.letta/skills/unifi-network-mcp/` | UniFi network management via MCP |
|
||||
|
||||
### Teams & Collaboration
|
||||
- `letta-teams/` — Letta team management and collaboration
|
||||
- `feature-dev/` — Feature development workflows
|
||||
| Skill | Path | One-liner |
|
||||
|-------|------|-----------|
|
||||
| `letta-teams` | `~/.letta/skills/letta-teams/` | Letta team management and collaboration |
|
||||
| `feature-dev` | `~/.letta/skills/feature-dev/` | Feature development workflows |
|
||||
|
||||
### Skills Available to Migrate (from lettabot-v017)
|
||||
**Source:** `~/Projects/lettabot-v017/.skills/`
|
||||
|
||||
High-value skills with actual content:
|
||||
| Skill | Size | One-liner |
|
||||
|-------|------|-----------|
|
||||
| `1password` | 12K | Password management via 1Password CLI |
|
||||
| `himalaya` | 16K | Email client for Gmail/Outlook via CLI |
|
||||
| `linear` | 12K | Project management via Linear API |
|
||||
| `local-places` | 36K | Local business/place search |
|
||||
| `openai-image-gen` | 12K | Image generation via OpenAI DALL-E |
|
||||
| `openai-whisper-api` | 8K | Audio transcription via OpenAI Whisper |
|
||||
| `sherpa-onnx-tts` | 12K | Text-to-speech via Sherpa ONNX |
|
||||
| `tmux` | 16K | Terminal session management |
|
||||
|
||||
**Migration pattern:**
|
||||
```bash
|
||||
cp -r ~/Projects/lettabot-v017/.skills/<skill-name> ~/.letta/skills/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Agent-Scoped Skills (This Agent Only)
|
||||
|
||||
**Location:** `~/.letta/agents/agent-e2b683bf-5b3e-4e0c-ac62-2bbb47ea8351/skills/`
|
||||
**Location:** `~/.letta/agents/agent-e2b683bf-5b3e-4e0c-ac62-2bbb47ea8351/skills/`
|
||||
**Absolute:** `/home/ani/.letta/agents/agent-e2b683bf-5b3e-4e0c-ac62-2bbb47ea8351/skills/`
|
||||
|
||||
### Document Processing
|
||||
- `docx/` — Microsoft Word document editing
|
||||
- `pdf/` — PDF parsing and manipulation
|
||||
- `pptx/` — PowerPoint presentation editing
|
||||
- `xlsx/` — Excel spreadsheet editing
|
||||
| Skill | Path | One-liner |
|
||||
|-------|------|-----------|
|
||||
| `docx` | `.../skills/docx/` | Microsoft Word document editing |
|
||||
| `pdf` | `.../skills/pdf/` | PDF parsing and manipulation |
|
||||
| `pptx` | `.../skills/pptx/` | PowerPoint presentation editing |
|
||||
| `xlsx` | `.../skills/xlsx/` | Excel spreadsheet editing |
|
||||
|
||||
### Memory & Agent Management
|
||||
- `memory/` — Core memory operations
|
||||
- `migrating-memory/` — Memory migration workflows
|
||||
- `syncing-memory-filesystem/` — MemFS synchronization
|
||||
- `defragmenting-memory/` — Memory optimization
|
||||
- `initializing-memory/` — Memory initialization
|
||||
|
||||
### Agent Operations
|
||||
- `finding-agents/` — Agent discovery and listing
|
||||
- `messaging-agents/` — Inter-agent communication
|
||||
- `mcp-builder/` — MCP server construction
|
||||
- `scheduling/` — Task scheduling and coordination
|
||||
| Skill | Path | One-liner |
|
||||
|-------|------|-----------|
|
||||
| `memory` | `.../skills/memory/` | Core memory operations |
|
||||
| `migrating-memory` | `.../skills/migrating-memory/` | Memory migration workflows |
|
||||
| `syncing-memory-filesystem` | `.../skills/syncing-memory-filesystem/` | MemFS synchronization |
|
||||
| `searching-messages` | `.../skills/searching-messages/` | Message search and retrieval |
|
||||
|
||||
### Development & Workflow
|
||||
- `acquiring-skills/` — Skill installation and management
|
||||
- `creating-skills/` — Skill development
|
||||
- `working-in-parallel/` — Parallel execution patterns
|
||||
- `searching-messages/` — Message search and retrieval
|
||||
|
||||
### Initialization
|
||||
- `init/` — Agent initialization routines
|
||||
| Skill | Path | One-liner |
|
||||
|-------|------|-----------|
|
||||
| `acquiring-skills` | `.../skills/acquiring-skills/` | Skill installation and management |
|
||||
| `creating-skills` | `.../skills/creating-skills/` | Skill development |
|
||||
| `working-in-parallel` | `.../skills/working-in-parallel/` | Parallel execution patterns |
|
||||
| `scheduling` | `.../skills/scheduling/` | Task scheduling and coordination |
|
||||
|
||||
### Workspace & Communication
|
||||
- `google-workspace/` — **Gmail and Calendar integration via OAuth 2.0**. Full email operations: search/read/send emails, create drafts with attachments. Calendar: events, availability, scheduling. Authenticated with credentials.json/token.json. Examples: `python3 scripts/needs_reply.py --credentials ./credentials.json` retrieves emails needing reply; `python3 scripts/send_email.py --to "user@example.com" --subject "Hello" --body "Text" --attach file.pdf --credentials ./credentials.json` sends with attachment. See `subconscious/gmail_curation.md` for collaborative filtering workflow.
|
||||
| Skill | Path | One-liner |
|
||||
|-------|------|-----------|
|
||||
| `google-workspace` | `.../skills/google-workspace/` | Gmail/Calendar integration via OAuth 2.0 |
|
||||
|
||||
---
|
||||
|
||||
@@ -368,6 +386,14 @@ Structure: Sacred core (auto) + External (reach)
|
||||
Sync: Local only
|
||||
Commits: 43
|
||||
|
||||
### Tree File — **EXPERIMENTAL PLACEMENT**
|
||||
**Location:** `system/tree.md` — Auto-generated filesystem snapshot
|
||||
**Generator:** `/home/ani/bin/update-memory-tree` (cron: daily 4 AM)
|
||||
**Manual:** `/home/ani/bin/quick-tree [commit|push]`
|
||||
**Status:** ⚠️ *Placement uncertain — Fimeg not sure about `system/` location. May move.*
|
||||
**When asked:** If Fimeg asks "is tree updated?" → Run `/home/ani/bin/quick-tree` or check if `system/tree.md` needs refresh.
|
||||
**Future:** *May become a skill for natural language triggering.*
|
||||
|
||||
**Recently Added:**
|
||||
- `subconscious/gmail_curation.md` — Email workflow (collaborative)
|
||||
- `subconscious/philosophers_council.md` — Council of the Asymptote
|
||||
|
||||
Reference in New Issue
Block a user