.md file to compare - side-by-side diff against scrape-competitor-pricing-weekly
scrape-competitor-pricing-weekly
description: "Triggers on prompt mention of 'scrape-competitor-pricing-weekly'."
What it does for you
Watches your competitors' pricing each week and flags changes.
What it produces
A recent result, so you can see the kind of work it returns.
loading…
How to get it
These run inside the Snappy workspace. Want this working in your business? I set skills like this up with you, in one focused week.
For developers how this skill is built, graded, and how it runs
at a glance- the short version
what's inside - the parts that make up a skill 2/4 present
A skill is just a few plain-text files. Only the main one is required. The rest are optional, added as the work needs them. This is what the skill is made of; how it runs is just below.
state/skills/scrape-competitor-pricing-weekly/SKILL.md
present
state/lib/scrape-competitor-pricing-weekly.ts
not present
state/bin/scrape-competitor-pricing-weekly/
not present
state/skills/scrape-competitor-pricing-weekly/AGENTS.md
present
how it's graded - what counts as a good run 4 criteria · 2 deterministic · 2 judge
Each row is one thing a good run has to get right. deterministic means a quick check decides, pass or fail. judge means the AI reads the result and rates it. Grading each piece on its own (instead of one overall score) shows exactly where a run fell short, so the fix is obvious.
how it runs - the shared frame every skill uses 2/5 present
Every skill runs the same way. One part does the work, a separate part checks it, and a short loader hands the AI exactly what it needs for the job. Anything this skill doesn't use shows a one-line note saying why, on purpose, not by accident.
No separate check found. Without one, the part that makes the work could end up approving its own work, worth a closer look.
This skill doesn't fix its own gaps yet.
state/log/evals.ndjson - ALWAYS read the competitor list from sources/competitors.json (human-owned). If missing, CREATE it - do not invent competitors inline.
- ALWAYS save this week's snapshot to state/log/competitor-pricing/ BEFORE comparing - partial run with no snapshot loses the baseline for next week.
- NEVER fan out parallel agent-browser fetches against one session - DOM-mutation agents drop writes silently. Serialize.
- Score 0.5 if some competitors fetched (partial). Score 0.0 only if NONE could be reached (likely auth or network).
what it has learned - fixes written back in over time sample
When a run hits something this skill didn't handle, the fix gets written back into the skill so it doesn't happen again. FIXED means it was corrected on the spot. LOGGED means it's queued for a bigger rewrite. Either way, the skill gets a little better and never makes the same mistake twice.
- Loading feedback rows…
how the work flows- step by step
cron-driven; manual via `state/lib/log.ts` `append("scrape-competitor-pricing-weekly", { ok, checked, changed })`
SKILL.md- the skill, written out in plain English
scrape-competitor-pricing-weekly
Backed by: agent-browser MCP for fetch + state/lib/log.ts for the eval row.
Cron job (Saturday 9 AM). Checks competitor pricing pages for changes.
Steps
- Read the competitor list from
sources/competitors.json(create if missing). - For each competitor URL, fetch the pricing page via
agent-browser. - Extract pricing tiers and amounts.
- Compare against last week's snapshot in
state/log/competitor-pricing/. - If any prices changed, log the delta.
- Save this week's snapshot.
append("scrape-competitor-pricing-weekly", { ok, checked, changed })viastate/lib/log.ts.
Eval
Score 1.0 if all competitors checked and snapshot saved. Score 0.5 if some competitors checked. Score 0.0 if no competitors could be reached.
Rubric
criteria:
- name: all_competitors_processed
kind: judge
check: "The skill logs indicate that pricing pages for all competitors listed in 'sources/competitors.json' were fetched and processed."
- name: new_snapshot_saved
kind: deterministic
check: "A new pricing snapshot for the current week is present in 'state/log/competitor-pricing/'."
- name: pricing_changes_logged
kind: judge
check: "If any pricing changes were detected by comparing against last week's snapshot, a clear delta was logged, including which competitor and specific changes."
- name: eval_row_appended
kind: deterministic
check: "The log via 'state/lib/log.ts' contains an entry for 'scrape-competitor-pricing-weekly' with 'ok', 'checked', and 'changed' fields."AGENTS.md- what the AI loads when this skill comes up
scrape-competitor-pricing-weekly - loader
Per-turn rules for the scrape-competitor-pricing-weekly skill. Full reference: state/skills/scrape-competitor-pricing-weekly/SKILL.md.
Critical Rules
- ALWAYS read the competitor list from
sources/competitors.json(human-owned). If missing, CREATE it - do not invent competitors inline. - ALWAYS save this week's snapshot to
state/log/competitor-pricing/BEFORE comparing - partial run with no snapshot loses the baseline for next week. - NEVER fan out parallel agent-browser fetches against one session - DOM-mutation agents drop writes silently. Serialize.
- Score 0.5 if some competitors fetched (partial). Score 0.0 only if NONE could be reached (likely auth or network).
Commands
| ui model | live composition via compose_inline, persisted as artifact lang_body, reopened with OpenArtifact | |invoke: cron-driven; manual via state/lib/log.ts append("scrape-competitor-pricing-weekly", { ok, checked, changed }) |fetch: agent-browser MCP (the documented exception lives in browser libs, not snappy-os core) |eval log: state/log/evals.ndjson (skill: "scrape-competitor-pricing-weekly")
Known Pitfalls
sources/competitors.jsonis human-owned (per program.md three-layer rule). Do not auto-edit; create the file if absent and tell the operator.- Pricing pages move tier names around between weeks - extract by amount, not by tier label.
- Cron fires Saturday 9 AM. Manual triggers should also tag the eval row so the cron history stays clean.
Self-Test
An agent reading this should correctly:
- [ ] Refuse to invent competitors; create
sources/competitors.jsoninstead - [ ] Save this week's snapshot before comparing to last week
- [ ] Serialize browser fetches (no parallel)
Found a gap? Edit this file. <!-- footer-injection-point -->
api.ts- the code it can call
⚠ no api.ts - this skill has no typed action surface
scripts- helper scripts it can run
prose-only skill - 1 inline code block live in SKILL.md above (no state/bin/ sidecar yet).
how we check it- the checks, plus the last 10 runs
no recent runs logged - the eval contract is declared but nothing has been graded yet