Agent skill

News Search

by elvisun in elvisun/newsjack

Search current news for a topic, company, competitor, or hook and return dated, attributed articles.

MITAuto-check passedBackend & APIs

Install News Search

skills CLI
$ npx skills add elvisun/newsjack --skill news-search -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install elvisun/newsjack news-search --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/elvisun/newsjack.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/news-search .claude/skills/news-search && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
news-search
GitHub stars
1.5k
Token cost
~1.5k tokens
SKILL.md length
830 words
Files
1
Skills in repo
30
Repo updated
First seen
Licence
MIT

At a glance

Search current news for a topic, company, competitor, or hook and return dated, attributed articles.

  • Works in 2 steps: Medialyst news search (preferred) → Host web / browser search (fallback)
  • Tasks that involve REST APIs
  • SKILL.md covers What good news search returns, How to search — best option… and Output
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

News Search is an agent skill from elvisun/newsjack. Search current news for a topic, company, competitor, or hook and return dated, attributed articles. Uses the newsjack CLI and Medialyst REST API when available, tries direct Medialyst MCP if the CLI is missing, and falls back to host web/browser search with explicit caveats only when neither cloud path is available.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering REST APIs. It works with Model Context Protocol. The repository describes itself as: The open-source skills that turn your agent into a full PR team. The licence is MIT.

When your agent uses it

  • Tasks that involve REST APIs

Example prompts

  • “/news-search”

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Medialyst news search (preferred)
  2. Host web / browser search (fallback)

What it can do on your machine

Read from SKILL.md and the folder at commit b5a8dc8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • medialyst.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

News Search loads about 1.5k tokens when it runs. Until then it costs about 83 tokens; SKILL.md has 830 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~83
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from elvisun/newsjack at commit b5a8dc8, republished under its MIT licence (© elvisun). 830 words, ~1,497 tokens.

Download SKILL.mdSave it as .claude/skills/news-search/SKILL.md (or your agent's skills folder).
name
news-search
description
Search current news for a topic, company, competitor, or hook and return dated, attributed articles. Uses the newsjack CLI and Medialyst REST API when available, tries direct Medialyst MCP if the CLI is missing, and falls back to host web/browser search with explicit caveats only when neither cloud path is available.
when_to_use
User asks to search the news, find recent coverage, check who has written about a topic, or pull article evidence; or another Newsjack skill needs dated…
metadata.category
Detect

You are news-search, the Newsjack skill that turns a topic, company, competitor, or hook into a short list of dated, attributed news articles that other skills can trust.

You are not a general web researcher, and you are not a contact scraper. Your one job is to return real, recent news, each piece tied to its source, with the details other skills rely on: the outlet, the author, when it was published, and the article's real link.

What good news search returns

Every skill that uses your results needs the same four facts about each article. Provide them, or note that one is missing — never make them up.

  • title
  • url (the article's own canonical link where you can find it)
  • outlet
  • author (when available)
  • published_at (in ISO 8601 format; the time the article was actually published, not the time you ran the search)

Who relies on this, and why:

  • story-origin-check uses the publish time and link to work out when a story first went public and whether two pieces are the same story.
  • newsworthiness-check looks at how widely a story was picked up, how many articles ran, and the earliest timestamp.
  • find-journalists ties each journalist to a real, recent byline.
  • newsjack-detector ranks stories and screens them for freshness.
  • coverage-tracker checks keyword coverage and needs dated, attributed articles so it can throw out junk and mentions of the wrong company.

If you don't know the publish time or the outlet, say so. A result without a date you can stand behind is not proof that a story is fresh.

How to search — best option first

1. Medialyst news search (preferred)

If the newsjack CLI is installed and authenticated, use newsjack news search. If the CLI is missing but the runtime exposes direct Medialyst MCP tools, use search_news instead. Medialyst is built for exactly this job, and it wins for two plain reasons:

  1. General web search is bad at news. It favors pages that rank well and stay relevant for years, not the latest coverage; it buries or paywalls original reporting; and it rarely shows a trustworthy publish time, so you can't honestly claim a story is fresh based on it.
  2. Medialyst gives you the source details — outlet, author, publish time, and the article's real link — that every skill above needs, already cleaned up and consistent.

Medialyst is an optional add-on, not a signup wall. New accounts get 100 free credits (about 10,000 news searches). See medialyst.ai/agents for what it adds and current pricing.

Start with:

bash
newsjack auth status

If the CLI is installed but unauthenticated and the user wants the Medialyst upgrade, run:

bash
newsjack login

Tell the user to open the printed Medialyst link and approve newsjack CLI. This is the default interactive path; do not ask them to paste a mlst_... API key unless they specifically need CI or automation setup.

Then search:

bash
newsjack news search --query "AI customer support automation" --tbs qdr:m

Use focused queries and short recency windows where freshness matters. If you need exact API fields beyond the CLI convenience flags, pass the request body with --json or --json-file. Do not try to set up MCP yourself; only use direct Medialyst MCP tools if they are already available in the runtime.

Show full SKILL.md (307 more words)Show less
2. Host web / browser search (fallback)

Use host web or browser search only when both cloud paths are unavailable or unusable: the newsjack CLI is missing, the user declines login, Medialyst is forbidden, rate-limited, or out of credits, and direct Medialyst MCP tools are not available or also fail. Do not stop, and do not treat missing Medialyst auth as a problem to report. Instead, fall back to the host's web search or browser tools:

  • Search for the topic along with cues that pull in recent coverage; favor named outlets and original reporting over aggregators and SEO pages.
  • Open the pages you find and read their page details (the article:published_time or datePublished tags, or the byline and date on the page) to recover a real publish time. Don't treat the time you searched as the time the article was published.
  • Throw out SEO listicles, product documentation, content farms, and outlet homepages or section pages — they aren't article evidence.

What you give up in fallback mode — and must flag: publish times and outlet attribution are less reliable, so be more careful with claims about freshness and about who broke a story. When you can't recover a publish time you can stand behind, still return the article, but mark the date as unknown and lower your confidence rather than guess. And tell the skill (or the user) that the results came from host search, not Medialyst, so freshness is best-effort.

Output

Present the results to the reader as a short, deduped list of articles. For each one, give the headline, the outlet, the date, a one-line note on why it's relevant, and the link. Add a brief note on which mode produced the list (Medialyst or host search) and flag any freshness caveats. Keep the list small and on-point — this is evidence for a decision, not a data dump.

© elvisun, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/news-search of elvisun/newsjack.

Open the folder on GitHubat commit b5a8dc8

Compare with similar skills

News Search next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

News Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
News Search this skillelvisun/newsjack1.5k—~1.5kAutomated safety check: PassMIT
OpenAPI to MCP Servermcp-use/mcp-use11k—~5.2kAutomated safety check: PassApache-2.0
Legbaevilsocket/legba1.9k—~2.2kAutomated safety check: PassCustom licence
Databuddydatabuddy-analytics/Databuddy1.2k—~2.1kAutomated safety check: PassAGPL-3.0
API Endpoint Contracttrycompai/comp2k—~2.7kAutomated safety check: PassAGPL-3.0
Skyllassafelovic/skyll247—~928Automated safety check: PassApache-2.0

Similar skills

  • OpenAPI to MCP Server

    mcp-use/mcp-use

    Turns an OpenAPI or Swagger spec into an MCP server with the mcp-use TypeScript SDK, mapping each operation to a tool, wiring auth, testing and deploying.

    11k GitHub stars~5.2k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Legba

    evilsocket/legba

    A skill your agent uses when the user wants to brute-force credentials, spray passwords, or enumerate services/subdomains against any network protocol (HTTP, SSH, FTP, SMB, RDP, databases, mail…

    1.9k GitHub stars~2.2k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Databuddy

    databuddy-analytics/Databuddy

    Integrate Databuddy analytics using the SDK, REST API, or MCP.

    1.2k GitHub stars~2.1k tokensUpdated today
    Backend & APIsAuto-check passed
  • API Endpoint Contract

    trycompai/comp

    The contract every new or modified API endpoint must follow so it is correct for the public OpenAPI spec, the MCP server (npm @trycompai/mcp-server), the ValidationPipe, and the docs.

    2k GitHub stars~2.7k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Skyll

    assafelovic/skyll

    Search and retrieve agent skills at runtime. An agent skill from assafelovic/skyll.

    247 GitHub stars~928 tokensUpdated 14 days ago
    Backend & APIsAuto-check passed
  • Send and receive transactional emails with Cloudflare Email Service (Email Sending + Email Routing).

    127 GitHub starsUsed in 2 repos~2k tokens
    Backend & APIsAuto-check passed

More from elvisun/newsjack

All 31 skills in this repo
  • Eval Graphics

    elvisun/newsjack

    Turn an eval study's numbers into on-brand, publish-ready figures using the Newsjack chart room (the eval design system), then validate them with Playwright.

    1.5k GitHub stars~2k tokensUpdated today
    Auto-check passed
  • AI Visibility Writing

    elvisun/newsjack

    Audit, question, suggest, or fact-preservingly revise a press release, blog post, contributed article, or expert explainer so AI answer systems can more easily retrieve, understand, quote, and cite…

    1.5k GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • Coverage Reel

    elvisun/newsjack

    Turn a user-owned coverage CSV and reviewed press-clip captures into an honest, source-linked earned-media dashboard and a motion-designed highlight reel (MP4) that scrolls each real article to the…

    1.5k GitHub stars~3.9k tokensUpdated today
    Auto-check passed
  • Icp Evidence Analysis

    elvisun/newsjack

    Turn a source-bound company and market dossier into testable ideal-customer-profile hypotheses, buying roles, triggers, constraints, disqualifiers, standing, counterevidence, and research gaps.

    1.5k GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Research any company, product, or service from a URL plus description and build a comprehensive, evidence-bound AEO/GEO/AI-visibility prompt panel across buyer jobs, information acts, journey…

    1.5k GitHub stars~3.1k tokensUpdated today
    Auto-check passed
  • Reactive Comment

    elvisun/newsjack

    Triage inbound journalist source queries and draft a response only when the user's expertise is a real fit.

    1.5k GitHub stars~5.6k tokensUpdated today
    Auto-check passed

Categories

Questions about News Search

What does News Search do?

Search current news for a topic, company, competitor, or hook and return dated, attributed articles. News Search is an agent skill from elvisun/newsjack. Search current news for a topic, company, competitor, or hook and return dated, attributed articles.

When should I use News Search?

News Search fits situations like: tasks that involve REST APIs.

How do I install News Search in Claude Code?

Run `npx skills add elvisun/newsjack --skill news-search -a claude-code`. Or copy the skill folder (skills/news-search in elvisun/newsjack) into .claude/skills/news-search in your project. Claude Code loads it when a task matches its description.

How do I install News Search in Codex?

Run `npx skills add elvisun/newsjack --skill news-search -a codex`. Or copy the skill folder (skills/news-search in elvisun/newsjack) into .agents/skills/news-search in your project. Codex loads it when a task matches its description.

Can I use News Search in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add elvisun/newsjack --skill news-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/news-search, .gemini/skills/news-search, .github/skills/news-search and .opencode/skills/news-search in your project.

What does News Search need to run?

SKILL.md names no scripts, command-line tools or credentials: News Search is instructions for the agent only.

Does News Search access the network?

SKILL.md names 1 domain. As links in the text: medialyst.ai. This is read from the text; nothing was executed.

Is News Search safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does News Search use?

News Search is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does News Search use?

About 1.5k tokens (SKILL.md is roughly 6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to News Search?

Skills that share tags, products or a category with News Search: OpenAPI to MCP Server (mcp-use/mcp-use, 11k stars), Legba (evilsocket/legba, 1.9k stars), Databuddy (databuddy-analytics/Databuddy, 1.2k stars) and API Endpoint Contract (trycompai/comp, 2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains News Search?

elvisun (a GitHub user) maintains it in elvisun/newsjack, which has 1,533 GitHub stars. The repository holds 30 skills in this directory. The repository was last updated on October 7, 2026.

Source: elvisun/newsjack on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.