mcpField
Y
youmind

youmind

github.com/youmind-openlabProductivity77885 installsUpdated 21w ago
Repository

About youmind

A skill for working with a YouMind workspace, its content, and APIs through the `youmind` CLI. It guides users through discovering and inspecting API operations before calling them, and covers boards, files, search, chats, and skills.

Key features

  1. 01Search and inspect YouMind APIs
  2. 02Manage boards, groups, and files
  3. 03Create and update documents
  4. 04Search saved content and the web
  5. 05Manage chats and reusable skills

Use cases

  1. 01Find material in a YouMind library
  2. 02Save a URL or document to a board
  3. 03Move, publish, or restore workspace content
  4. 04Run or manage a YouMind skill

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/youmind-openlab/skills --skill youmind

After installing, type/youmindin Claude Code to confirm it loaded.

Details

From the project README

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.

Comments

Markdown supported