esl-price-sync
Helps your agent sync product prices on electronic shelf labels. It connects sales systems and labels to ensure prices are always correct.
What it does
This tool ensures that prices shown on electronic shelf labels in stores exactly match the prices in the store's management system (ERP/POS). It does this efficiently by sending only necessary updates and managing the battery life of the labels.
When to use it
- ✓When setting up the connection between the store's pricing system and electronic labels.
- ✓When prices on the label don't match the store's system.
- ✓To plan promotions that change prices and then automatically revert.
Example of what to ask your AI
“How do I sync prices to electronic shelf labels without draining their batteries?”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
The tool compares prices from the system with those on the labels and sends only the changes. It uses a smart system to ensure updates arrive correctly, even if the network fails, and limits the number of updates to save battery.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add sickn33/agentic-awesome-skills --skill esl-price-syncOr download just the file:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/esl-price-sync/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
ESL Price Sync: Deterministic Retail Shelf-Edge Pricing Architecture
Ensure strict real-time parity between ERP/POS price masters and Electronic Shelf Label (ESL) fleets (SES-imagotag, ZKONG, Pricer, Hanshow, SOLUM) via bounded delta streams, monotonic idempotency tokens, and Sub-GHz RF battery preservation models.
When to Use This Skill
Activate this skill when:
- Designing, implementing, or auditing integration pipelines between enterprise retail masters (SAP, Oracle Retail, Dynamics 365, Lightspeed) and ESL server platforms.
- The user asks: "How do I sync price updates to ESL tags without draining batteries?", "Debug ghost pricing where POS doesn't match the shelf tag", "Design an idempotent delta feed for ZKONG or SES-imagotag", or "Schedule promotional pricing with automatic rollback".
- Reconciling price discrepancy logs between central ERP databases, ESL middleware, and wireless base station ACK telemetry.
- Calculating battery life depletion curves for e-paper tags running on CR2450 coin cells under varying refresh frequencies.
Do NOT use this skill when:
- Managing e-commerce web store frontends or dynamic pricing algorithms (this skill governs faithful delivery of decided prices to physical tags).
- Troubleshooting individual dead hardware tags before gateway RF coverage and RSSI signal propagation have been verified.
- Performing live write operations on production store fleets without a preceding read-only audit verification pass.
Core Mental Models & Non-Negotiable Rules
The 5-Layer ESL Architecture Pipeline:
- Every price synchronization event traverses five distinct operational tiers: $$\mathbf{Price\ Master\ (ERP/POS)} \xrightarrow{\text{Extract}} \mathbf{Transform\ Middleware} \xrightarrow{\text{API/Message}} \mathbf{ESL\ Server} \xrightarrow{\text{Sub-GHz/2.4GHz}} \mathbf{Base\ Station\ (AP)} \xrightarrow{\text{RF\ Packet}} \mathbf{Physical\ Tag}$$
- Traceability Invariant: Every price payload MUST carry a deterministic
trace_idrecording timestamps and status codes across all five layers. A "200 OK" from the ESL central server API is NEVER treated as proof that the physical shelf display has updated.
Strict Delta Discipline & Cryptographic Watermarking:
- Pushing a full 50,000-SKU store catalog on a scheduled cron is strictly forbidden.
- Updates MUST be generated by calculating a cryptographic row hash: $$\text{RowHash} = \text{SHA256}(\text{SKU} + \text{BasePrice} + \text{PromoPrice} + \text{Currency} + \text{UnitOfMeasure} + \text{Barcode} + \text{TemplateID})$$
- Only records where $\text{RowHash}{new} \neq \text{RowHash}{pushed}$ are queued for transmission.
- Full pushes are strictly restricted to initial store commissioning and disaster recovery restores.
Monotonic Idempotency & Out-of-Order Packet Defense:
- High-volume retail message brokers inevitably deliver packets out of order during network re-balancing.
- Every transmission packet MUST include an
idempotency_keyand a monotonically increasingversion_timestamp(ISO 8601 UTC). - If an incoming price payload has $\text{version_timestamp} \le \text{last_applied_version}$, the ESL middleware MUST discard the payload to eliminate race condition reversions.
RF Gateway Rate-Limiting & Battery Longevity Budget:
- Each physical e-paper display refresh costs between $12\ \mu\text{Ah}$ and $25\ \mu\text{Ah}$.
- A dual-CR2450 battery pack provides $1,200\text{ mAh}$ nominal capacity ($960\text{ mAh}$ usable considering passivation and low-temperature shelf environments).
- The 3-Update Daily Rule: Limiting tag updates to $\le 3$ refreshes per day guarantees a $5.5\text{--}7\text{ year}$ operational lifespan.
- Base Station Queue Throttling: Gateways operate over shared Sub-GHz (868/915 MHz) or proprietary 2.4 GHz RF channels. Batch transmissions must not exceed 150 tag updates per gateway per minute to prevent RF collision retries from draining batteries.
Read-Only Audit Mode by Default:
- Diagnostic and reconciliation tasks MUST execute in read-only audit mode.
- Output discrepancy reports containing SKU, ERP Price, Gateway ACK Price, and Divergence Layer.
- State-changing write updates require explicit operator consent.
Named Sins & Anti-Patterns (Что категорически ЗАПРЕЩЕНО)
| Anti-Pattern | Manifestation in Code/Workflow | Mandatory Production Counter-Rule |
|---|
…
FAQ
Why shouldn't I send all prices at once?
Sending all prices every time wastes battery power and overloads the network. It's better to send only what has changed.
What are 'ghost prices'?
These are when the price shown on the label differs from the price in the store's system. This tool helps prevent that.
How does it save battery?
By limiting the number of updates per day and ensuring updates are sent efficiently, the battery lasts for years.
Details
Original description by the author
Synchronizes retail prices between ERP/POS systems and Electronic Shelf Labels (SES-imagotag, ZKONG, Pricer, Hanshow, SOLUM) with delta watermarking, idempotency, and battery modeling. Trigger phrases: esl price sync, electronic shelf labels, zkong sync, ses imagotag price, ghost pricing audit.
Popularity
- GitHub stars
- 48k
- Ranking position
- #2935
- License
- MIT
- Updated
- 10/15/2026
Comments
- …
More skills from this repository
00-andruia-consultant
Helps your agent start or improve AI projects. It analyzes code, suggests tools, and creates action plans in Spanish.
sickn33/agentic-awesome-skills
007
Lets your agent perform security audits and threat modeling. It's useful for protecting projects against attacks and vulnerabilities.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Helps your agent create or improve AI tools. It defines how tools work, writes documentation, and validates the structure.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Lets your agent create a summary about a specific industry. It's useful for understanding the context, rules, usage patterns, and risks of a project, using reliable sources.
sickn33/agentic-awesome-skills
Similar skills
dashboard-builder
Helps your agent create useful monitoring dashboards. It turns data into charts that answer important system questions.
affaan-m/ECC
dev-team
Simulates a collaborative development team where different roles respond to a problem together. It's useful for getting multiple perspectives without manually switching agents.
affaan-m/ECC
ecc-council
Has your agent convene a four-voice council for difficult decisions. It's useful when there are multiple good options and debate is needed before choosing.
affaan-m/ECC