← Back to Skills Marketplace
Promotion Engine
by
fangwei-frank
· GitHub ↗
· v1.0.0
· MIT-0
110
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install promotion-engine
Description
Retail promotion calculator and discount lookup for digital employees. Computes final prices after applying discounts, bundles, thresholds, and membership ti...
Usage Guidance
What to consider before installing or using:
- Functionality mismatch: the SKILL.md promises bundle/gift/member_price handling but the script only implements threshold and percentage discounts (and membership rate). If you need bundle/gift logic, ask the author to provide tests or implement those rules.
- KB file access: the script reads whatever JSON file path you pass via --kb. Make sure the agent is only given a sanitized knowledge_base.json (no secrets, tokens, or unrelated sensitive data) and consider running the skill in a sandboxed environment.
- Review/QA: inspect promo examples and test edge cases (bundles, BOGO, excluded items, stackability) with sample KBs before trusting customer-facing outputs.
- Missing references: SKILL.md references references/promo-rules-guide.md which is not included; ask the publisher for that document if you need the authoritative rule parsing spec.
- If you plan to allow autonomous agent runs, restrict the agent’s ability to choose arbitrary file paths or validate the --kb argument to prevent accidental data exposure.
Capability Analysis
Type: OpenClaw Skill
Name: promotion-engine
Version: 1.0.0
The skill bundle is a legitimate retail promotion calculator. The Python script (scripts/calculate_promotion.py) uses standard libraries to process discount logic based on a provided knowledge base file and item list, with no evidence of network activity, data exfiltration, or unauthorized command execution. The SKILL.md instructions are strictly aligned with the stated purpose of calculating prices and explaining discounts to users.
Capability Assessment
Purpose & Capability
Name/description = retail promotion calculator. The included script implements core threshold and percent discounts and membership discounts, which is coherent with the purpose. However SKILL.md advertises support for bundles, gifts, member_price, and more complex rules; the script does not implement bundle/gift/member_price parsing or bundle-specific logic. This is a functional mismatch (over-promised features).
Instruction Scope
SKILL.md instructs the agent to use scripts/calculate_promotion.py and a knowledge_base.json containing promotions[] and membership{}. The script reads an arbitrary --kb path (Path(args.kb).read_text()) and will JSON-load whatever file is passed. There is no guidance or enforcement limiting which file may be supplied; if the agent is given a path outside the intended KB, the script will read that file (if readable). This increases the risk of exposing or operating on unrelated sensitive JSON data. No network calls or external endpoints are present.
Install Mechanism
No install spec (instruction-only with a bundled script). Nothing is downloaded or written by an installer. The script itself is a local file and is executed directly; low installation risk.
Credentials
No required environment variables, no credentials, and no config paths declared. The script only needs a path to a JSON knowledge base and an items JSON payload — these are proportionate to the stated functionality. However, because the KB path is unrestricted, the opportunity to read arbitrary JSON files should be considered.
Persistence & Privilege
Skill is not always-enabled and does not request elevated/persistent privileges. It does not modify other skills or system configuration. Autonomous invocation is allowed by default (normal), but this combined with the unconstrained KB path is why caution is warranted.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install promotion-engine - After installation, invoke the skill by name or use
/promotion-engine - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
first release
Metadata
Frequently Asked Questions
What is Promotion Engine?
Retail promotion calculator and discount lookup for digital employees. Computes final prices after applying discounts, bundles, thresholds, and membership ti... It is an AI Agent Skill for Claude Code / OpenClaw, with 110 downloads so far.
How do I install Promotion Engine?
Run "/install promotion-engine" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Promotion Engine free?
Yes, Promotion Engine is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Promotion Engine support?
Promotion Engine is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Promotion Engine?
It is built and maintained by fangwei-frank (@fangwei-frank); the current version is v1.0.0.
More Skills