← Back to Skills Marketplace
333
Downloads
0
Stars
1
Active Installs
6
Versions
Install in OpenClaw
/install personal-insight-engine
Description
Personal Insight Engine (PIE) - A strategic analysis tool that scans local session logs (memory/*.md) and extracts 3 strategic insights using LLMs.
Usage Guidance
This skill appears to do what it says (scan memory/*.md, redact content, call an LLM). Before installing or running it: 1) Review your memory/ files — the scanner will read files under OPENCLAW_WORKSPACE or fall back to ./memory, so run it in an empty/safe workspace or move sensitive files out first. 2) Check your .env — load_dotenv will load any local .env file; remove or sanitise secrets you don't want processed. 3) Understand redaction is heuristic: inspect the clean_content implementation and test with non-sensitive sample files to confirm it removes the patterns you care about. 4) Note the Gemini API key is sent in the request URL (key=...) which is normal for Google API keys but could appear in logs; if that concerns you prefer the Zhipu provider. 5) If you need strict workspace guarantees, update the scanner to refuse the ./memory fallback and explicitly require OPENCLAW_WORKSPACE. If you want to proceed, run the code locally after review and avoid running it in an environment containing high-value secrets until you are confident in its redaction.
Capability Analysis
Type: OpenClaw Skill
Name: personal-insight-engine
Version: 1.0.4
The personal-insight-engine skill is a legitimate tool designed to analyze local session logs using LLMs (Gemini or Zhipu AI). It features a robust privacy-hardening layer in scripts/analyzer.py that uses regex to redact API keys, credentials, emails, IP addresses, and local file paths before data is transmitted. The code logic in scripts/pie.py and scripts/scanner.py is transparent, follows the stated purpose, and lacks any indicators of malicious intent or unauthorized data exfiltration.
Capability Assessment
Purpose & Capability
The skill name and description match the code: it scans session logs in memory/ and calls an LLM to produce three insights. Declared runtime requirements (python3, httpx, python-dotenv) are consistent with the implementation. Minor mismatch: registry metadata lists both ZHIPU_API_KEY and GEMINI_API_KEY as 'required', while the code and SKILL.md only need at least one provider key (auto-detects whichever is present).
Instruction Scope
SKILL.md promises 'Only scans the memory/ folder within the official OPENCLAW_WORKSPACE', but scripts/scanner.py will fall back to ./memory if OPENCLAW_WORKSPACE doesn't exist. That contradicts the claimed strict workspace enforcement and can lead to scanning arbitrary local memory/ files. The tool also uses python-dotenv (load_dotenv) which will load a local .env and may surface additional environment variables/secrets into process memory — this is not declared in the registry metadata. The code performs heuristic redaction, but redaction is pattern-based and may miss secrets.
Install Mechanism
No remote install script or arbitrary downloads. Requirements are installed via pip (httpx, python-dotenv) as declared; there's no extract/download of third-party binaries. This is a low-risk install model for a local script, assuming you review the included code.
Credentials
The skill needs at least one LLM API key (Gemini or Zhipu) which aligns with its purpose. However: (1) registry metadata lists both keys as required (potentially misleading), (2) the code uses OPENCLAW_WORKSPACE (not declared as required) to locate files, and (3) load_dotenv may load additional secrets from a .env file. Those omissions make the environment requirements slightly under-specified.
Persistence & Privilege
The skill does not request always:true, does not modify system or other-skill configs, and does not write persistent agent-wide settings. It only reads files and environment variables at runtime.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install personal-insight-engine - After installation, invoke the skill by name or use
/personal-insight-engine - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.4
Consistency: Unified env-var fallback logic in code and docs. Feature: Added --provider flag to pie.py to allow manual override.
v1.0.3
Security: Hardened redaction (IPs, user-paths). Architecture: Switched to standardized OPENCLAW_WORKSPACE pathing. Cleanup: Added requirements.txt and clarified env-var fallback logic.
v1.0.2
Hardened Privacy: Implemented multi-stage PII redaction (Emails/Keys/Tokens). Improved Metadata: Fixed dependency declarations and API key requirements in docs.
v1.0.1
Privacy: Added regex-based PII redaction (keys/tokens). Robustness: Implemented Zhipu/GLM fallback and fixed metadata naming inconsistencies.
v1.2.0
v1.2.0: Optimized for business strategy insights with multi-language (CN/EN) support and strategic keyword scanning.
v1.0.0
- Initial release of the Personal Insight Engine (PIE) for strategic analysis.
- Scans recent memory logs and extracts 3 core insights: Decision Patterns, Pain Points, and Pivots.
- Supports customizable review periods (default 7 days; configurable via CLI).
- Requires Python 3, with support for ZHIPU or Gemini API keys.
- Outputs a concise Markdown report summarizing findings.
Metadata
Frequently Asked Questions
What is Personal Insight Engine?
Personal Insight Engine (PIE) - A strategic analysis tool that scans local session logs (memory/*.md) and extracts 3 strategic insights using LLMs. It is an AI Agent Skill for Claude Code / OpenClaw, with 333 downloads so far.
How do I install Personal Insight Engine?
Run "/install personal-insight-engine" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Personal Insight Engine free?
Yes, Personal Insight Engine is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Personal Insight Engine support?
Personal Insight Engine is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Personal Insight Engine?
It is built and maintained by xiaofei (@franklu0819-lang); the current version is v1.0.4.
More Skills