Fact-checked product comparison guide builder
Group product articles by the problem they solve and write comparison guides with officially verified tables; missing disclosures, links or images block publishing.
What it does
Builds buying guides from your product articles or ledger.
- Fetches published articles and groups them by the problem they solve (2-7 per guide)
scripts/check_groups.pyconfirms every article belongs to exactly one guide- Writes to the fixed structure in
templates/guide-spec.md(criteria, comparison table, situation-to-candidate table, cautions, individual articles, primary sources) - Verifies every table number on official pages; unverifiable cells say "check the product page"
- Refuses to build a payload that lacks the disclosure, each member's existing affiliate link, or a cover image
How to use
python scripts/check_groups.py groups.json --articles articles.txt
Ask "add a comparison guide for every product article"; the agent runs snapshot → grouping → spec → writing → verification → publishing → live checks.
Requirements
- An agent with web fetch, Python 3
- A CMS to publish to (optional; Portable Text table example included)
Notes
- No invented sales, rankings, reviews, experience or prices.
- Affiliate URLs are never generated or rewritten.
- No promises about AI-search citation or rankings.
How to install
- Unzip the downloaded file (it contains a
comparison-guide-builder/folder withSKILL.md). - Copy the whole folder into your agent's skills folder.
- Claude Code:
~/.claude/skills/(per project:.claude/skills/) - Hermes Agent:
~/.hermes/skills/
- Claude Code:
- Restart the agent and check that the skill appears in its skill list.