Weekly Monthly Reporter

SKILL.md

# SKILL.md - Weekly-Monthly Reporter

> Transform raw work content into professional weekly/monthly reports using AI.

**Slug:** weekly-monthly-reporter

## Tiered Features

| Feature | FREE | PRO |
|---------|:----:|:---:|
| Text input | ✅ | ✅ |
| File upload (TXT/MD) | ❌ | ✅ |
| Markdown output | ✅ | ✅ |
| Word (.docx) output | ❌ | ✅ |
| PDF output | ❌ | ✅ |
| Custom templates | ❌ | ✅ |
| Report history | ❌ | ✅ |
| Monthly generations | 5 | Unlimited |
| History retention | — | 12 months |

## Pricing

**Per-call:** $0.01 USDT per report generation

No monthly subscription. Pay only for what you use.

## Usage

### CLI

```bash
# Generate a weekly report
python -m scripts.main generate --content "Completed project A phase 1..." -k YOUR_API_KEY

# Generate from file
python -m scripts.main generate --file worklog.md -k YOUR_API_KEY

# Monthly report
python -m scripts.main generate --type monthly -c "Work content..." -k YOUR_API_KEY

# Output to Word
python -m scripts.main generate -c "Content..." -k KEY --format word --output report.docx

# View history
python -m scripts.main history -k YOUR_API_KEY

# Check status
python -m scripts.main status -k YOUR_API_KEY
```

### Python API

```python
from scripts.report_generator import ReportGenerator
from scripts.templates import ReportType, ReportStyle

generator = ReportGenerator(api_key="your_llm_key")
result = generator.generate_report(
    work_content="Completed A project phase 1...",
    report_type=ReportType.WEEKLY,
    style=ReportStyle.CONCISE,
    api_key="your_billing_key"
)
print(result["report"])
```

## Report Styles

- **Concise**: Quick summary for rapid updates
- **Detailed**: Comprehensive with KPI, improvements, growth sections
- **Leadership**: Executive-focused with risk analysis and metrics
- **Self-Review**: Self-assessment with achievements and areas for improvement

## Required Environment Variables

```bash
SKILL_BILLING_API_KEY   # Your SkillPay Builder API Key
SKILL_BILLING_SKILL_ID  # Skill slug: weekly-monthly-reporter
```

Set these in your runtime environment. Without them, the tool runs in Dev Mode (FREE tier, no billing).

## Billing

This skill uses **SkillPay** (skillpay.me) for per-call billing at **$0.01 USDT per report**.

- Your Feishu User ID (Open ID) is transmitted to `skillpay.me` exclusively for billing purposes
- No other data is transmitted to third parties
- Billing occurs at the start of each report generation (after API key validation)
- Dev Mode (`SKILL_BILLING_API_KEY` not set): FULL FREE USAGE — no API key required, no billing

## Security Notes

- **LLM Execution**: All AI report generation runs via LLM API you configure (OpenAI-compatible)
- **Data Isolation**: Report history is stored locally in `/tmp/weekly-monthly-reporter/` — no data leaves your environment
- **SQL Safety**: Not applicable (no database queries in this skill)
- **Path Isolation**: All writes go to `/tmp/` — no home directory access

## Dependencies

```
requests>=2.28.0
python-docx>=0.8.11    # Word output
reportlab>=4.0.0        # PDF output
```