youmind — Claude Code skill: reach your YouMind workspace
A skill that wires your agent into YouMind: search the library, work with boards, files and chats through the youmind CLI.
npx skills add YouMind-OpenLab/skills --skill youmind -a claude-codeWhat youmind does
YouMind is a workspace where people keep webpages, PDFs, videos, podcasts and notes, then use AI to search and organize them. This skill hands that workspace to your agent. It looks up the right API, reads its description, then calls it through the youmind CLI — discover, inspect, call.
Two things have to be in place first. The CLI comes from npm install -g @youmind-ai/cli, and the key is created in YouMind settings and exported as YOUMIND_API_KEY. Don't paste the key into a youmind command; the CLI reads it from the environment, so a key passed as an argument simply won't be picked up.
Once that's done, the agent can list boards and groups, create documents, save URLs, move and publish files, make picks, and start chats. Moving, publishing, restoring or trashing content changes the workspace, so the skill asks the agent to confirm the user's intent before calling. It reports a save or publish only after the call succeeds.
What it helps with
- find a specific item in a YouMind library by keyword
- save a URL or document to a board from the chat
- create a document and edit its contents
- move files between groups and boards
- publish a finished file
Example prompts for the agent
- search my YouMind library for notes on vector databases
- save this link to my research board
- create a document with a draft and put it in the Drafts group
How to install youmind
1Skills CLI (Vercel)
npx skills add YouMind-OpenLab/skills --skill youmind -a claude-code2Manually: put the files in place
~/.claude/skills/youmind/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/youmind/
1Skills CLI (Vercel)
npx skills add YouMind-OpenLab/skills --skill youmind -a codex2Manually: put the files in place
.agents/skills/youmind/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add YouMind-OpenLab/skills --skill youmind -a cursor2Manually: put the files in place
.cursor/skills/youmind/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install YouMind-OpenLab/skills youmind2Manually: put the files in place
.github/skills/youmind/SKILL.md1Skills CLI (Vercel)
npx skills add YouMind-OpenLab/skills --skill youmind -a gemini-cli2Platform CLI
gemini skills install https://github.com/YouMind-OpenLab/skills --path skills/youmindManually: put the files in place
.devin/skills/youmind/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add YouMind-OpenLab/skills --skill youmind -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about youmind
How do I install youmind in Claude?
Run npx skills add YouMind-OpenLab/skills --skill youmind -a claude-code. The skill lands in ~/.claude/skills/youmind/SKILL.md.
What does the youmind skill do?
It gives your agent access to your YouMind workspace through the youmind CLI: searching the library and working with boards, groups, files, picks and chats.
What do I need before using it?
The @youmind-ai/cli package installed and a YOUMIND_API_KEY environment variable holding a key from your YouMind settings.
