CommunityWriting & Editinggithub.com

Bookmark Manager Skill

🎯 Bookmark Manager Skill - Action-Oriented Version: First assess if a link is actionable, then bookmark it to an Obsidian Vault.

What is Bookmark Manager Skill?

This AI agent skill transforms passive bookmarking into an active, execution-driven workflow. When a user shares a link, the agent first uses web browsing to parse the content and determine if it contains actionable items—such as installing a tool (e.g., Obsidian plugin), running a script, cloning a repo, or configuring a service. If actionable, the agent executes the task using system tools like `runCommand` or `writeFile` before bookmarking; if not actionable (e.g., pure knowledge, opinion articles), it extracts key information (title, source, summary, tags) and bookmarks it. Supported platforms include Obsidian Vaults (via iCloud), with optional temporary storage in the agent's Knowledge Base. The skill enforces structured Markdown notes with metadata like execution status, tags, and action items, making it ideal for developers using Claude Code, Cursor, or similar AI coding assistants who want to automate link processing and task execution.

Works with~Claude Code~Codex CLI~Cursor
npx skills add zhilinYu/bookmark-manager-skill

Installed? Explore more Writing & Editing skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

What does Bookmark Manager Skill do?

Core Philosophy

Don't just read, do! — First assess whether it can be executed, then decide whether to bookmark

The Bookmark Manager Skill is unique because it does not passively bookmark; instead, it actively determines whether the content contains operations that can be directly executed on the user's computer. If so, it executes them first, then bookmarks!


Core Principle: Assess Actionability First, Then Decide to Bookmark

Whenever a bookmark link is received, the Agent's decision tree is as follows:

Step 1 → Visit the link → Parse the content Step 2 → Assess: Is it actionable?

✅ Actionable Scenarios (Execute First, Bookmark Later)

TypeExampleHow to Do It
Tool Install/ConfigObsidian plugin/theme, Clypra install, Docker deploymentrunCommand / writeFile directly
Environment Setuppip install, npm install, git clone + deployrunCommand to execute
Code/ScriptsClone open source project, run script, modify configrunCommand / writeFile
File OperationsCreate Vault directory, write Markdown, organize fileswriteFile / moveFiles
API/Service CallsCall API, register serviceWeb Browsing or system tools

❌ Non-Actionable Scenarios (Bookmark Only)

ScenarioReason
Pure Knowledge/OpinionTechnical analysis, industry trends → requires human judgment
Investment DecisionsInvolves real money, must be judged by user
Requires External Account/PaidAgent has no permission to register or pay
Reference OnlyNews, science, methodology

Dual Flow Design

Flow 1: Actionable → Execute + Bookmark

Receive link → Web Browsing to fetch → Assess as actionable ↓ YES Mark as "Processing" → Execute (install/config/deploy) ↓ Record notes using Agent Documents ↓ {Device connected?} → YES → Write to Obsidian Vault → NO → Temporarily store in Knowledge Base ↓ Reply to user: Execution completed + Bookmarked

Flow 2: Non-Actionable → Bookmark Only

Receive link → Web Browsing to fetch → Assess as non-actionable ↓ Extract core info (title/summary/key points/tags) ↓ Create notes using Agent Documents ↓ {Device connected?} → YES → Write to Obsidian Vault → NO → Temporarily store in Knowledge Base ↓ Reply to user: Bookmarked


Content Extraction Format

FieldDescription
TitleOriginal article/video title
Source PlatformJinri Toutiao/Xiaohongshu/Bilibili/Zhihu/WeChat Official Account/X/Douyin
Original LinkURL
Author/PublisherIf known
Publication DateOriginal publication date
Core Summary2-3 sentence summary
Key Points3-5 key points
TagsIntelligently recommended 2-5 tags
Action ItemsItems to follow up on

Obsidian Configuration

Vault Path

/Users/apple/Library/Mobile Documents/iCloudmdobsidian/Documents/Bookmarks/

Subdirectory Structure

Bookmarks/ ├── Jinri Toutiao/ ├── Xiaohongshu/ ├── Bilibili/ ├── Zhihu/ ├── WeChat Official Account/ └── Other/

File Naming

YYYY-MM-DD-Title.md

Markdown Template

---
title: "{Title}"
source: "{Platform}"
url: "{Original Link}"
tags: [tag1, tag2]
collected: {YYYY-MM-DD}
executed: true/false
executed_summary: "{If executed, describe what was done}"
rating: ⭐
---

# {Title}

> {Platform} · [tag1 / tag2]

## Core Summary
{2-3 sentences}

## Key Points
- Point 1
- Point 2
- Point 3

## Execution Details
{If executed, record operations and results}

## Action Items
- [ ] Action item

📎 Original Link: {Original Link}
---

Version History

  • v2.0.0 (2026-06-19) — Major upgrade: Introduced "assess actionability before bookmarking" core concept, dual flow design, Obsidian Vault write specification
  • v1.1.0 (2026-06-18) — Added support for Douyin, Kuaishou, YouTube, X
  • v1.0.0 — Initial version

License

MIT

Related Skills