# Send Miniflux to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "miniflux", "name": "Miniflux", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/shekohex/miniflux", "canonicalUrl": "https://clawhub.ai/shekohex/miniflux", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/miniflux", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=miniflux", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "README.md", "SKILL.md", "scripts/miniflux-cli.py" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "miniflux", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-05T16:00:50.836Z", "expiresAt": "2026-05-12T16:00:50.836Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=miniflux", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=miniflux", "contentDisposition": "attachment; filename=\"miniflux-0.1.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "miniflux" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/miniflux" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/miniflux", "downloadUrl": "https://openagent3.xyz/downloads/miniflux", "agentUrl": "https://openagent3.xyz/skills/miniflux/agent", "manifestUrl": "https://openagent3.xyz/skills/miniflux/agent.json", "briefUrl": "https://openagent3.xyz/skills/miniflux/agent.md" } } ``` ## Documentation ### Miniflux Skill Browse, read, and manage Miniflux RSS/atom feed articles through a CLI. ### Quick Start # List unread articles (brief format) uv run scripts/miniflux-cli.py list --status=unread --brief # Get article details uv run scripts/miniflux-cli.py get 123 # Mark articles as read uv run scripts/miniflux-cli.py mark-read 123 456 # Show article statistics (word count, reading time) uv run scripts/miniflux-cli.py stats --entry-id=123 ### Configuration Configuration precedence (highest to lowest): CLI flags: --url, --api-key Environment variables: MINIFLUX_URL, MINIFLUX_API_KEY Config file: ~/.local/share/miniflux/config.json (auto-created on first run) ### Setup # Option 1: Environment variables (recommended for agents) export MINIFLUX_URL="https://miniflux.example.org" export MINIFLUX_API_KEY="your-api-key" # Option 2: CLI flags (one-time, saves to config) uv run scripts/miniflux-cli.py --url="https://miniflux.example.org" --api-key="xxx" list ### list - List Articles List articles with optional filtering. # Unread articles (brief) uv run scripts/miniflux-cli.py list --status=unread --brief # From specific feed with summary uv run scripts/miniflux-cli.py list --feed=42 --summary # Search with limit uv run scripts/miniflux-cli.py list --search="python" --limit=10 # Starred articles uv run scripts/miniflux-cli.py list --starred Flags: --status={read,unread,removed} - Filter by status --feed=ID - Filter by feed ID --category=ID - Filter by category ID --starred - Show only starred --search=QUERY - Search articles --limit=N - Max number of entries --offset=N - Skip first N chars in content --content-limit=N - Max characters per article -b, --brief - Titles only -s, --summary - Title + excerpt -f, --full - Full content (default) --json - JSON output --plain - Single-line per entry ### get - Get Article by ID Fetch a single article with content control. # Full article uv run scripts/miniflux-cli.py get 123 # First 2000 characters uv run scripts/miniflux-cli.py get 123 --limit=2000 # Read from character 1000 to 2000 (pagination) uv run scripts/miniflux-cli.py get 123 --offset=1000 --limit=1000 When content is truncated, shows: [...truncated, total: N chars] ### mark-read - Mark as Read Mark one or more articles as read. # Single article uv run scripts/miniflux-cli.py mark-read 123 # Multiple articles uv run scripts/miniflux-cli.py mark-read 123 456 789 ### mark-unread - Mark as Unread Mark one or more articles as unread. uv run scripts/miniflux-cli.py mark-unread 123 ### feeds - List Feeds List all configured feeds. # Human-readable uv run scripts/miniflux-cli.py feeds # JSON format uv run scripts/miniflux-cli.py feeds --json ### categories - List Categories List all categories. uv run scripts/miniflux-cli.py categories ### stats - Statistics Show unread counts or article statistics. # Article statistics (word count, character count, reading time) uv run scripts/miniflux-cli.py stats --entry-id=123 # Global unread counts per feed uv run scripts/miniflux-cli.py stats ### refresh - Refresh Feeds Trigger feed refresh. # Refresh all feeds uv run scripts/miniflux-cli.py refresh --all # Refresh specific feed uv run scripts/miniflux-cli.py refresh --feed=42 ### search - Search Articles Convenient alias for list --search. uv run scripts/miniflux-cli.py search "rust" uv run scripts/miniflux-cli.py search "ai" --status=unread --brief ### Output Formats --brief / -b - Quick overview (titles + feed + date) --summary / -s - Title + content preview (200 chars) --full / -f - Complete article content (default) --json - Raw JSON output for machine processing --plain - Single-line per entry (tab-separated) ### Long Article Handling For articles with large content (e.g., >5k words): Check statistics first: uv run scripts/miniflux-cli.py stats --entry-id=123 Shows word count, character count, reading time. Use pagination to read in chunks: # First 5000 chars uv run scripts/miniflux-cli.py get 123 --limit=5000 # Next 5000 chars (chars 5000-10000) uv run scripts/miniflux-cli.py get 123 --offset=5000 --limit=5000 For summarization: If article is >5000 words, use a subagent to read and summarize: # Get stats to determine word count uv run scripts/miniflux-cli.py stats --entry-id=123 # If >5000 words, delegate to subagent for summarization ### Error Handling The CLI provides helpful error messages: Invalid credentials → Check MINIFLUX_API_KEY Article not found → Suggests using list to browse Missing config → Shows config file location No results → Clear message ### Standard Flags -v, --version - Show version -q, --quiet - Suppress non-error output -d, --debug - Enable debug output --no-color - Disable colored output --url=URL - Miniflux server URL --api-key=KEY - Miniflux API key ### Daily Workflow # Check what's unread uv run scripts/miniflux-cli.py list --status=unread --brief # Read interesting articles uv run scripts/miniflux-cli.py get 456 # Mark as read uv run scripts/miniflux-cli.py mark-read 456 ### Research Mode # Search for specific topics uv run scripts/miniflux-cli.py search "machine learning" --summary # Get full article content uv run scripts/miniflux-cli.py get 789 ### Batch Processing # Get all unread as JSON for processing uv run scripts/miniflux-cli.py list --status=unread --json # Mark multiple as read uv run scripts/miniflux-cli.py mark-read 123 456 789 For complete help on any subcommand: uv run scripts/miniflux-cli.py --help ## Trust - Source: tencent - Verification: Indexed source record - Publisher: shekohex - Version: 0.1.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-05T16:00:50.836Z - Expires at: 2026-05-12T16:00:50.836Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/miniflux) - [Send to Agent page](https://openagent3.xyz/skills/miniflux/agent) - [JSON manifest](https://openagent3.xyz/skills/miniflux/agent.json) - [Markdown brief](https://openagent3.xyz/skills/miniflux/agent.md) - [Download page](https://openagent3.xyz/downloads/miniflux)