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.

Claude CodeHermes AgentCodex CLICursorMIT (modify, redistribute and use commercially)

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.py confirms 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

  1. Unzip the downloaded file (it contains a comparison-guide-builder/ folder with SKILL.md).
  2. Copy the whole folder into your agent's skills folder.
    • Claude Code: ~/.claude/skills/ (per project: .claude/skills/)
    • Hermes Agent: ~/.hermes/skills/
  3. Restart the agent and check that the skill appears in its skill list.

Full guide