| name | youmind |
| version | 3.1.0 |
| description | Use this skill when the task is clearly connected to the user's YouMind workspace, YouMind APIs, or the youmind CLI. It helps agents search, inspect, and call YouMind OpenAPI endpoints to work with boards, groups, YouMind files, picks, chats, and YouMind skills. |
| allowed-tools | ["Bash(command -v youmind)","Bash(test -n \"$YOUMIND_API_KEY\")","Bash(youmind *)","Bash(npm install -g @youmind-ai/cli)"] |
YouMind
YouMind is an AI creative workspace. People save webpages, PDFs, videos, podcasts, notes, and generated assets into boards, then use AI to search, organize, write, and publish from that workspace.
Use this skill when the task is clearly connected to the user's YouMind workspace, YouMind APIs, or the youmind CLI.
Use When
Use this skill when the user wants to:
- work with a YouMind board, group, file, pick, chat, or skill
- search or use their YouMind library as context
- save a URL, document, generated asset, or result into YouMind
- create, update, move, publish, restore, or trash content in YouMind
- run or manage a YouMind skill
- call YouMind OpenAPI through the
youmind CLI
Vocabulary
- YouMind board: a workspace container.
- YouMind group: a folder inside a board.
- YouMind file: a content item inside a board, such as a document, webpage, PDF, image, audio, video, or generated artifact.
- Pick: a saved excerpt or highlight.
- Chat: an AI task or conversation in YouMind.
- Skill: a reusable YouMind capability that can be run through chat.
Setup
Check whether the CLI is installed:
command -v youmind
If missing, install it:
npm install -g @youmind-ai/cli
Check whether authentication is configured:
test -n "$YOUMIND_API_KEY"
If missing, ask the human to create an API key at:
https://youmind.com/settings/api-keys
Then ask them to set it as an environment variable:
export YOUMIND_API_KEY=sk-ym-...
Do not ask the human to paste the API key into a youmind command. The CLI should read it from YOUMIND_API_KEY.
Workflow
Use discover -> inspect -> call:
youmind search <keyword>
youmind info <apiName>
youmind call <apiName> '<json>'
Rules:
- Use
youmind search before guessing API names.
- Use
youmind info before calling an API you have not recently inspected.
- Pass JSON for non-trivial arguments.
- Use returned ids for follow-up calls.
- Share internal ids only when they are useful for the user's next step.
Common Operations
Useful API names include:
- Boards:
listBoards, getDefaultBoard, getBoard, createBoard, updateBoard, trashBoard
- YouMind files:
listFiles, getFile, createFileByUrl, createDocument, updateDocument, moveFiles, trashFile, restoreFromTrash, publishFile
- Groups:
createGroup, updateGroup, ungroupGroup
- Picks:
createPick, updatePick, trashPick
- Search:
search, webSearch
- Chats and skills:
createChat, listMessages, createSkill, installSkill
Side Effects
For actions that change the workspace or publish externally, make sure the user's intent is clear before calling the API.
This includes trashing, moving, publishing, restoring, installing skills, or any paid action.
Only say something was saved, published, installed, moved, or deleted after the CLI call succeeds. If a call fails, report the error clearly.
