coverage-tracker-setup

Name: coverage-tracker-setup
Author: elvisun

483installs44forks

How to install coverage-tracker-setup?

elvisun/newsjack/coverage-tracker-setup

$npx -y skills add elvisun/newsjack --skill coverage-tracker-setup

Installs into the current project.

Summary

Set up a lightweight Google Alerts-style coverage tracker for any number of keywords. Creates a tracker config with each keyword and what it actually means, then hands recurrence to the user's agent harness.

Files · 1

View on GitHub

SKILL.md

1	# Coverage Tracker Setup
2
3	This sets up a simple keyword tracker that the `coverage-tracker` skill runs for you. Think of it like a Google Alert: it watches for new coverage of the keywords you care about and tells you when something real shows up.
4
5	It is deliberately a different job from setting up newsjack monitoring. A coverage tracker answers "did my keyword get real coverage?" Newsjack monitoring (`newsjack-monitor-setup`) answers a bigger question: "can my company jump into a broader news story?" If the user wants the second one, use that skill instead.
6
7	## Where you're running this
8
9	Two situations, and they change what you can finish here:
10
11	- You can save files and run commands (Claude Code, Codex, OpenClaw, Hermes, or a similar setup with shell, file, and network access). Here you can do the whole thing: save the tracker, run it once, and hand the recurring schedule to your agent. Before you decide you can't run the CLI, check whether `newsjack` is installed. It ships as a prebuilt, bundled binary — you do not need Go, a compiler, or any build/install step. Never look for a Go toolchain or tell the user they need a "Go environment" without checking first: run `newsjack --version`; if that's not on `PATH`, try the bundled location `~/.newsjack/bin/newsjack --version` and use that full path everywhere if it works. The bundled binary is almost always already installed — verify, don't assume it's missing.
12	- You're in a plain chat window (Claude.ai, ChatGPT, Claude Cowork, or anything without file/command access). Here you can only draft. Write out the tracker config and the schedule prompt, then tell the user to move to a setup that can save and run things. Don't try to install or run anything, and don't tell the user it was saved or scheduled when it wasn't.
13
14	## What to ask the user
15
16	Only ask for what you don't already know:
17
18	- a name for the tracker
19	- the keywords to watch (as many as they want)
20	- for each keyword, one short note on what it actually means: which company, product, or person should it point to? This is what later filters out wrong matches.
21	- optionally, words or uses to ignore when a keyword is ambiguous (for example, a common word that also happens to be a brand name)
22	- how often to check: every morning, twice a day, or hourly
23
24	Don't ask about company standing, spokespeople, competitors, proof assets, news feeds, target reporters, or story angles. All of that is for newsjacking, not for tracking coverage of your own keywords.
25
26	## Steps to set it up
27
28	1. Write the tracker config. This is a small file that the `coverage-tracker` skill reads back every time it runs, so keep its shape exactly as shown:
29
30	```json
31	{
32	"name": "Profound",
33	"lookback_days": 2,
34	"keywords": [
35	{
36	"keyword": "profound",
37	"means": "Profound, the AI search analytics company.",
38	"exclude_hints": ["generic adjective uses"]
39	}
40	]
41	}
42	```
43
44	You can list as many keywords as you want. The `means` line for each one matters: make it specific (which company, product, or person) so the tracker can later throw out mentions of the wrong thing or generic uses of the word.
45
46	If you're in a plain chat window, stop here. Hand the user this config plus the schedule prompt from step 3, and tell them to finish in a setup that can save and run things. Don't claim it was saved or scheduled.
47
48	2. Save the config with this command (replace `<slug>` with a short name for the tracker):
49
50	```bash
51	newsjack coverage init <slug> --config tracker.json
52	```
53
54	Working inside a copy of the project source, use `bin/newsjack` from the project root instead. Only add `--force` if the user clearly wants to overwrite a tracker that already exists.
55
56	3. Schedule the recurring check through your agent, not your computer's built-in scheduler. If your agent has a way to schedule prompts, schedule this one:
57
58	```text
59	Use the coverage-tracker skill for <slug>.
60	```
61
62	If your agent can't schedule things itself, tell the user exactly which prompt to set up on a schedule in Claude, Codex, Hermes, OpenClaw, or whatever they use. Do not set up system-level schedulers (cron, launchd, systemd timers, or similar) on the user's machine.
63
64	4. Run it once right away if the user wanted a working setup, or if you're doing the whole setup end to end. Use the `coverage-tracker` skill for the new slug

People who liked this also viewed

6 picks

Type

coverage-tracker-setup

483installs44forks

View on GitHub

How to install coverage-tracker-setup?

elvisun/newsjack/coverage-tracker-setup

$npx -y skills add elvisun/newsjack --skill coverage-tracker-setup

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Coverage Tracker Setup
2
3	This sets up a simple keyword tracker that the `coverage-tracker` skill runs for you. Think of it like a Google Alert: it watches for new coverage of the keywords you care about and tells you when something real shows up.
4
5	It is deliberately a different job from setting up newsjack monitoring. A coverage tracker answers "did my keyword get real coverage?" Newsjack monitoring (`newsjack-monitor-setup`) answers a bigger question: "can my company jump into a broader news story?" If the user wants the second one, use that skill instead.
6
7	## Where you're running this
8
9	Two situations, and they change what you can finish here:
10
11	- You can save files and run commands (Claude Code, Codex, OpenClaw, Hermes, or a similar setup with shell, file, and network access). Here you can do the whole thing: save the tracker, run it once, and hand the recurring schedule to your agent. Before you decide you can't run the CLI, check whether `newsjack` is installed. It ships as a prebuilt, bundled binary — you do not need Go, a compiler, or any build/install step. Never look for a Go toolchain or tell the user they need a "Go environment" without checking first: run `newsjack --version`; if that's not on `PATH`, try the bundled location `~/.newsjack/bin/newsjack --version` and use that full path everywhere if it works. The bundled binary is almost always already installed — verify, don't assume it's missing.
12	- You're in a plain chat window (Claude.ai, ChatGPT, Claude Cowork, or anything without file/command access). Here you can only draft. Write out the tracker config and the schedule prompt, then tell the user to move to a setup that can save and run things. Don't try to install or run anything, and don't tell the user it was saved or scheduled when it wasn't.
13
14	## What to ask the user
15
16	Only ask for what you don't already know:
17
18	- a name for the tracker
19	- the keywords to watch (as many as they want)
20	- for each keyword, one short note on what it actually means: which company, product, or person should it point to? This is what later filters out wrong matches.
21	- optionally, words or uses to ignore when a keyword is ambiguous (for example, a common word that also happens to be a brand name)
22	- how often to check: every morning, twice a day, or hourly
23
24	Don't ask about company standing, spokespeople, competitors, proof assets, news feeds, target reporters, or story angles. All of that is for newsjacking, not for tracking coverage of your own keywords.
25
26	## Steps to set it up
27
28	1. Write the tracker config. This is a small file that the `coverage-tracker` skill reads back every time it runs, so keep its shape exactly as shown:
29
30	```json
31	{
32	"name": "Profound",
33	"lookback_days": 2,
34	"keywords": [
35	{
36	"keyword": "profound",
37	"means": "Profound, the AI search analytics company.",
38	"exclude_hints": ["generic adjective uses"]
39	}
40	]
41	}
42	```
43
44	You can list as many keywords as you want. The `means` line for each one matters: make it specific (which company, product, or person) so the tracker can later throw out mentions of the wrong thing or generic uses of the word.
45
46	If you're in a plain chat window, stop here. Hand the user this config plus the schedule prompt from step 3, and tell them to finish in a setup that can save and run things. Don't claim it was saved or scheduled.
47
48	2. Save the config with this command (replace `<slug>` with a short name for the tracker):
49
50	```bash
51	newsjack coverage init <slug> --config tracker.json
52	```
53
54	Working inside a copy of the project source, use `bin/newsjack` from the project root instead. Only add `--force` if the user clearly wants to overwrite a tracker that already exists.
55
56	3. Schedule the recurring check through your agent, not your computer's built-in scheduler. If your agent has a way to schedule prompts, schedule this one:
57
58	```text
59	Use the coverage-tracker skill for <slug>.
60	```
61
62	If your agent can't schedule things itself, tell the user exactly which prompt to set up on a schedule in Claude, Codex, Hermes, OpenClaw, or whatever they use. Do not set up system-level schedulers (cron, launchd, systemd timers, or similar) on the user's machine.
63
64	4. Run it once right away if the user wanted a working setup, or if you're doing the whole setup end to end. Use the `coverage-tracker` skill for the new slug

People who liked this also viewed

6 picks

Type