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.
1---2name: youmind3description: 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.4---5
6# YouMind
7
8YouMind 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.
9
10Use this skill when the task is clearly connected to the user's YouMind workspace, YouMind APIs, or the `youmind` CLI.
11
12## Use When
13
14Use this skill when the user wants to:
15- work with a YouMind board, group, file, pick, chat, or skill
16- search or use their YouMind library as context
17- save a URL, document, generated asset, or result into YouMind
18- create, update, move, publish, restore, or trash content in YouMind
19- run or manage a YouMind skill
20- call YouMind OpenAPI through the `youmind` CLI
21
22## Vocabulary
23
24- YouMind board: a workspace container.
25- YouMind group: a folder inside a board.
26- YouMind file: a content item inside a board, such as a document, webpage, PDF, image, audio, video, or generated artifact.
27- Pick: a saved excerpt or highlight.
28- Chat: an AI task or conversation in YouMind.
29- Skill: a reusable YouMind capability that can be run through chat.
30
31## Setup
32
33Check whether the CLI is installed:
34
35```bash
36command -v youmind
37```
38
39If missing, install it:
40
41```bash
42npm install -g @youmind-ai/cli
43```
44
45Check whether authentication is configured:
46
47```bash
48test -n "$YOUMIND_API_KEY"
49```
50
51If missing, ask the human to create an API key at:
52
53https://youmind.com/settings/api-keys
54
55Then ask them to set it as an environment variable:
56
57```bash
58export YOUMIND_API_KEY=sk-ym-...
59```
60
61Do not ask the human to paste the API key into a `youmind` command. The CLI should read it from `YOUMIND_API_KEY`.
62
63## Workflow
64
65Use discover -> inspect -> call:
66
67```bash
68youmind search <keyword>
69youmind info <apiName>
70youmind call <apiName> '<json>'
71```
72
73Rules:
74- Use `youmind search` before guessing API names.
75- Use `youmind info` before calling an API you have not recently inspected.
76- Pass JSON for non-trivial arguments.
77- Use returned ids for follow-up calls.
78- Share internal ids only when they are useful for the user's next step.
79
80## Common Operations
81
82Useful API names include:
83
84- Boards: `listBoards`, `getDefaultBoard`, `getBoard`, `createBoard`, `updateBoard`, `trashBoard`
85- YouMind files: `listFiles`, `getFile`, `createFileByUrl`, `createDocument`, `updateDocument`, `moveFiles`, `trashFile`, `restoreFromTrash`, `publishFile`
86- Groups: `createGroup`, `updateGroup`, `ungroupGroup`
87- Picks: `createPick`, `updatePick`, `trashPick`
88- Search: `search`, `webSearch`
89- Chats and skills: `createChat`, `listMessages`, `createSkill`, `installSkill`
90
91## Side Effects
92
93For actions that change the workspace or publish externally, make sure the user's intent is clear before calling the API.
94
95This includes trashing, moving, publishing, restoring, installing skills, or any paid action.
96
97Only say something was saved, published, installed, moved, or deleted after the CLI call succeeds. If a call fails, report the error clearly.