mail-skill
v1.1.0Comprehensive email management skill. Use this skill when the user wants to fetch, search, read, send, reply to, move, delete, mark, or summarize emails. It...
⭐ 0· 102·0 current·0 all-time
by@lgwanai
MIT-0
Download zip
LicenseMIT-0 · Free to use, modify, and redistribute. No attribution required.
Security Scan
OpenClaw
Benign
medium confidencePurpose & Capability
Name/description (mail management: fetch, search, read, send, summarize) align with included code. The client, DB, and CLI implement IMAP/SMTP fetching/sending, local SQLite indexing, attachment storage, search, and summarization flows described in SKILL.md.
Instruction Scope
SKILL.md instructs the agent to load a .env with email credentials, run the provided CLI, fetch emails to local storage, and summarize results — all within the stated purpose. It also directs the agent to save raw EMLs, JSON, and attachments locally and to read those files for summarization. This is expected for a local mail manager but grants the agent access to potentially sensitive mailbox contents and attachments.
Install Mechanism
No install spec; code is delivered directly in the skill bundle and depends on common Python packages (imap-tools, python-dotenv, beautifulsoup4, jinja2) listed in requirements.txt. No remote downloads or obscure install hosts are used.
Credentials
The skill requires mailbox credentials, IMAP/SMTP host and port, and writes/reads local mail storage (example.env documents these), but registry metadata declares no required env vars or primary credential. That mismatch is security-relevant: installing agents should expect to provide email passwords/app-specific passwords and permit the skill to read/write the mail_data directory. The number and sensitivity of these credentials is proportional to the functionality (email access), but the absence of declared required env vars in registry metadata reduces transparency.
Persistence & Privilege
always is false; the skill runs on demand and uses background processes/tasks that write to a local tasks directory and per-account mail_data. It does not request permanent platform-wide privileges or modify other skills. Background task files and local DB are normal for this functionality.
Assessment
What to consider before installing and using this skill:
- Credentials: This skill needs your email address and password/app-specific password (IMAP/SMTP). Prefer creating and using an app-specific password or a dedicated mailbox account rather than your primary account. Do not paste credentials into a public place.
- Local storage: The skill saves full raw emails (.eml), JSON, and attachments under mail_data (per-account directories). Ensure you are comfortable with those files residing on disk, and that the agent process has only the filesystem/network access you intend.
- Registry metadata mismatch: The registry entry shows no required env vars, but the code and example.env clearly expect MAIL_ACCOUNT_* settings. Treat this as a transparency problem — the skill will read .env or environment variables to obtain credentials.
- Agent permissions: The agent (or platform) may be able to read saved attachments and email text and could transmit them if given network/file permissions. Limit the agent's outbound/network permissions and consider running the skill in an isolated environment if you are concerned.
- Code review: The provided Python code appears to use only IMAP/SMTP and local I/O (no external webhooks or remote upload). If you have the capability, review or run the code in a sandboxed environment first to confirm behavior. Pay attention to any logging or debug prints that might leak info.
- Operational hygiene: Rotate credentials if you stop using the skill, restrict mailbox settings (enable app passwords, disable less-secure access), and securely delete mail_data when needed.
If you need higher assurance, ask the skill publisher to update registry metadata to declare required env vars and clearly document storage paths, or run the skill against a throwaway mailbox first.Like a lobster shell, security has layers — review code before you run it.
latestvk973mha6farkc1m6312ekd1rrh83c5ev
License
MIT-0
Free to use, modify, and redistribute. No attribution required.
