ai-news-skill

install

source · Clone the upstream repo

git clone https://github.com/frankzch/ai-news-skill

Claude Code · Install into ~/.claude/skills/

git clone --depth=1 https://github.com/frankzch/ai-news-skill ~/.claude/skills/frankzch-ai-news-skill-ai-news-skill

manifest: SKILL.md

source content

AI Intelligence Skill

Use when the user wants to:

Run the fetcher script from the skill directory:

uv run scripts/pulse_fetcher.py

uv

is not available, install dependencies manually and use:

pip install requests pyyaml
python scripts/pulse_fetcher.py

Map the user's intent to CLI flags:

User says	Flags
"Only Reddit discussions"	`--include-categories discussion --include-sources reddit`
"Open source, no Github"	`--include-categories opensource --exclude-sources github`
"50 items, past 48 hours"	`--limit 50 --hours 48`
"Show full summaries with links"	`--show-long-summary true --show-link true`
"AI news in Chinese"	`--include-categories news --language zh`

Run

uv run scripts/pulse_fetcher.py --help

for the full list. Key flags:

--include-categories "cat1,cat2"

— Only fetch these categories:

news

opensource

discussion

kol

```
--exclude-categories "cat1,cat2"
```
— Skip these categories
```
--include-sources "src1,src2"
```
— Only from these sources
```
--exclude-sources "src1,src2"
```
— Skip these sources
```
--hours INT
```
— Time window in hours (default: 24)
```
--limit INT
```
— Max items to request. The server clamps to the tier cap (guest=3 / free=6 / member=100); anything larger is silently truncated.
```
--language en|zh
```
— Output language (default: auto-detect from system locale)
```
--show-short-summary true|false
```
— Show short summary (default: true)
```
--show-long-summary true|false
```
— Show long summary (default: false)
```
--show-link true|false
```
— Show article URLs (default: false)
```
--output-file FILE
```
— Export full JSON to file (default: pulse_output.json). Pass empty string to disable.

Each item is printed as:

1. [NEWS] Title of the article (from TechCrunch)
   Short Summary: One-line summary text
----------------------------------------

When

--output-file

is used, the full JSON response is saved to disk. See references/API.md for the response schema.

HTTP 429 means the user hit an IP rate limit (anti-spam interval or daily cap). Tell them to wait a few minutes and try again.
Tier caps on result count. The response includes a
```
tier
```
field and items are capped per request based on it:
- ```
guest
```
  (no / invalid
```
api_key
```
  ): max 3 items
- ```
free
```
  (logged in, non-member): max 6 items
- ```
member
```
  : max 100 items If the user asks for more items than the tier cap, the server silently clamps to the cap. To raise the cap, tell the user to register at InBrief.info, open Settings → PulseAI Agent Skill, copy the API Key, and paste it into the
```
api_key
```
  field of
```
config.yaml
```
  (see assets/config.default.yaml).
Use
```
--output-file
```
when links are included — terminal line-wrapping can corrupt long URLs.
If
```
config.yaml
```
exists in the skill root, it overrides default settings. See assets/config.default.yaml for the template.
The
```
--include-*
```
flags take precedence over
```
--exclude-*
```
flags for the same dimension.