Nex Reports
by @nexaiguy
Automated report generation and scheduling meta-skill that aggregates data from multiple Nex tools into unified, actionable business briefings for day-to-day...
clawhub install nex-reportsπ About This Skill
name: 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 decision making. Create custom composite reports combining curated data from nex-healthcheck (infrastructure uptime and service health), nex-crm (sales pipeline status and hot prospects), nex-expenses (spending patterns and budget tracking), nex-deliverables (project progress and overdue items), nex-domains (domain expiry alerts and SSL certificate warnings), and nex-vault (contract expirations and renewal deadlines). Schedule reports to run fully automatically on recurring schedules (daily, weekly, monthly) using standard cron expressions and pre-built convenient presets (DAILY_MORNING at 8am, WEEKLY_MONDAY, WEEKLY_FRIDAY, MONTHLY_FIRST). Generate morning briefings for team standups, weekly summaries for stakeholder reviews, or monthly business reviews for strategic planning in multiple output formats (markdown for email with professional formatting, simple HTML, compact Telegram format with emojis, structured JSON for API integration). Route report delivery via Telegram for instant mobile notifications and team alerts or save generated reports to files for email distribution, client sharing, and documentation archives. Perfect for Belgian agency operators, business owners, and management teams who need daily or weekly snapshots of overall business health without manual data compilation overhead. version: 1.0.0 metadata: clawdbot: emoji: "π" requires: bins: - python3 env: - IMAP_HOST - IMAP_USER - IMAP_PASS - IMAP_PORT - TELEGRAM_TOKEN - TELEGRAM_CHAT_ID primaryEnv: "" homepage: https://nex-ai.be files: - "nex-reports.py" - "lib/*" - "setup.sh"
Nex Reports
Scheduled Report Generator - Create, schedule, and deliver automated reports combining data from multiple Nex tools.
When to Use
Use this skill when the user asks about:
Trigger phrases: "create a report", "morning briefing", "weekly summary", "schedule a report", "automated report", "report briefing", "compile data", "overzicht", "samenvatting", "dagrapport", "wekelijk rapport"
Quick Start
bash setup.sh
This creates the data directory, initializes the database, and checks for nex-* command availability.
Commands
Create a Report
nex-reports create "Monday Morning" \
--schedule "0 8 * * 1" \
--modules health,crm,deliverables,domains \
--output markdown \
--output-target file
Schedule presets: DAILY_MORNING, DAILY_EVENING, WEEKLY_MONDAY, WEEKLY_FRIDAY, MONTHLY_FIRST
Run a Report
nex-reports run "Monday Morning"
nex-reports run --all
Manage Configs
nex-reports list
nex-reports show "Monday Morning"
nex-reports edit "Monday Morning" --modules health,crm,expenses
nex-reports delete "Monday Morning"
View History
nex-reports history "Monday Morning" --limit 20
Test Modules
nex-reports modules
nex-reports test health
Available Modules
nex-healthcheck checknex-crm pipelinenex-expenses summary monthlynex-deliverables overduenex-domains expiringnex-vault alertsOutput Formats
Output Targets
Configuration
Set via environment variables:
export IMAP_HOST=imap.gmail.com
export IMAP_USER=your.email@gmail.com
export IMAP_PASS=your-app-password
export IMAP_PORT=993export TELEGRAM_TOKEN=your-bot-token
export TELEGRAM_CHAT_ID=your-chat-id
Data Directory
Reports and database stored in: ~/.nex-reports/
reports.db - SQLite databasereports/ - Generated report filestemplates/ - (Reserved for future use)Examples
Morning briefing combining health, CRM, and deliverables:
nex-reports create "Daily Standup" \
--schedule "0 9 * * 1-5" \
--modules health,crm,deliverables \
--output telegram \
--output-target telegram
Weekly summary to file (every Friday 5pm):
nex-reports create "Weekly Summary" \
--schedule WEEKLY_FRIDAY \
--modules health,crm,expenses,deliverables,domains,vault \
--output markdown \
--output-target file
Custom command in report:
nex-reports create "Git Status" \
--schedule "0 10 * * *" \
--modules custom \
--output markdown
View the last run:
nex-reports show "Daily Standup"
Scheduling
Reports are created with cron expressions. Use an external scheduler (systemd timer, crontab, etc.) to execute:
nex-reports run "Daily Standup"
on a schedule.
Nex Reports by Nex AI | nex-ai.be
β‘ When to Use
π‘ Examples
Morning briefing combining health, CRM, and deliverables:
nex-reports create "Daily Standup" \
--schedule "0 9 * * 1-5" \
--modules health,crm,deliverables \
--output telegram \
--output-target telegram
Weekly summary to file (every Friday 5pm):
nex-reports create "Weekly Summary" \
--schedule WEEKLY_FRIDAY \
--modules health,crm,expenses,deliverables,domains,vault \
--output markdown \
--output-target file
Custom command in report:
nex-reports create "Git Status" \
--schedule "0 10 * * *" \
--modules custom \
--output markdown
View the last run:
nex-reports show "Daily Standup"
βοΈ Configuration
Set via environment variables:
export IMAP_HOST=imap.gmail.com
export IMAP_USER=your.email@gmail.com
export IMAP_PASS=your-app-password
export IMAP_PORT=993export TELEGRAM_TOKEN=your-bot-token
export TELEGRAM_CHAT_ID=your-chat-id