← Back to Skills Marketplace
shekohex

Miniflux

by shekohex · GitHub ↗ · v0.1.0
cross-platform ⚠ suspicious
2199
Downloads
1
Stars
9
Active Installs
1
Versions
Install in OpenClaw
/install miniflux
Description
Browse, read, and manage Miniflux feed articles. Use when Claude needs to work with RSS/atom feeds via Miniflux - listing unread/new articles, reading article content, marking articles as read, and managing feeds/categories. Provides CLI access with flexible output formats (headlines, summaries, full content).
Usage Guidance
What to consider before installing: - The CLI will contact whichever Miniflux server you configure and requires MINIFLUX_URL and MINIFLUX_API_KEY (the script will refuse to run without them), but those required env variables are not declared in the registry metadata — treat that as a metadata mismatch. - By default the script saves the API key to ~/.local/share/miniflux/config.json (or $XDG_DATA_HOME/miniflux/config.json). If you do not want the key persisted to disk, pass the key via environment variable at runtime and avoid using the CLI flags that trigger saving, or inspect/modify the script to change this behavior. - The script uses 'uv' to run and will install the 'miniflux' Python package (from PyPI) at runtime. If you have policy concerns about automatic dependency installation, review the script and dependency provenance first or run it in a sandbox. - The package owner/source/homepage are not present in the registry entry; verify the author's identity or review the included code thoroughly before granting access to your Miniflux API key. - If you want to proceed: verify the script contents (already included), ensure the Miniflux API key has the minimum necessary permissions, and consider using ephemeral credentials or a dedicated read-only key. If the publisher updates the registry metadata to declare required env vars and disclose config persistence, my confidence in coherence would rise.
Capability Analysis
Type: OpenClaw Skill Name: miniflux Version: 0.1.0 The OpenClaw Miniflux skill is a benign CLI client for interacting with a Miniflux RSS reader. The `SKILL.md` and `README.md` provide clear, non-malicious instructions for agent usage, lacking any prompt injection attempts. The `scripts/miniflux-cli.py` script correctly handles configuration via environment variables or a standard XDG config file (`~/.local/share/miniflux/config.json`), uses a legitimate Python library (`miniflux`), and sanitizes HTML content. There is no evidence of data exfiltration, unauthorized command execution, persistence mechanisms, or obfuscation. All network and file access is aligned with the stated purpose of managing Miniflux feeds.
Capability Assessment
Purpose & Capability
Name/description match the code: the script implements list/get/mark/feeds/categories/stats/refresh/search functionality against a Miniflux server. Requiring the 'uv' runner and the miniflux Python client is coherent for this purpose. However, the registry metadata declares no required environment variables or primary credential even though the CLI requires MINIFLUX_URL and MINIFLUX_API_KEY (or CLI flags) to function — that mismatch is unexpected.
Instruction Scope
SKILL.md and the CLI instruct the agent to call the user's Miniflux server (URL set by env/flags) and to save credentials to a local config file (~/.local/share/miniflux/config.json). The instructions do not request other system files or unrelated secrets. The only scope creep is the implicit instruction to persist the API key to disk (config file) and the mention of delegating very large-article summarization to a 'subagent' (vague).
Install Mechanism
The registry has no install spec (instruction-only), which is low-risk. The script uses 'uv' to run and declares a dependency on the 'miniflux' Python package; that implies runtime dependency installation from PyPI when executed via uv. This is expected but is a moderate-risk surface compared with pure instruction-only skills because it will pull packages at runtime from PyPI.
Credentials
The skill requires MINIFLUX_URL and MINIFLUX_API_KEY to operate (the script will exit without them), but the registry metadata lists no required env vars or primary credential. Additionally, the script saves the API key to a config file in the user's home directory (XDG_DATA_HOME or ~/.local/share). Persisting the API key to disk increases exposure and should be explicitly declared and communicated in metadata.
Persistence & Privilege
The skill does write its own config file (~/.local/share/miniflux/config.json) to persist base_url and api_key. It does not request system-wide privileges, nor does it modify other skills' configs. 'always' is false and the skill does not request elevated or cross-skill access. Persisting secrets to the user home directory is normal for a CLI but is a permanence/privacy consideration.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install miniflux
  3. After installation, invoke the skill by name or use /miniflux
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release of Miniflux RSS/Atom feed CLI skill: - Browse, read, and manage Miniflux articles from the command line. - List, search, and filter articles with flexible output (brief, summary, full content, JSON). - Read full articles with support for pagination and truncation notices. - Mark articles as read/unread, and list feeds and categories. - Show article statistics (word count, reading time), support batch processing, and trigger feed refresh. - Configurable via CLI flags, environment variables, or config file; provides robust error handling and standard CLI controls.
Metadata
Slug miniflux
Version 0.1.0
License
All-time Installs 9
Active Installs 9
Total Versions 1
Frequently Asked Questions

What is Miniflux?

Browse, read, and manage Miniflux feed articles. Use when Claude needs to work with RSS/atom feeds via Miniflux - listing unread/new articles, reading article content, marking articles as read, and managing feeds/categories. Provides CLI access with flexible output formats (headlines, summaries, full content). It is an AI Agent Skill for Claude Code / OpenClaw, with 2199 downloads so far.

How do I install Miniflux?

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

Is Miniflux free?

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

Which platforms does Miniflux support?

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

Who created Miniflux?

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

💬 Comments