Article Bookmarker Skill

---

name: article-bookmarker

description: Save and organize web articles as bookmarks with AI summaries and auto-tagging. Use when the user wants to bookmark or collect articles.

homepage: https://github.com/chliny/article-bookmarker-skill

metadata: {"openclaw": {"emoji":"🔖","requires":{"env":["ARTICLE_BOOKMARK_DIR", "ARTICLE_BOOKMARK_GITHUB"], "bins":["gh", "git"]}}}

---

# Article Bookmarker Skill

> **IMPORTANT**: Before any operation, read the environment variable `$ARTICLE_BOOKMARK_DIR` to determine the bookmark storage directory. All bookmark files and the tag index must be stored under this path. If the variable is not set, prompt the user to configure it.

>

> When calling `scripts/bookmark.sh`, you **must** pass `ARTICLE_BOOKMARK_DIR` and `ARTICLE_BOOKMARK_GITHUB` as inline environment variables — the script runs in a subprocess and does not inherit them automatically.

Quick Start

When the user provides a URL or article text to bookmark:

1. Run `scripts/bookmark.sh init` to initialize the bookmark directory

2. Read `$ARTICLE_BOOKMARK_DIR` to get the storage path

3. Use `web_fetch` to get the article content

4. Generate a concise summary using the current model

5. Auto-generate relevant tags based on content analysis

6. Create a markdown file with URL, content, summary, and tags (see [file-structure.md](references/file-structure.md) for format details)

7. Save to the bookmark directory with descriptive filename

8. Update the tag index file

9. Run `scripts/bookmark.sh save "Brief commit message"` to commit and push changes

For deletion requests: find the article, confirm details with user, then remove, update index, and run `scripts/bookmark.sh save "Delete article xxx"`.

Workflow

Adding Articles

1. Run scripts/bookmark.sh init
2. Read $ARTICLE_BOOKMARK_DIR
3. Receive URL or text content
4. Extract/save content (web_fetch for URLs)
5. Generate summary (model-based)
6. Auto-tag (keyword/topic analysis)
7. Create bookmark file (markdown format)
8. Update tag index
9. Run scripts/bookmark.sh save "Add article: <title>"

Deleting Articles

1. Run ARTICLE_BOOKMARK_DIR="$ARTICLE_BOOKMARK_DIR" ARTICLE_BOOKMARK_GITHUB="$ARTICLE_BOOKMARK_GITHUB" scripts/bookmark.sh init
2. Read $ARTICLE_BOOKMARK_DIR
3. Identify target article (by filename, topic, or content)
4. Display article details for confirmation
5. Get user confirmation
6. Delete bookmark file
7. Update tag index
8. Run ARTICLE_BOOKMARK_DIR="$ARTICLE_BOOKMARK_DIR" ARTICLE_BOOKMARK_GITHUB="$ARTICLE_BOOKMARK_GITHUB" scripts/bookmark.sh save "Delete article: <title>"

Tag Management

Auto-Tagging Logic

Generate tags by analyzing:

Maintain consistent tag vocabulary to avoid duplicates (e.g., use "AI" not "artificial-intelligence").

Tag Index Format

TAG_INDEX.md maintains bidirectional mapping (see [file-structure.md](references/file-structure.md) for full format):

# Article Tag Index

## Tags

- **AI**: [article1](article1.md), [article2](article2.md)
- **Research**: [...]

## Articles by Tag Count

- 3 tags: [article1](article1.md)
- 1 tag: [...]

Implementation Details

Content Extraction

Proxy Configuration and Retry

When fetching article content from URLs fails:

1. **First Attempt**: Try fetching without proxy

2. **On Failure**: Load proxy configuration from environment variables:

- `HTTP_PROXY` or `http_proxy`: HTTP proxy URL

- `HTTPS_PROXY` or `https_proxy`: HTTPS proxy URL

- `NO_PROXY` or `no_proxy`: Comma-separated list of hosts to bypass

3. **Retry**: Re-attempt fetching with proxy configuration

4. **Final Failure**: Notify user if both attempts fail

Example environment variables:

export HTTP_PROXY="http://proxy.example.com:8080"
export HTTPS_PROXY="http://proxy.example.com:8080"
export NO_PROXY="localhost,127.0.0.1,.example.com"

Summary Generation

Generate 2-3 paragraph summaries that capture:

Keep summaries informative but concise (typically 150-300 words).

File Naming

Create SEO-friendly filenames:

Safety Checks