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 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#

text

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#

text

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:

• Article domain/topic keywords
• Technical terms and concepts
• Content categories (tutorial, news, research, etc.)
• Named entities and proper nouns

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 for full format):

markdown

# 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#

• Use web_fetch with extractMode: "markdown" for web articles
• Handle truncation gracefully (respect maxChars limits)
• Preserve original formatting where possible
• GitHub Repository URLs: When the URL is a GitHub repository (e.g., https://github.com/user/repo), prioritize fetching the README content from the repository's main page or from README.md, readme.md, or README.rst files in the root directory

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:

bash

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:

• Main thesis or argument
• Key insights or findings
• Practical implications or applications

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

File Naming#

Create SEO-friendly filenames:

• Convert title to lowercase
• Replace spaces and special chars with hyphens
• Limit length to ~50 characters
• Ensure uniqueness by appending numbers if needed

Safety Checks#

• Validate URLs before fetching
• Confirm deletions with users (show path and key details)
• Maintain backup of index before modifications
• Handle concurrent access gracefully