← Back to Skills Marketplace
83
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install nex-reports
Description
Automated report generation and scheduling meta-skill that aggregates data from multiple Nex tools into unified, actionable business briefings for day-to-day...
Usage Guidance
This package is largely coherent with its stated purpose, but proceed cautiously:
- Inspect setup.sh before running it (it will be executed by the Quick Start and can modify your user environment).
- Treat IMAP_PASS and TELEGRAM_TOKEN as sensitive — use app-specific passwords where possible and store them securely (not in public shells or logs).
- The CUSTOM module executes arbitrary shell commands from report configs; avoid adding untrusted commands and consider running this tool under a dedicated user with limited permissions or in a sandbox if you plan to use CUSTOM.
- Review the code (modules.py and setup.sh) locally to confirm there are no hidden network endpoints or unexpected behavior before installing on production systems.
If you want higher confidence, provide the contents of setup.sh and the remainder of modules.py (the CUSTOM/run_module implementation) so they can be reviewed specifically for shell invocation semantics (shell=True, command interpolation) or unexpected network calls.
Capability Analysis
Type: OpenClaw Skill
Name: nex-reports
Version: 1.0.0
The nex-reports skill bundle is a reporting tool that aggregates data from various sources, including email and external CLI tools. It is classified as suspicious due to high-risk capabilities, most notably the 'CUSTOM' module in 'lib/modules.py' which executes arbitrary shell commands using 'subprocess.run(shell=True)'. The tool also manages sensitive credentials (IMAP passwords and Telegram tokens) and accesses email headers. While these features are aligned with the stated purpose of automated reporting, they provide a significant attack surface for command injection and credential exposure. No evidence of intentional malice or unauthorized data exfiltration was found.
Capability Tags
Capability Assessment
Purpose & Capability
Name/description align with required binaries and env vars: python3, IMAP_*, and TELEGRAM_* are appropriate for IMAP email checks and Telegram delivery. However the registry metadata labels this as 'instruction-only' (no install spec) while the package includes multiple code files and a setup.sh — that mismatch is an incoherence you should be aware of.
Instruction Scope
SKILL.md and code instruct the agent/CLI to read IMAP mail, parse local files (ICS, JSON taskboard), run other nex-* tools, format output, save to ~/.nex-reports/, and send via Telegram — all within the declared purpose. The SKILL.md also exposes a CUSTOM module that runs arbitrary shell commands as part of reports; this is a legitimate feature for a 'custom' module but it expands the agent's execution scope (it can execute user-provided commands) and should be used with caution.
Install Mechanism
Registry metadata claims no install spec (instruction-only), but the package contains a setup.sh and a CLI entry (nex-reports.py). The SKILL.md tells users to run 'bash setup.sh'. Because there's no formal install spec recorded, you should manually inspect setup.sh before running it; it may create files, install the CLI into user paths, or perform other system changes.
Credentials
Requested env vars (IMAP_HOST, IMAP_USER, IMAP_PASS, IMAP_PORT, TELEGRAM_TOKEN, TELEGRAM_CHAT_ID) are consistent with the EMAIL and Telegram features. These are sensitive credentials (IMAP password and Telegram bot token) and are proportionate to the feature set — but should be provided carefully and not to an untrusted environment. No unrelated secrets were requested.
Persistence & Privilege
The skill does not request always:true, does not require system-wide privileges, and stores data under the user's home directory (~/.nex-reports/) and an SQLite DB — this is typical for a CLI utility. It does not appear to modify other skills or global agent settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install nex-reports - After installation, invoke the skill by name or use
/nex-reports - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release
Metadata
Frequently Asked Questions
What is Nex Reports?
Automated report generation and scheduling meta-skill that aggregates data from multiple Nex tools into unified, actionable business briefings for day-to-day... It is an AI Agent Skill for Claude Code / OpenClaw, with 83 downloads so far.
How do I install Nex Reports?
Run "/install nex-reports" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Nex Reports free?
Yes, Nex Reports is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Nex Reports support?
Nex Reports is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Nex Reports?
It is built and maintained by Nex AI (@nexaiguy); the current version is v1.0.0.
More Skills