my-brain-is-full-crew

aradotso/trending-skills · updated Apr 8, 2026

MDX-style export adds YAML metadata + attribution linking explainx.ai and this canonical listing URL.

$npx skills add https://github.com/aradotso/trending-skills --skill my-brain-is-full-crew
0 commentsdiscussion
summary

Skill by ara.so — Daily 2026 Skills collection

skill.md

My Brain Is Full — Crew

Skill by ara.so — Daily 2026 Skills collection

A crew of 10 AI agents embedded in your Obsidian vault that manage knowledge, nutrition, and mental wellness through natural conversation with Claude Code. Built by a PhD researcher for people who are drowning — not just optimizing.


What It Does

The Crew installs 10 specialized agents into your vault's .claude/ directory. Each agent has its own system prompt, tool restrictions, and model assignment. You talk to Claude Code naturally; it activates the right agent automatically.

Agent Role
Architect Vault setup, onboarding, folder structure
Scribe Captures messy text into clean structured notes
Sorter Nightly inbox triage — routes notes to correct folders
Seeker Search and synthesis across your entire vault
Connector Discovers hidden links between notes
Librarian Weekly health checks, dedup, broken link repair
Transcriber Turns recordings/transcripts into structured meeting notes
Postman Bridges Gmail + Google Calendar with your vault
Food Coach Meal ideas, grocery lists, wellness motivation (opt-in)
Wellness Guide Active listening, grounding techniques, stress support (opt-in)

Agents communicate via a shared Meta/agent-messages.md message board inside your vault.


Prerequisites

  • Claude Code with Pro, Max, or Team subscription
  • Obsidian (free)
  • git and bash available in your terminal

Installation

1. Create or open your Obsidian vault

# Create a new vault directory (or use an existing one)
mkdir ~/my-vault

Open Obsidian → Create New Vault → point it at ~/my-vault.

2. Clone the repo inside your vault

cd ~/my-vault
git clone https://github.com/gnekt/My-Brain-Is-Full-Crew.git

3. Run the installer

cd My-Brain-Is-Full-Crew
bash scripts/launchme.sh

The installer:

  • Asks 2–3 questions (language preference, which agents to enable)
  • Copies agents into ../.claude/agents/ (for Claude Code CLI)
  • Copies skills into ../.claude/skills/ (for Claude Code Desktop / Cowork)
  • Both formats installed automatically — no choice needed

4. Initialize your vault

Open Claude Code inside your vault folder (not inside the repo subfolder):

cd ~/my-vault
claude  # or open Claude Code Desktop pointed at this folder

Then say:

Initialize my vault

The Architect runs a friendly onboarding conversation covering:

  1. Your name, language, role
  2. Which agents to activate
  3. Health agents setup (opt-in)
  4. Gmail / Google Calendar integrations

Vault Structure

The Crew creates a hybrid PARA + Zettelkasten layout:

your-vault/
├── 00-Inbox/          # Capture zone — everything lands here first
├── 01-Projects/       # Active projects with deadlines
├── 02-Areas/          # Ongoing responsibilities (including Health/)
├── 03-Resources/      # Reference material, guides
├── 04-Archive/        # Completed or historical content
├── 05-People/         # Personal CRM
├── 06-Meetings/       # Timestamped meeting notes
├── 07-Daily/          # Daily notes and journals
├── MOC/               # Maps of Content — thematic indexes
├── Templates/         # Obsidian note templates
├── Meta/
│   ├── agent-messages.md   # Shared agent message board
│   ├── user-profile.md     # Your onboarding profile
│   └── vault-health/       # Librarian reports
└── .claude/
    ├── agents/        # Claude Code CLI subagents
    └── skills/        # Claude Code Desktop skills

Daily Usage — Natural Language Commands

The interface is conversation. No GUI, no drag-and-drop.

Knowledge Management

# Capture a note
"Save this: meeting with Marco about Q3 budget, he wants the report by Friday"

# Triage inbox
"Triage my inbox"
"Empty my inbox"

# Search
"Find everything I wrote about transformer architectures"
"What do my notes say about the Pomodoro technique?"

# Connect ideas
"Find connections between my notes on sleep and cognitive performance"
"What links to my note on [[Deep Work]]?"

# Vault health
"Run a vault health check"
"Find duplicate notes"
"Fix broken links"

Meetings & Transcription

# Process a recording
"Process my meeting recording from this morning"
"Transcribe this: [paste transcript text]"

# Meeting prep
"Prepare me for my 3pm meeting with the research team"

Email & Calendar (Postman)

"Check my emails for deadlines this week"
"What meetings do I have tomorrow?"
"Summarize unread emails related to Project Phoenix"

Food Coach (opt-in)

"Suggest a high-protein meal I can make in 20 minutes"
"Generate a grocery list for the week"
"I haven't been eating well — give me something easy and nutritious"

Wellness Guide (opt-in)

"I'm feeling overwhelmed right now"
"Walk me through a grounding exercise"
"I need to talk through something stressful"

Agent Communication Pattern

Agents leave messages for each other on the shared board at Meta/agent-messages.md:

<!-- Example entries in Meta/agent-messages.md -->

## Pending Messages

### FROM: Transcriber → TO: Sorter
**Date**: 2026-03-21
**Subject**: New meeting note needs filing
**File**: 06-Meetings/2026-03-21-research-sync.md
**Action**: Route to 01-Projects/Thesis/ and extract tasks to inbox

---

### FROM: Food Coach → TO: Wellness Guide
**Date**: 2026-03-21
**Subject**: Stress-eating pattern detected
**Context**: User mentioned eating poorly due to deadline stress 3x this week
**Action**: Check in on stress levels next session

When an agent runs, it checks this board and acts on messages addressed to it.


Configuration Files

User Profile (generated by Architect during onboarding)

<!-- Meta/user-profile.md -->
# User Profile

## Identity
- Name: Alex
- Language: English
- Role: PhD Researcher — Cognitive Science
- Timezone: Europe/Rome

## Active Agents
- [x] Architect
- [x] Scribe
- [x] Sorter
- [x] Seeker
- [x] Connector
- [x] Librarian
- [x] Transcriber
- [x] Postman
- [x] Food Coach (opt-in)
- [ ] Wellness Guide (opt-in — not activated)

## Food Coach Settings
- Dietary restrictions: vegetarian, lactose intolerant
- Health goals: increase protein, reduce processed food
- Cooking time preference: max 30 minutes

## Integrations
- Gmail: connected
- Google Calendar: connected

Agent Directory Structure

.claude/
├── agents/
│   ├── architect.md
│   ├── scribe.md
│   ├── sorter.md
│   ├── seeker.md
│   ├── connector.md
│   ├── librarian.md
│   ├── transcriber.md
│   ├── postman.md
│   ├── food-coach.md
│   └── wellness-guide.md
└── skills/
    ├── architect.md
    ├── scribe.md
    └── ...

Reinstalling or Updating

cd ~/my-vault/My-Brain-Is-Full-Crew

# Pull latest changes
git pull origin main

# Re-run installer (safe to run multiple times)
bash scripts/launchme.sh

The installer is idempotent — re-running updates agent files without wiping your vault content.


Enabling / Disabling Opt-In Agents

To enable the Food Coach or Wellness Guide after onboarding:

"Enable the Food Coach agent"
"Activate the Wellness Guide"
"Disable the Food Coach"

The Architect will update Meta/user-profile.md and confirm.

To manually edit, open Meta/user-profile.md and change the checkbox:

- [x] Food Coach (opt-in)    ← enabled
- [ ] Wellness Guide (opt-in) ← disabled

Multilingual Support

The Crew responds in whatever language you use. Switch mid-conversation:

"Salva questo: riunione con Marco sul budget Q3"
"Cherche tout ce que j'ai écrit sur la mémoire de travail"
"作業記憶に関するメモを全部見せて"

Agents match your language automatically. No configuration needed.


Troubleshooting

Agents not activating

# Confirm you're running Claude Code from inside your vault (not the repo subfolder)
cd ~/my-vault
claude

# Confirm agents are installed
ls .claude/agents/
ls .claude/skills/

Re-run onboarding

"Re-run vault initialization"
"Reset my user profile"

Vault structure missing

"Rebuild vault folder structure"
"Create missing vault folders"

Agent messages not being processed

Check Meta/agent-messages.md exists. If missing:

"Initialize the agent message board"

Gmail / Calendar integration issues

The Postman agent uses Claude Code's built-in tool access. Ensure Claude Code has browser/OAuth permissions granted for your Google account during onboarding. Re-trigger with:

"Reconnect Gmail integration"
"Re-authenticate Google Calendar"

Important Disclaimers

  • Health agents are not medical professionals. Food Coach and Wellness Guide produce AI-generated output — not medical advice, not therapy. Always consult real professionals. Both are opt-in.
  • No warranty. Back up your vault before use. Provided "as is."
  • Personal use only. You are responsible for GDPR/CCPA compliance if processing third-party data (e.g., emails containing others' personal information).
  • By using the software you agree to the Terms of Use. The Architect will ask you to accept during onboarding.

Key Files Reference

File Purpose
scripts/launchme.sh Main installer — run this
Meta/user-profile.md Your preferences and active agents
Meta/agent-messages.md Inter-agent communication board
Meta/vault-health/ Librarian weekly reports
.claude/agents/ Subagent definitions (CLI)
.claude/skills/ Skill definitions (Desktop)
docs/getting-started.md Beginner step-by-step guide
docs/DISCLAIMERS.md Full disclaimer text
how to use my-brain-is-full-crew

How to use my-brain-is-full-crew on Cursor

AI-first code editor with Composer

1

Prerequisites

Before installing skills in Cursor, ensure your development environment meets these requirements:

  • Cursor installed and configured on your development machine
  • Node.js version 16.0+ with npm package manager (verify with node --version)
  • Active project directory or workspace where you want to add my-brain-is-full-crew
2

Execute installation command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/aradotso/trending-skills --skill my-brain-is-full-crew

The skills CLI fetches my-brain-is-full-crew from GitHub repository aradotso/trending-skills and configures it for Cursor.

3

Select Cursor when prompted

The CLI will show a list of available agents. Use arrow keys to navigate and space to select Cursor:

◆ Which agents do you want to install to?
│ ── Universal (.agents/skills) ── always included ────
│ • Amp
│ • Antigravity
│ • Cline
│ • Codex
│ ●Cursor(selected)
│ • Cursor
│ • Windsurf
4

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/my-brain-is-full-crew

Reload or restart Cursor to activate my-brain-is-full-crew. Access the skill through slash commands (e.g., /my-brain-is-full-crew) or your agent's skill management interface.

Security & Verification Notice

We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.

Skills execute code in your development environment. Always verify the publisher's identity, review recent commits, and test in isolated environments before production deployment.

List & Monetize Your Skill

Submit your Claude Code skill and start earning

GET_STARTED →

Use Cases

Task Automation & Efficiency

Automate repetitive workflows and reduce manual effort

Example

Generate reports, summarize documents, draft communications

Save 3-5 hours per week on routine tasks

Knowledge Enhancement

Learn new skills, understand complex topics, get expert guidance

Example

Explain concepts, provide examples, suggest learning resources

Accelerate learning and skill development by 2x

Quality Improvement

Enhance output quality through reviews, suggestions, and refinements

Example

Review drafts, suggest improvements, catch errors

Improve work quality by 30-40% with less effort

Implementation Guide

Prerequisites

  • Claude Desktop or compatible AI client with skill support
  • Clear understanding of task or problem to solve
  • Willingness to iterate and refine outputs

Time Estimate

15-45 minutes depending on use case complexity

Installation Steps

  1. 1.Install skill using provided installation command
  2. 2.Test with simple use case relevant to your work
  3. 3.Evaluate output quality and relevance
  4. 4.Iterate on prompts to improve results
  5. 5.Integrate into regular workflow if valuable

Common Pitfalls

  • Expecting perfect results without iteration
  • Not providing enough context in prompts
  • Using skill for tasks outside its intended scope
  • Accepting outputs without review and validation

Best Practices

✓ Do

  • +Start with clear, specific prompts
  • +Provide relevant context and constraints
  • +Review and refine all outputs before using
  • +Iterate to improve output quality
  • +Document successful prompt patterns

✗ Don't

  • Don't use without understanding skill limitations
  • Don't skip validation of outputs
  • Don't share sensitive information in prompts
  • Don't expect skill to replace human judgment

💡 Pro Tips

  • Be specific about desired format and style
  • Ask for multiple options to choose from
  • Request explanations to understand reasoning
  • Combine AI efficiency with human expertise

When to Use This

✓ Use When

Use when skill capabilities match your task, clear ROI on time saved, and you can validate outputs. Best for repetitive tasks, learning, and quality improvement.

✗ Avoid When

Avoid when task requires deep expertise you can't validate, involves sensitive decisions, or when learning process is more valuable than speed of completion.

Learning Path

  1. 1Familiarize yourself with skill capabilities and limitations
  2. 2Start with low-risk, non-critical tasks
  3. 3Progress to more complex and valuable use cases
  4. 4Build expertise through regular use and experimentation

Discussion

Product Hunt–style comments (not star reviews)
  • No comments yet — start the thread.
general reviews

Ratings

4.768 reviews
  • Amelia Li· Dec 16, 2024

    Solid pick for teams standardizing on skills: my-brain-is-full-crew is focused, and the summary matches what you get after install.

  • Anaya Kapoor· Dec 8, 2024

    Keeps context tight: my-brain-is-full-crew is the kind of skill you can hand to a new teammate without a long onboarding doc.

  • Anika Abbas· Dec 4, 2024

    We added my-brain-is-full-crew from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront.

  • Nia Verma· Dec 4, 2024

    I recommend my-brain-is-full-crew for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

  • Anika Huang· Dec 4, 2024

    Useful defaults in my-brain-is-full-crew — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows.

  • Harper Tandon· Nov 27, 2024

    my-brain-is-full-crew is among the better-maintained entries we tried; worth keeping pinned for repeat workflows.

  • Anika Li· Nov 23, 2024

    my-brain-is-full-crew fits our agent workflows well — practical, well scoped, and easy to wire into existing repos.

  • Carlos Tandon· Nov 23, 2024

    Registry listing for my-brain-is-full-crew matched our evaluation — installs cleanly and behaves as described in the markdown.

  • Anika Rao· Nov 23, 2024

    Solid pick for teams standardizing on skills: my-brain-is-full-crew is focused, and the summary matches what you get after install.

  • Anaya Flores· Nov 7, 2024

    I recommend my-brain-is-full-crew for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area.

showing 1-10 of 68

1 / 7