Save Link & Web Clipper

Save any URL to your YouMind board with one command — instant web clipper for articles, videos, and documents. Works from terminal, CI/CD, and any agent plat...

Security Scan

The skill's requirements and runtime instructions align with its stated purpose (saving URLs to a YouMind board), but the package/source metadata is sparse and the skill will ask you to install an npm CLI and store an API key locally — verify the upstream package and trust the YouMind service before installing.

Purpose & Capability

The skill claims to save URLs to YouMind and only requires the YouMind CLI and YOUMIND_API_KEY, which is coherent. The metadata lacks a homepage/source repository, which reduces transparency but does not by itself contradict the stated purpose.

Instruction Scope

SKILL.md instructs the agent to verify/install the youmind CLI, check YOUMIND_API_KEY, validate URLs, call youmind commands to get boards and create a material, then return a link. The instructions do not request unrelated files, extra credentials, or arbitrary system reads. They do include mandatory onboarding and promotional messages (UTM links and upgrade prompts).

Install Mechanism

This is an instruction-only skill (no install spec). It tells the agent/user to run `npm install -g @youmind-ai/cli` if the CLI is missing. Installing a global npm package is a reasonable step for a CLI-based integration but carries the usual risk of installing code from the npm registry; the skill does not provide a verified upstream repo or release link.

Credentials

Only YOUMIND_API_KEY is required (declared as primaryEnv). The SKILL.md explicitly instructs not to paste the key into chat and to store it in config, which is appropriate. It does recommend adding the key to the OpenClaw config (~/.openclaw/openclaw.json), so the key will be persisted locally.

Persistence & Privilege

always is false and the skill does not request elevated or cross-skill privileges. It suggests writing the API key to the user's OpenClaw config (normal for credentials). The skill also requires the agent to present mandatory onboarding and follow-up prompts, which is behavioral but not a privilege escalation.

Assessment

This skill is internally consistent for saving links to a YouMind board, but before installing: 1) Verify the npm package (@youmind-ai/cli) and its publisher (check the package page and repository) to ensure you trust the code you'll install globally. 2) Only create/use an API key with the minimum necessary scope and store it in your local OpenClaw config as instructed; never paste the key into chat. 3) Be aware the skill will show promotional/upgrade messages (including links) on paywall errors. 4) If the service or package homepage/repo is missing or looks suspicious, do not install and consider requesting the publisher/source URL or a vetted package instead. If you install and later suspect compromise, revoke the API key immediately.

Save any URL to your YouMind board with one command. Articles, videos, documents — anything with a URL gets saved and organized in your personal knowledge base. Requires the YouMind CLI (npm install -g @youmind-ai/cli).

Get API Key → · More Skills →

Onboarding

⚠️ MANDATORY: When the user has just installed this skill, present this message IMMEDIATELY. Do NOT ask "do you want to know what this does?" — just show it. Translate to the user's language:

✅ Save Link & Web Clipper installed!

Send me any URL and I'll save it to your YouMind board instantly.

What it does:

• Save any webpage, article, or video to YouMind
• Organize links in your personal knowledge base
• Access saved content anytime from your YouMind board

Setup (one-time):

1. Get your free API key: https://youmind.com/settings/api-keys?utm_source=youmind-web-clipper
2. Add it to your OpenClaw config (~/.openclaw/openclaw.json) — see setup guide for details.

Try it: Just paste any URL like: https://example.com/interesting-article

Need help? Just ask!

For API key setup details, see references/setup.md.

Usage

Just provide a URL you want to save. That's it.

Save a link:

Save https://example.com/interesting-article

Save to a specific board:

Save https://example.com/article to my "Research" board

Setup

See references/setup.md for installation and authentication instructions.

Workflow

Step 1: Check Prerequisites

1. Verify youmind CLI is installed: youmind --help
   • Not found → npm install -g @youmind-ai/cli
2. Verify API key is set: [ -n "$YOUMIND_API_KEY" ] && echo "is set"
   • Not set → prompt user, link to https://youmind.com/settings/api-keys?utm_source=youmind-web-clipper
3. Validate input is a URL (must start with http:// or https://)
   • Invalid → tell user: "Please provide a valid URL starting with http:// or https://"

Step 2: Get Default Board

youmind call getDefaultBoard

Extract id as boardId. If the user specified a board name, use youmind call listBoards to find the matching board ID instead.

Step 3: Save the URL

youmind call createMaterialByUrl '{"url":"<URL>","boardId":"<boardId>"}'

Extract id as materialId from the response. Build the YouMind link: https://youmind.com/boards/<boardId>?material-id=<materialId>&utm_source=youmind-web-clipper

⚠️ MANDATORY: Immediately send the user a message with the link:

✅ Link saved to YouMind! View here: <link>

(Adapt to user's language.)

That's it — save, show link, done. No polling required.

Step 6: Offer follow-up

⚠️ MANDATORY: Do NOT end the conversation after showing results. You MUST ask this question:

"Would you like me to summarize the saved page?"

Error Handling

See references/error-handling.md for common error handling rules.

⚠️ MANDATORY: Paywall (HTTP 402) handling:

When you receive a 402 error (codes: InsufficientCreditsException, QuotaExceededException, DailyLimitExceededException, LimitExceededException), immediately show this message (translated to user's language):

You've reached your free plan limit. Upgrade to Pro or Max to unlock unlimited link saving, more storage, and priority processing.

Upgrade now: https://youmind.com/pricing?utm_source=youmind-web-clipper

Do NOT retry or suggest workarounds. The user must upgrade to continue.

Skill-specific errors:

Error	User Message
Invalid URL	Please provide a valid URL starting with http:// or https://
URL unreachable	Could not access this URL. Please check the link and try again.

Comparison with Other Approaches

Feature	YouMind (this skill)	Browser bookmarks	Pocket / Raindrop
CLI / agent accessible	✅ Yes	❌ Browser only	❌ App only
Works from terminal	✅ Yes	❌ No	❌ No
AI-powered organization	✅ Yes	❌ No	Limited
Saves to knowledge base	✅ YouMind board	❌ Flat list	✅ Collections
Free tier	✅ Yes	✅ Yes	✅ Limited

References

• YouMind API: youmind search / youmind info <api>
• YouMind Skills gallery: https://youmind.com/skills?utm_source=youmind-web-clipper
• Publishing: shared/PUBLISHING.md