Log in

Build a source-cited product spec ledger

Freeze exact product identity, size, pack count and included items from primary sources into a cited JSON ledger before writing. Includes store notes.

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

What it does

Locks product facts into a verified ledger before articles or guides are written.

  • Finds exact product URLs and saves HTML plus extracted text as evidence (EUC-JP / Shift_JIS aware)
  • Establishes size, colour, pack count, included items and refill-vs-starter status from SKU-specific content only
  • Cross-checks item IDs, shop IDs and ASINs in more than one place on the page
  • Records manufacturer-vs-seller conflicts with both sources and keeps them out of definitive prose
  • scripts/verify_ledger.py checks count, duplicates, required fields, sources and evidence files

Tested extraction notes for Rakuten Ichiba and Amazon.co.jp are in references/store-notes.md.

How to use

python scripts/verify_ledger.py ledger.json --expect 5

Ask "put these five products into a ledger"; the agent fills templates/ledger-entry.json entries and verifies them.

Requirements

  • An agent with web search and HTTP fetch, Python 3

Notes

  • Stock, prices, reviews, ratings and affiliate links are never invented.
  • No login or bot-protection bypassing; unavailable pages are replaced with other sources.

How to install

  1. Unzip the downloaded file (it contains a product-spec-evidence-ledger/ 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