← Back to Skills Marketplace
hartlco

Miniflux News

by hartlco · GitHub ↗ · v0.1.0
cross-platform ✓ Security Clean
2982
Downloads
1
Stars
8
Active Installs
1
Versions
Install in OpenClaw
/install miniflux-news
Description
Fetch and triage the latest unread RSS/news entries from a Miniflux instance via its REST API using an API token. Use when the user asks to get the latest Miniflux unread items, list recent entries with titles/links, or generate short summaries of specific Miniflux entries. Includes a bundled script to query Miniflux (/v1/entries and /v1/entries/{id}) using credentials from ~/.config/clawdbot/miniflux-news.json (or MINIFLUX_URL and MINIFLUX_TOKEN overrides).
Usage Guidance
This skill appears to do exactly what it says: it queries a Miniflux instance and only marks items read when you ask. Before installing, consider: 1) the registry metadata does not list the required MINIFLUX_URL/MINIFLUX_TOKEN or the config path — verify you are comfortable providing an API token to this skill and review the script source (provided) to confirm behavior; 2) prefer creating a read-only/minimum-scope token in Miniflux if possible; 3) the skill will write a plaintext JSON config to ~/.config/clawdbot/miniflux-news.json (it attempts 600 perms) — if you store secrets there, ensure filesystem permissions meet your policy; 4) because the skill's source/homepage/owner are not well-documented, only install if you trust the publisher or after manual review of the included script. If you want higher assurance, ask the publisher for a homepage or signed release, or run the script locally yourself rather than allowing autonomous invocation.
Capability Analysis
Type: OpenClaw Skill Name: miniflux-news Version: 0.1.0 The skill is benign, designed to interact with a Miniflux RSS reader API. It handles credentials appropriately from a dedicated config file (`~/.config/clawdbot/miniflux-news.json`) or environment variables, without attempting to access unrelated sensitive files or exfiltrate data. The `SKILL.md` explicitly includes a strong safety instruction to the agent, stating that it 'must never mark anything as read implicitly' and requires explicit user confirmation for destructive actions, which is reinforced by a `--confirm` flag in the `miniflux.py` script. The Python script uses only the standard library and performs controlled HTTP requests to the Miniflux API, with no evidence of malicious execution patterns or obfuscation.
Capability Assessment
Purpose & Capability
The name, description, SKILL.md, and included script align: the code only calls Miniflux REST endpoints (/v1/entries, /v1/entries/{id}, categories) and implements listing, fetching, summarizing, and marking-as-read. These capabilities are coherent with the stated purpose. Minor mismatch: registry metadata declares no required env vars/config paths, yet the skill expects MINIFLUX_URL/MINIFLUX_TOKEN or a config file at ~/.config/clawdbot/miniflux-news.json.
Instruction Scope
SKILL.md keeps scope narrow and explicit: it instructs the agent to use the bundled script for fetch/list/summary tasks and explicitly states it must not mark items read unless the user requests it. The instructions reference only the Miniflux API and the local config/env overrides; they do not instruct broader system reads or exfiltration.
Install Mechanism
No install spec; this is an instruction-only skill with an included Python script that uses only the standard library. Nothing is downloaded at install time and no third-party packages are introduced.
Credentials
The script legitimately requires a Miniflux URL and API token (MINIFLUX_URL and MINIFLUX_TOKEN) or an equivalent config file; that is proportionate to the stated function. However the registry metadata lists no required env vars or config paths — a documentation/metadata omission that reduces transparency. The script writes/reads ~/.config/clawdbot/miniflux-news.json (it attempts to set restrictive perms when writing).
Persistence & Privilege
The skill does not request permanent platform privileges and does not set always:true. Its only persistence is an optional config file under the user's XDG config directory; the configure command writes that file and tries to set restrictive permissions. The skill does perform network calls to the user-supplied Miniflux URL using the provided token, which is expected behavior.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install miniflux-news
  3. After installation, invoke the skill by name or use /miniflux-news
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release: list unread, filter by category, show full content, explicit mark-read (+confirm).
Metadata
Slug miniflux-news
Version 0.1.0
License
All-time Installs 8
Active Installs 8
Total Versions 1
Frequently Asked Questions

What is Miniflux News?

Fetch and triage the latest unread RSS/news entries from a Miniflux instance via its REST API using an API token. Use when the user asks to get the latest Miniflux unread items, list recent entries with titles/links, or generate short summaries of specific Miniflux entries. Includes a bundled script to query Miniflux (/v1/entries and /v1/entries/{id}) using credentials from ~/.config/clawdbot/miniflux-news.json (or MINIFLUX_URL and MINIFLUX_TOKEN overrides). It is an AI Agent Skill for Claude Code / OpenClaw, with 2982 downloads so far.

How do I install Miniflux News?

Run "/install miniflux-news" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Miniflux News free?

Yes, Miniflux News is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Miniflux News support?

Miniflux News is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Miniflux News?

It is built and maintained by hartlco (@hartlco); the current version is v0.1.0.

💬 Comments