# Send Miniflux News 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. 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. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "miniflux-news",
    "name": "Miniflux News",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/hartlco/miniflux-news",
    "canonicalUrl": "https://clawhub.ai/hartlco/miniflux-news",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/miniflux-news",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=miniflux-news",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/miniflux-api-notes.md",
      "scripts/miniflux.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/miniflux-news"
    },
    "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-news",
    "downloadUrl": "https://openagent3.xyz/downloads/miniflux-news",
    "agentUrl": "https://openagent3.xyz/skills/miniflux-news/agent",
    "manifestUrl": "https://openagent3.xyz/skills/miniflux-news/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/miniflux-news/agent.md"
  }
}
```
## Documentation

### Miniflux News

Use the bundled script to fetch entries, then format a clean list and optionally write summaries.

### Setup (credentials)

This skill reads Miniflux credentials from a local config file by default.

### Config file (recommended)

Path:

~/.config/clawdbot/miniflux-news.json

Format:

{
  "url": "https://your-miniflux.example",
  "token": "<api-token>"
}

Create/update it using the script:

python3 skills/miniflux-news/scripts/miniflux.py configure \\
  --url "https://your-miniflux.example" \\
  --token "<api-token>"

### Environment variables (override)

You can override the config file (useful for CI):

export MINIFLUX_URL="https://your-miniflux.example"
export MINIFLUX_TOKEN="<api-token>"

Token scope: Miniflux API token with read access.

### Fetch latest entries

List latest unread items (default):

python3 skills/miniflux-news/scripts/miniflux.py entries --limit 20

Filter by category (by name):

python3 skills/miniflux-news/scripts/miniflux.py entries --category "News" --limit 20

If you need machine-readable output:

python3 skills/miniflux-news/scripts/miniflux.py entries --limit 50 --json

### Response formatting

Return a tight bullet list: [id] title — feed + link.
Ask how many the user wants summarized (e.g., “summarize 3” or “summarize ids 123,124”).

### View full content

Show the full article content stored in Miniflux (useful for reading or for better summaries):

python3 skills/miniflux-news/scripts/miniflux.py entry 123 --full --format text

If you want the raw HTML as stored by Miniflux:

python3 skills/miniflux-news/scripts/miniflux.py entry 123 --full --format html

### Categories

List categories:

python3 skills/miniflux-news/scripts/miniflux.py categories

### Mark entries as read (explicit only)

This skill must never mark anything as read implicitly. Only do it when the user explicitly asks to mark specific ids as read.

Mark specific ids as read:

python3 skills/miniflux-news/scripts/miniflux.py mark-read 123 124 --confirm

Mark all unread entries in a category as read (still explicit, requires --confirm; includes a safety --limit):

python3 skills/miniflux-news/scripts/miniflux.py mark-read-category "News" --confirm --limit 500

### Summarize entries

Fetch full content for a specific entry id (machine-readable):

python3 skills/miniflux-news/scripts/miniflux.py entry 123 --json

Summarization rules:

Prefer 3–6 bullets max.
Lead with the “so what” in 1 sentence.
If content is empty or truncated, say so and summarize from title + available snippet.
Don’t invent facts; quote key numbers/names if present.

### Troubleshooting

If the script says missing credentials: set MINIFLUX_URL/MINIFLUX_TOKEN or create ~/.config/clawdbot/miniflux-news.json.
If you get HTTP 401: token is wrong/expired.
If you get HTTP 404: base URL is wrong (should be the Miniflux web root).
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: hartlco
- Version: 0.1.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/miniflux-news)
- [Send to Agent page](https://openagent3.xyz/skills/miniflux-news/agent)
- [JSON manifest](https://openagent3.xyz/skills/miniflux-news/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/miniflux-news/agent.md)
- [Download page](https://openagent3.xyz/downloads/miniflux-news)