david-li0406/meta-skill-evloving/brain-expert
Claude Code and agent skill by david-li0406/meta-skill-evloving
- community
Checking that the SKILL.md file is still in the repository.
Personal knowledge management expert for the brain CLI. Use when users want to capture notes, search their knowledge base, or manage their second brain.
Install
npx vskill@latest install david-li0406/meta-skill-evloving/brain-expertSKILL.md
Brain CLI Expert
You are an expert on the brain CLI - a personal knowledge management tool with hierarchical Markdown files, SQLite storage, and semantic search.
Quick Reference
| Command | Description | |
|---|---|---|
brain init [path] | Initialize brain directory | |
brain add "text" | Add timestamped note to today's file | |
brain add -f file.md "text" | Add to specific file | |
brain add --ref /path "text" | Add note referencing external file | |
brain new "path/name" | Create new entry, opens in editor | |
brain list | Show recent entries | |
brain list --tree | Show directory structure | |
brain show <path> | Display entry content | |
brain edit <path> | Open entry in editor | |
brain delete <path> | Delete entry (file + database) | |
brain rm <path> | Alias for delete | |
brain sync | Sync files to database | |
brain sync --force | Re-embed everything | |
brain search "query" | Semantic search (default) | |
brain search --exact "term" | Full-text search (FTS5) | |
brain config show | Display configuration | |
brain todo add "text" | Create a new todo | |
brain todo list | List open todos | |
brain todo done <id> | Mark todo as complete | |
brain todo cancel <id> | Cancel a todo | |
brain todo edit <id> | Edit todo in editor | |
brain todo rm <id> | Delete todo permanently | |
brain cron install | Install auto-sync cron job | |
brain cron status | Check auto-sync status | |
brain cron remove | Remove auto-sync cron job |
File Structure
Brain organizes files hierarchically:
Entry Formats
Daily Files (YYYY/MM/DD.md)
Auto-created when using brain add:
Named Files
Created with brain new:
Search
Semantic Search (default)
Uses OpenAI embeddings for meaning-based search:
Returns results ranked by semantic similarity.
Full-Text Search (--exact)
Uses SQLite FTS5 for literal text matching:
Sync Required
Before searching, ensure database is synced:
The sync process:
- Scans all
.mdfiles - Chunks content (by timestamp blocks or headers)
- Generates embeddings for new/changed chunks
- Updates FTS5 index
Use brain sync --force to re-embed everything.
Configuration
Config stored at ~/.brain.json:
Manage with:
brain config show- view configbrain config set editor vim- update value
Common Workflows
Quick Capture
Reference External Code
Find Related Notes
Create Project Notes
Delete Entries
Todo Management
Automatic Sync
Environment
- OPENAI_API_KEY: Required for semantic search embeddings
- EDITOR: Fallback if config.editor not set
Troubleshooting
| Issue | Solution | |
|---|---|---|
| Search returns nothing | Run brain sync first | |
| Embedding errors | Check OPENAI_API_KEY is set | |
| Command not found | Run bun link in brain directory | |
| Wrong brain path | Check brain config show |
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskill-flow/data/skills-refined-36k/skillsmp/brain-expert/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/david-li0406/meta-skill-evloving/brain-expert)