---
name: news
description: 'Headlines from any RSS or Atom feed, BBC world news by default. Tools: headlines. Use when a request needs any of these; each tool''s own trigger is in SKILL.md.'
compatibility: Requires fragletc and Docker. Network access required.
metadata:
  tags: world
  tools: headlines.py
---

# News

Headlines from any RSS or Atom feed, BBC world news by default.

Every tool below is one executable file beside this `SKILL.md`, in the directory the commands below call `<skill-dir>`. Run it directly. Two host requirements: [`fragletc`](https://github.com/ofthemachine/fraglet) (`curl -fsSL https://raw.githubusercontent.com/ofthemachine/fraglet/main/install.sh | sh && fragletc version`) and Docker; the image, parameters, outputs and network reach are declared in the file itself. Before running a tool, print its contract:

```sh
<skill-dir>/headlines.py --fraglet-help
```

Parameters are passed as `-p name=value` (a `file` parameter takes a host path); declared outputs are copied out with `--output <name>[=<host path>]`. A missing required parameter fails host-side with exit 2 before any container starts; otherwise the tool's own exit code is the run's. A declared output not named with `--output` is produced and discarded (a stderr note says what you could have copied). Add `--receipt run.json` (or set `FRAGLETC_RECEIPT_DIR`) to record the run: the receipt carries the tool's `procedure_hash`, image digest, parameters, and every input and output by content hash, and `receipt/attest.py` can verify it later without re-running anything.

## Tools

### `headlines.py`

The latest headlines from a news feed (RSS or Atom), newest first. Clean markdown list by default, or TSV when format=tsv.

Use when the user wants today's top news or the latest headlines from an outlet, section, or feed, or a briefing, caption, or prompt needs a live headline.

```sh
<skill-dir>/headlines.py [-p feed=feeds.bbci.co.uk/news/world/rss.xml] [-p count=5] [-p format=markdown] --output headlines.md:d=The headlines as the markdown list, whatever format stdout takes, for a later step to read
```

Parameters:
- `feed` (string, optional, default `feeds.bbci.co.uk/news/world/rss.xml`) — RSS or Atom feed URL (https:// is assumed when no scheme is given)
- `count` (string, optional, default `5`) — How many headlines to print
- `format` (string, optional, default `markdown`) — Stdout format: "markdown" for formatted clickable links, or "tsv" for title\tlink\tdate

Outputs:
- `headlines.md:d=The headlines as the markdown list, whatever format stdout takes, for a later step to read` — copy out with `--output headlines.md:d=The headlines as the markdown list, whatever format stdout takes, for a later step to read[=<host path>]`

Runs in `ofthemachine/python3@sha256:a015b4f9f0e7c1648f8fcd4164f6a296dd3c9189404f88f333a9764d08d13522`; network required — output depends on live external state; do not cache indefinitely.
