← Back to Skills Marketplace
163
Downloads
0
Stars
0
Active Installs
6
Versions
Install in OpenClaw
/install ptengine-heatmap-analyze
Description
Ptengine Heatmap end-to-end analysis skill. Fetches real heatmap data via the user-installed `ptengine-cli` tool and runs AI-powered CRO behavior analysis us...
Usage Guidance
This skill appears coherent and does what it says: it calls a user-installed ptengine-cli to fetch heatmap data and runs analysis logic that lives in the SKILL.md and reference docs. Before installing or enabling the skill: 1) Verify you install ptengine-cli from the official upstream repo/releases and review that tool's behavior (it is the component that holds and uses your API key). 2) Understand the skill will check for ~/.config/ptengine-cli/config.yaml existence and look for an "api_key:" entry — it states it won't parse or transmit the key but will read the file to decide whether configuration is needed. 3) Be aware the agent will run ptengine-cli as a subprocess and will process/interpret the CLI's JSON output; sensitive data could appear in that output depending on the CLI and your account/data — review sample responses from the CLI if you need to audit data flow. 4) If you are cautious about autonomous agents invoking tools, consider limiting autonomous invocation or requiring explicit user consent when this skill runs. 5) If you need higher assurance, audit the ptengine-cli source code or run it in an environment where you control network access and credentials.
Capability Analysis
Type: OpenClaw Skill
Name: ptengine-heatmap-analyze
Version: 1.0.5
The skill bundle is designed for professional Conversion Rate Optimization (CRO) analysis using Ptengine heatmap data. It demonstrates high transparency by explicitly disclosing its reliance on an external tool (ptengine-cli) and refusing to auto-install it, instead directing the user to the official GitHub repository. The skill delegates credential handling to the external CLI and includes strict 'Data Source Boundary' instructions in SKILL.md to prevent the AI from using unauthorized browser tools or scrapers. The extensive reference files (e.g., data-transform.md, quality-constraints.md) focus entirely on data processing, page classification, and maintaining high-quality, localized report outputs without any evidence of malicious intent, data exfiltration, or prompt injection.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description, required resources, and runtime behavior align: the skill's goal is to analyze Ptengine heatmap data and it does so by invoking an external ptengine-cli. It does not request unrelated environment variables, system-wide access, or additional binaries.
Instruction Scope
Runtime instructions restrict data sources to ptengine-cli and forbid scraping the target URL or contacting other endpoints. The only filesystem touch described is checking ~/.config/ptengine-cli/config.yaml for an "api_key:" presence to decide whether to prompt setup — this is consistent with needing to know whether ptengine-cli is configured but does involve reading the config file (the SKILL.md explicitly states it will not parse or transmit the key).
Install Mechanism
Instruction-only skill (no install spec, no bundled installer). This is the lowest-risk install model; the skill relies on the user to install ptengine-cli from the upstream repository.
Credentials
The skill itself declares no required env vars or credentials. Authentication is explicitly delegated to ptengine-cli (config file or PTENGINE_API_KEY). That delegation is proportionate to the stated function. Note: the skill checking for the config file and the string "api_key:" is a minimal credential-related file access and should be expected given the dependency.
Persistence & Privilege
Skill is not always-enabled and requests no elevated persistence. It does not claim to modify other skills or system-wide settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install ptengine-heatmap-analyze - After installation, invoke the skill by name or use
/ptengine-heatmap-analyze - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.5
ptengine-heatmap-analyze v1.0.5 — Minor update with enhanced transparency on dependencies and boundaries.
- Clarified external requirements: user must install and configure `ptengine-cli` themselves.
- Added explicit documentation of all resources accessed (executables, config files, environment variables), including who reads/writes each.
- Strengthened statements about data source boundaries and never scraping target URLs or handling credentials directly.
- No core analysis pipeline or workflow logic is changed in this version.
v1.0.4
- Removed the bundled install script (`install.sh`). Users must now install `ptengine-cli` themselves, following instructions in the official repository.
- Updated Phase 0 (Prerequisites): Clearly directs users to https://github.com/Kocoro-lab/ptengine-cli for installation.
- No installer is shipped or run on the user's behalf; users have full control over installing and updating the CLI tool.
- All other workflow and analysis functionality remains unchanged.
v1.0.3
Initial release of ptengine-heatmap-analyze v1.0.0
- Provides end-to-end Ptengine heatmap data analysis using ptengine-cli and a CRO methodology.
- Fetches all analytics data from ptengine-cli only; strictly avoids live page scraping.
- Supports single page, segment comparison, A/B test, ad performance, and audience analysis.
- Transforms and parses metrics according to documented reference rules for accurate behavioral insights.
- Fully self-contained: includes methodology, field mapping, analysis phases, error handling, and output schema references.
v1.0.2
- No code or content changes detected in this version.
- Version incremented to 1.0.2 with no file modifications.
- Behavior and workflow remain unchanged from the previous release.
v1.0.1
v1.0.1 Changelog
- Added a strict data source boundary: heatmap analysis is now limited to data returned by ptengine-cli only.
- Explicitly disallow any form of live page retrieval (browser automation, scraping, etc) for block content or structure; user input is required if ptengine-cli’s block content is missing.
- Updated reasoning for data source isolation, emphasizing the risk of misleading analysis when mixing historical and live page content.
- No code or functional workflow changes beyond documentation and process clarification.
v1.0.0
heatmap-analyze 1.0.0
- Initial release of the Ptengine Heatmap end-to-end analysis skill.
- Provides automated heatmap data fetching via ptengine-cli and AI-driven CRO behavior analysis using a 4-stage psychology model.
- Supports single-page, segment comparison, A/B test validation, ad channel, and audience analysis workflows.
- Fully self-contained with reference guides for data transformation, page classification, analysis pipeline, and output schema.
- Designed to trigger on a wide range of page analytics and behavioral insight requests.
Metadata
Frequently Asked Questions
What is Ptengine Heatmap Analyze?
Ptengine Heatmap end-to-end analysis skill. Fetches real heatmap data via the user-installed `ptengine-cli` tool and runs AI-powered CRO behavior analysis us... It is an AI Agent Skill for Claude Code / OpenClaw, with 163 downloads so far.
How do I install Ptengine Heatmap Analyze?
Run "/install ptengine-heatmap-analyze" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Ptengine Heatmap Analyze free?
Yes, Ptengine Heatmap Analyze is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Ptengine Heatmap Analyze support?
Ptengine Heatmap Analyze is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Ptengine Heatmap Analyze?
It is built and maintained by zhaichen (@zhaichen); the current version is v1.0.5.
More Skills