Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

253 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Newsjack.sh

The open-source skills that turn your agent into a full PR team.

Install once. Your agent β€” Claude Code, Codex, Hermes, OpenClaw β€” becomes a PR team.

curl -fsSL newsjack.sh | bash

Are you an agent? Check out Getting started

Are you a human? πŸ“‹ Copy this prompt to any AI:

help me install https://newsjack.sh from the github repo and setup a daily newsjack monitoring for my company.

Jump to platform-specific setup below for per platform breakdown.


What your agent can do once newsjack is installed

Four problems, separate lanes.

Each capability is a skill. Invoke it by name β€” /angle-generator, /fact-check β€” or just describe what you want and your agent picks the right one.

πŸ›°οΈ Detect β€” surface what matters in your space

  • βš™οΈ /newsjack-monitor-setup β€” build the monitoring profile once: your standing, beat topics, competitors, proof assets, spokespeople, feeds (local agent only)
  • πŸ“‘ /newsjack-detector β€” find newsjacking opportunities: fresh stories you have the standing to jump on before the wave breaks (see a sample run)
  • πŸ”Ž /news-search β€” dated, attributed articles on a topic, company, or competitor: when they launch, raise, or stumble, you know
  • πŸ” /story-origin-check β€” verify the story is still fresh: who broke it, who owns it, what oxygen's left
  • 🧹 /relevance-coarse-filter β€” cheap high-recall first pass that throws out obvious junk before anything expensive runs
  • 🚦 /newsjack-triage β€” route surviving stories by whether you actually have standing: pitch now, watch, or surface as big news
  • πŸ”” /coverage-tracker-setup β€” declare the keywords you want watched, and what each one actually means (local agent only)
  • πŸ—žοΈ /coverage-tracker β€” Google Alerts-style keyword tracking with LLM filtering for real features, alerting only on genuinely new coverage

πŸš€ Act β€” turn signal into output

  • 🎯 /angle-generator β€” turn one update into hooks framed for different beats
  • πŸ“ /headline-generator β€” headlines and pitch subject lines built from the story's raw facts
  • πŸ₯Š /meanest-editor β€” roast your pitch against the rubric editors actually use
  • 🚨 /crisis-holding β€” holding statements, journalist Q&A posture, and what not to say, with a hard legal-counsel gate
  • πŸŽ™οΈ /reactive-comment β€” triage inbound HARO-style source requests, draft only the real fits
  • βœ… /fact-check β€” extract claims, verify each, flag the shaky ones before you send
  • 🀝 /journalist-fit-check β€” will this reporter actually care, or are you spamming?
  • πŸ₯‡ /same-outlet-ranker β€” rank colleagues at the same publication and send to one, instead of spraying the masthead
  • πŸ—£οΈ /voice-extractor β€” fingerprint your real writing, kill the AI tells
  • πŸ“‹ /find-journalists β€” build a fit-checked media list: targeted reporters, not scraped contact dumps
  • πŸ“° /press-clip β€” turn a live article URL into a branded press-clip PDF: the outlet's own logo and layout kept, ads and clutter stripped, the client's mention highlighted (local agent only)

🧭 Strategize β€” figure out what your story even is

  • πŸ—ΊοΈ /pr-strategist β€” opinionated walkthrough if you're not PR-fluent yet: audience first, positioning second, news pegs third, drumbeat over big-bang
  • πŸ“… /pr-calendar β€” plan six months of source-backed upcoming hooks, with prior-year coverage patterns for angle inspiration
  • πŸ“Š /newsworthiness-check β€” cold read on whether it clears the bar before you act

πŸ”¬ AI visibility β€” get your facts into AI answers (AEO/GEO)

  • ✍️ /ai-visibility-writing β€” audit or fact-preservingly revise supplied copy so AI answers can reuse it, without inventing evidence or promising rankings or citations
  • 🧭 /build-ai-visibility-panel β€” to measure it, run this one first: it drives the six below it in order, turning any public URL and description into an evidence-bound prompt list across intent, journey, B0–B5 proximity, aided status, roles, locales, surfaces, and tracking partitions
  • πŸ‘₯ /icp-evidence-analysis β€” turn a company and market dossier into testable ideal-customer hypotheses, buying roles, triggers, disqualifiers, and named research gaps
  • 🧩 /buyer-job-intent-analysis β€” recover the jobs, struggling moments, workarounds, and authentic buyer language from real customer, review, forum, and search evidence
  • πŸ—οΈ /prompt-proximity-architecture β€” blueprint which prompt cells are required, optional, and prohibited before anyone writes prompt wording
  • πŸ’¬ /realistic-prompt-generation β€” write natural prompt variants from a target-blind brief, so the panel isn't quietly written to flatter you
  • πŸ§ͺ /prompt-set-qa β€” gate the prompt set on provenance, contamination, answer leakage, naturalness, and semantic duplicates, quarantining anything the evidence doesn't support
  • πŸ“ /ai-visibility-panel-design β€” select QA-approved prompts into a versioned tracking panel with partitions, surfaces, locales, repetitions, weights, and refresh rules, keeping aided and unaided denominators separate and gating on a human instead of inventing an β€œAI visibility score”

Who this is for

  • Founders doing their own PR because the agency quote was insane
  • PR agencies running more accounts than humans can babysit
  • Marketers at small companies who need leverage, not headcount
  • Anyone whose agent is already running their day-to-day β€” and should be better at it

Install

Newsjack is a set of open skills β€” plain-Markdown instructions your agent reads β€” plus a small open-source CLI. Most skills run anywhere your agent runs. A few reach for a live news index, journalist enrichment, or locally-saved monitoring state β€” those work best in a local agent.

What runs where

Skill Claude.ai ChatGPT ChatGPT Work Cowork Claude Code Codex Hermes OpenClaw Medialyst
Strategize
pr-strategist βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ… βœ…
pr-calendar πŸ”§ ⚠️ πŸ”§ πŸ”§ πŸ”§ πŸ”§ πŸ”§ πŸ”§ βœ…
newsworthiness-check βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ… βœ…
AI visibility
ai-visibility-writing βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ… βœ…
build-ai-visibility-panel βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ… βœ…
icp-evidence-analysis βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ… βœ…
buyer-job-intent-analysis βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ… βœ…
prompt-proximity-architecture βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ… βœ…
realistic-prompt-generation βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ… βœ…
prompt-set-qa βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ… βœ…
ai-visibility-panel-design βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ… βœ…
Act
angle-generator βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ… βœ…
headline-generator βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ… βœ…
meanest-editor βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ… βœ…
crisis-holding βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ… βœ…
reactive-comment βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ… βœ…
fact-check βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ… βœ…
journalist-fit-check βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ… βœ…
same-outlet-ranker βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ… βœ…
voice-extractor ⚠️ ⚠️ βœ… βœ… βœ… βœ… βœ… βœ… βœ…
find-journalists πŸ”§ ⚠️ πŸ”§ πŸ”§ πŸ”§ πŸ”§ πŸ”§ πŸ”§ βœ…
press-clip ❌ ❌ ❌ ❌ βœ… βœ… βœ… βœ… πŸ”œ
Detect
news-search βœ… ⚠️ πŸ”§ πŸ”§ πŸ”§ πŸ”§ πŸ”§ πŸ”§ βœ…
story-origin-check πŸ”§ ⚠️ πŸ”§ πŸ”§ πŸ”§ πŸ”§ πŸ”§ πŸ”§ βœ…
relevance-coarse-filter βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ… βœ…
newsjack-triage βœ… ⚠️ βœ… βœ… βœ… βœ… βœ… βœ… βœ…
newsjack-detector ⚠️ ⚠️ ⚠️ ⚠️ πŸ”§ πŸ”§ πŸ”§ πŸ”§ πŸ”œ
newsjack-monitor-setup ❌ ❌ ❌ ❌ βœ… βœ… βœ… βœ… πŸ”œ
coverage-tracker ⚠️ ⚠️ ⚠️ ⚠️ βœ… βœ… βœ… βœ… πŸ”œ
coverage-tracker-setup ❌ ❌ ❌ ❌ βœ… βœ… βœ… βœ… πŸ”œ

Legend:

  • βœ… Runs out of the box β€” no setup; works anywhere your agent does.
  • πŸ”§ May need an external connection β€” requires or does its best work with an external data source connected (e.g. the X API or the Medialyst API).
  • ⚠️ Limited Mode β€” runs in a chat app, but as a best-effort, one-shot pass with nothing saved between sessions: no stored voice fingerprint, no scheduled monitoring, no repeat-suppression. Connect a local agent for the saved, scheduled version.
  • πŸ”œ Coming soon β€” not available here yet.
  • ❌ Not supported here β€” needs a local agent. The two setup skills (newsjack-monitor-setup, coverage-tracker-setup) only save a profile or config and schedule it; press-clip drives a real Chrome/Edge browser via Playwright to render and clip the live page, which chat apps can't do.

pr-calendar is setup-required but portable: it works anywhere the agent can use the newsjack CLI or a connected Medialyst MCP/connector. The calendar endpoint is free; login is required only to prevent abuse. Consumer ChatGPT is the exception for now because of the same skill-loading limitation called out above.

Set up your agent:

Local agents (Claude Code, Codex, Hermes, OpenClaw)

Technical? One line on macOS / Linux (review install.sh first if you like):

curl -fsSL newsjack.sh | bash

Not technical? πŸ“‹ Copy this prompt to any AI:

help me setup https://newsjack.sh

It reads the guide and handles the rest β€” npm fallback, Windows, credentials β€” on any platform.

Prefer a video? Watch the Newsjack installation walkthrough.

Claude.ai & Cowork

Install the Newsjack plugin:

  1. Open Customize.
  2. Go to Personal plugins.
  3. Click Create plugin.
  4. Choose Add marketplace.
  5. Choose Add from a repository.
  6. In the repository URL field, enter elvisun/newsjack and confirm.
  7. Open the new elvisun/newsjack marketplace, find the newsjack@newsjack plugin, and click Install.
  8. (Optional) Unlock the πŸ”§ skills by connecting a Medialyst account so your agent can access live news search, PR calendar lookup, and journalist enrichment. In local agent harnesses, run newsjack login and approve the printed Medialyst link. If you don't have an account you can create a free one on the Medialyst signup page.
  9. (Optional) Back in Claude, find the Medialyst connector under the installed Newsjack plugin page, click Connect on the Medialyst connector and authorize it over OAuth.

Note: A community marketplace plugin, newsjack@claude-community, is pending review and will be added soon.

The two always-on monitors run here in ⚠️ Limited Mode β€” a best-effort, one-shot scan with nothing saved. For saved, scheduled monitoring, use a local agent.

ChatGPT

ChatGPT runs Newsjack only in a degraded ⚠️ form, because Skills aren't available on consumer accounts. For the full toolkit, use ChatGPT Work or OpenAI's Codex.

ChatGPT Work

ChatGPT Work has the Skills beta, so Newsjack runs there at the same level as Cowork: everything except the two setup skills and press-clip, which need a local agent.


What gets installed

~/.newsjack/
β”œβ”€β”€ bin/newsjack          # CLI
└── newsjack/             # managed bundle

skills installed to your detected runtime(s):
  newsworthiness-check    score whether your news clears the bar
  headline-generator      headlines and subject lines from raw story facts
  find-journalists        build small, fit-checked journalist lists
  ...and more

The npm package bundles the same CLI and skills, with the newsjack command installed on PATH.

Curl-installed Newsjack auto-updates from the latest GitHub Release before each run. Set NEWSJACK_AUTO_UPDATE=0 to disable.

You can also install the CLI by itself using npm:

npm i -g newsjack@latest

Contributors

About

The open-source skills that turn your agent into a full PR team.

Topics

Resources

Contributing

Security policy

Stars

627 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages