New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Newsblur CLI

by samuelclay in samuelclay/NewsBlur

Manage your NewsBlur from the terminal. An agent skill from samuelclay/NewsBlur.

MITAuto-check passedProductivity & Automation

Install Newsblur CLI

skills CLI
$ npx skills add samuelclay/NewsBlur --skill newsblur-cli -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install samuelclay/NewsBlur newsblur-cli --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/samuelclay/NewsBlur.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/newsblur-cli .claude/skills/newsblur-cli && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
newsblur-cli
GitHub stars
7.6k
Token cost
~1.3k tokens
SKILL.md length
366 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

Manage your NewsBlur from the terminal. An agent skill from samuelclay/NewsBlur.

  • The user wants to interact with their NewsBlur account
  • SKILL.md covers Setup, Readonly Mode, Output Formats and Commands, plus 2 more sections
  • Calls jq and uv; reaches blog.com
  • Manage subscriptions

What it does

Newsblur CLI is an agent skill from samuelclay/NewsBlur. Manage your NewsBlur from the terminal. Read feeds, search stories, save and share articles, train intelligence classifiers, discover new feeds, and automate workflows with the NewsBlur CLI. Use when the user wants to interact with their NewsBlur account, check feeds, manage subscriptions, or build scripts around their news reading.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Productivity & Automation, covering Workflow automation. The repository describes itself as: NewsBlur is a personal news reader that brings people together to talk about the world. A new sound of an old instrument. The licence is MIT.

When your agent uses it

  • The user wants to interact with their NewsBlur account
  • Manage subscriptions
  • Build scripts around their news reading

Example prompts

  • “/newsblur-cli”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit c51f6da. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • jq
    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • blog.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Newsblur CLI loads about 1.3k tokens when it runs. Until then it costs about 87 tokens; SKILL.md has 366 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~87
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from samuelclay/NewsBlur at commit c51f6da, republished under its MIT licence (© samuelclay). 366 words, ~1,313 tokens.

Download SKILL.mdSave it as .claude/skills/newsblur-cli/SKILL.md (or your agent's skills folder).
name
newsblur-cli
description
Manage your NewsBlur from the terminal. Read feeds, search stories, save and share articles, train intelligence classifiers, discover new feeds, and automate workflows with the NewsBlur CLI. Use when the user wants to interact with their NewsBlur account, check feeds, manage subscriptions, or build scripts around their news reading.

NewsBlur CLI

The NewsBlur CLI (newsblur-cli) gives you full access to your NewsBlur account from the terminal. Install it and authenticate before running any commands.

Setup

bash
uv pip install newsblur-cli
newsblur auth login

auth login opens a browser for OAuth authorization. The token is stored at ~/.config/newsblur/.

For self-hosted instances, pass --server or set NEWSBLUR_SERVER:

bash
newsblur --server https://my-newsblur.example.com auth login

Readonly Mode

The CLI has a readonly mode that blocks all write operations (saving, sharing, training, subscribing, marking as read). Useful when handing the CLI to an AI agent.

bash
newsblur auth readonly --on

Check current readonly status:

bash
newsblur auth readonly

Disabling readonly logs you out and requires browser re-authentication. An AI agent cannot silently toggle this off.

bash
newsblur auth readonly --off
# "You have been logged out and must re-authenticate."
newsblur auth login

If you are operating in readonly mode, all write commands will fail with an error. Read commands work normally.

Output Formats

Every command supports these flags:

  • --json — structured JSON output, pipe to jq
  • --raw — unformatted plain text
  • Default — human-readable formatted output

Commands

Stories

List unread stories across all feeds:

bash
newsblur stories list

Filter by folder or limit results:

bash
newsblur stories list --folder Tech --limit 5

Full-text search across your archive:

bash
newsblur stories search "machine learning"

View saved/starred stories, optionally filtered by tag:

bash
newsblur stories saved
newsblur stories saved --tag research

Browse stories from rarely-publishing feeds (easy to miss in a busy river):

bash
newsblur stories infrequent

Fetch the original full article text from the source:

bash
newsblur stories original <story_hash>

View stories you've already read:

bash
newsblur stories read
Daily Briefing

Get an AI-curated briefing with top stories, infrequent site gems, and long reads:

bash
newsblur briefing
newsblur briefing --limit 1
newsblur briefing --json
Show full SKILL.md (160 more words)Show less
Feeds and Folders

List all subscriptions:

bash
newsblur feeds list

View the folder tree with unread counts:

bash
newsblur feeds folders

Get detailed info about a specific feed:

bash
newsblur feeds info <feed_id>

Subscribe to a new feed:

bash
newsblur feeds add https://example.com/feed.xml
newsblur feeds add https://blog.com -f Tech

Unsubscribe from a feed:

bash
newsblur feeds remove <feed_id>

Move a feed between folders or rename it:

bash
newsblur feeds organize move_feed --feed-id 42 --from News --to Tech
Story Actions

Save a story with tags:

bash
newsblur save <story_hash> --tag ai --tag research

Remove a story from saved:

bash
newsblur unsave <story_hash>

Mark stories as read by feed, folder, or specific story hashes:

bash
newsblur read --feed 42
newsblur read --folder Tech
newsblur read 123:abc 456:def

Share a story to your Blurblog:

bash
newsblur share <story_hash> --comment "Worth reading"
Intelligence Training

View your trained classifiers for a feed:

bash
newsblur train show --feed 42

Train a like on an author, tag, title, or feed:

bash
newsblur train like --feed 42 --author "Ben Thompson"
newsblur train like --feed 42 --tag analysis
newsblur train like --feed 42 --title "quarterly earnings"

Train a dislike:

bash
newsblur train dislike --feed 42 --tag sponsored
newsblur train dislike --feed 42 --author "Guest Post"
Feed Discovery

Search for new feeds by topic:

bash
newsblur discover search "machine learning"

Find feeds similar to one you already follow:

bash
newsblur discover similar --feed 42

Browse trending feeds:

bash
newsblur discover trending
Notifications

Manage per-feed notification settings:

bash
newsblur notifications --feed 42
Account

View your account info and subscription status:

bash
newsblur account

Scripting Examples

Pipe story titles to the terminal:

bash
newsblur stories list --json | jq -r '.items[] | "\(.title) - \(.feed_title)"'

Extract briefing summaries:

bash
newsblur briefing --json | jq '.items[0].section_summaries'

Save all unread stories from a folder with a tag:

bash
for hash in $(newsblur stories list --folder Research --json | jq -r '.items[].story_hash'); do
  newsblur save "$hash" --tag to-review
done

Export your feed list:

bash
newsblur feeds list --json | jq -r '.items[] | "\(.feed_title),\(.feed_address)"'

Requirements

  • Python 3.11+
  • Premium Archive ($99/year) or Premium Pro ($29/month) subscription
  • OAuth authentication via browser

© samuelclay, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/newsblur-cli of samuelclay/NewsBlur.

Open the folder on GitHubat commit c51f6da

Compare with similar skills

Newsblur CLI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Newsblur CLI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Newsblur CLI this skillsamuelclay/NewsBlur7.6k—~1.3kAutomated safety check: PassMIT
Planningn8n-io/n8n207k—~2.5kAutomated safety check: PassCustom licence
n8n Expression Syntaxczlonkowski/n8n-skills6.4k—~5.2kAutomated safety check: PassMIT
Frappe Impl ServerscriptsImpertio-Studio/Frappe_Claude_Skill_Package187—~2.6kAutomated safety check: PassMIT
Ablymembranedev/application-skills267—~2kAutomated safety check: PassMIT
Automation Flowsericrisco/rsc-harness167—~2.9kAutomated safety check: PassMIT

Similar skills

  • Planning

    n8n-io/n8n

    Official

    ONLY for coordinated multi-artifact work: multiple workflows with dependencies, shared data-table schema/migration across tasks, or the user explicitly asked to review a plan first.

    207k GitHub stars~2.5k tokensUpdated today
    Productivity & AutomationAuto-check passed

  • n8n Expression Syntax

    czlonkowski/n8n-skills

    Validates and fixes n8n's double-curly-brace expressions, covering $json, $node, and the webhook body-wrapping mistake.

    6.4k GitHub stars~5.2k tokensUpdated 22 days ago
    Productivity & AutomationAuto-check passed

  • Frappe Impl Serverscripts

    Impertio-Studio/Frappe_Claude_Skill_Package

    A skill your agent uses when implementing server-side features via Setup Server Script: document validation, auto-fill, API endpoints, scheduled tasks, permission queries.

    187 GitHub stars~2.6k tokensUpdated 21 days ago
    Productivity & AutomationAuto-check passed

  • Ably

    membranedev/application-skills

    Ably integration. An agent skill from membranedev/application-skills.

    267 GitHub stars~2k tokensUpdated 5 mo ago
    Productivity & AutomationAuto-check passed

  • Automation Flows

    ericrisco/rsc-harness

    A skill your agent uses when building or fixing a no-code automation on n8n, Make, or Zapier — trigger to multi-app steps with data mapping, dedup, retries and an error path — or picking the…

    167 GitHub stars~2.9k tokensUpdated today
    Productivity & AutomationAuto-check passed

  • Clickup

    sundial-org/awesome-openclaw-skills

    Interact with ClickUp project management platform via REST API.

    663 GitHub stars~1.6k tokensUpdated 7 mo ago
    Productivity & AutomationAuto-check passed

More from samuelclay/NewsBlur

  • Make Interfaces Feel Better

    samuelclay/NewsBlur

    Design engineering principles for making interfaces feel polished.

    7.6k GitHub starsUsed in 10 repos~1.5k tokens
    Auto-check passed

  • Commit PR

    samuelclay/NewsBlur

    A skill your agent uses when the user runs /commit-pr, says "commit and push", "open a PR", "ship this", asks to update an existing PR with new changes, or asks to resolve PR review comments in the…

    7.6k GitHub stars~4.1k tokensUpdated yesterday
    Auto-check passed

  • Investigate Forum

    samuelclay/NewsBlur

    Triage the NewsBlur support forum (forum.newsblur.com). An agent skill from samuelclay/NewsBlur.

    7.6k GitHub stars~5.7k tokensUpdated yesterday
    Auto-check passed

  • Blog Post

    samuelclay/NewsBlur

    Write a blog post for a new feature based on the current branch changes

    7.6k GitHub stars~846 tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Newsblur CLI

What does Newsblur CLI do?

Manage your NewsBlur from the terminal. An agent skill from samuelclay/NewsBlur. Newsblur CLI is an agent skill from samuelclay/NewsBlur. Manage your NewsBlur from the terminal.

When should I use Newsblur CLI?

Newsblur CLI fits situations like: the user wants to interact with their NewsBlur account; manage subscriptions; build scripts around their news reading.

How do I install Newsblur CLI in Claude Code?

Run `npx skills add samuelclay/NewsBlur --skill newsblur-cli -a claude-code`. Or copy the skill folder (skills/newsblur-cli in samuelclay/NewsBlur) into .claude/skills/newsblur-cli in your project. Claude Code loads it when a task matches its description.

How do I install Newsblur CLI in Codex?

Run `npx skills add samuelclay/NewsBlur --skill newsblur-cli -a codex`. Or copy the skill folder (skills/newsblur-cli in samuelclay/NewsBlur) into .agents/skills/newsblur-cli in your project. Codex loads it when a task matches its description.

Can I use Newsblur CLI in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add samuelclay/NewsBlur --skill newsblur-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/newsblur-cli, .gemini/skills/newsblur-cli, .github/skills/newsblur-cli and .opencode/skills/newsblur-cli in your project.

What does Newsblur CLI need to run?

Going by SKILL.md and its folder, Newsblur CLI needs the command-line tools its instructions call (jq and uv). Our summary lists: Python 3.

Does Newsblur CLI access the network?

SKILL.md names 1 domain. In commands or code: blog.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Newsblur CLI safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Newsblur CLI use?

Newsblur CLI is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Newsblur CLI use?

About 1.3k tokens (SKILL.md is roughly 5.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Newsblur CLI?

Skills that share tags, products or a category with Newsblur CLI: Planning (n8n-io/n8n, 207k stars), n8n Expression Syntax (czlonkowski/n8n-skills, 6.4k stars), Frappe Impl Serverscripts (Impertio-Studio/Frappe_Claude_Skill_Package, 187 stars) and Ably (membranedev/application-skills, 267 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Newsblur CLI?

samuelclay (a GitHub user) maintains it in samuelclay/NewsBlur, which has 7,645 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 7, 2026.

Source: samuelclay/NewsBlur on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.