Skip to content

SKILL.md

Latest commit

 

History

History
91 lines (72 loc) · 4.05 KB

SKILL.md

File metadata and controls

91 lines (72 loc) · 4.05 KB
name ai-news-skill
description Fetch the latest AI/ML news, trending open-source projects, social media discussions, and KOL (Key Opinion Leader) perspectives from 75+ curated sources. Use when the user asks about recent AI news, AI trends, what's happening in machine learning, open-source AI projects, AI Twitter/Reddit discussions, or wants a daily AI briefing.
license MIT
compatibility Requires Python 3.9+ and internet access. Dependencies (requests, pyyaml) are declared inline via PEP 723; use `uv run` for zero-setup execution.
metadata
author version
frankzch
1.1

AI Intelligence Skill

When to use this skill

Use when the user wants to:

  • Get the latest AI/ML news and announcements
  • Browse trending open-source AI projects from GitHub
  • Read AI discussion highlights from Reddit, X (Twitter), HackerNews
  • See what AI KOLs (Key Opinion Leaders) are saying
  • Get a comprehensive daily AI briefing

Workflow

Default: Fetch latest AI briefing

Run the fetcher script from the skill directory:

uv run scripts/pulse_fetcher.py

If uv is not available, install dependencies manually and use:

pip install requests pyyaml
python scripts/pulse_fetcher.py

Filtered fetch

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

Available options

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.

Output format

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.

Gotchas

  • 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.