Report Beautifier

Convert Word, Excel, or PDF reports into polished presentations with advanced charts, scene detection, and multiple templates in PPTX, PDF, or PNG formats.

Security Scan

The skill's code and runtime instructions largely match its stated purpose (transforming documents into polished presentations) but there are metadata/installation inconsistencies and a third‑party billing call that you should review before use.

Purpose & Capability

The code (parsers, chart maker, PPT generator, API server, billing integration) aligns with the 'Report Beautifier' description. However the registry metadata claims no required environment variables while SKILL.md and scripts/billing.py expect SKILL_BILLING_API_KEY and SKILL_BILLING_SKILL_ID — a mismatch that can confuse deployers.

Instruction Scope

SKILL.md instructs how to call the Python API and references billing. The runtime code processes only user-supplied documents, temp-saves files, and deletes them after processing. There are no instructions to read arbitrary system files or harvest unrelated environment variables. The billing flow will transmit a user identifier to skillpay.me (document content is not sent).

Install Mechanism

There is no install spec in registry (instruction-only), but the bundle contains many Python modules and requirements.txt listing numerous third‑party packages. That mismatch means the runtime environment must be prepared manually; absence of an install step may surprise users and lead to missing dependencies at runtime.

Credentials

The only environment variables referenced in code are billing-related (SKILL_BILLING_API_KEY, SKILL_BILLING_SKILL_ID). These are proportionate to an on‑call billing integration. Two caveats: SKILL.md warns a Feishu User ID may be sent to the billing endpoint, and the registry metadata does not declare these env vars (inconsistency). Treat billing API keys as sensitive.

Persistence & Privilege

The skill does not request always:true and does not modify other skills or global agent settings. It can run an optional local Flask API server, but that is ordinary functionality and not privileged by default.

What to consider before installing

The skill appears to do what it says: parse documents, create charts, and generate PPT/PDF outputs. Before installing or running it: - Note an inconsistency: the registry metadata shows no required env vars, but SKILL.md and scripts/billing.py expect SKILL_BILLING_API_KEY and SKILL_BILLING_SKILL_ID. Verify how billing should be configured in your environment. - The skill will call https://skillpay.me to charge users and may transmit a user identifier (e.g., Feishu Open ID) for billing. If you don't trust that endpoint, leave SKILL_BILLING_API_KEY empty ('dev' mode) or do not enable paid features. - There is no declared installer: this bundle requires many Python packages (requirements.txt). Install dependencies in an isolated environment (venv/container) and review exact package versions before running. - Source/homepage is unknown. If you need higher assurance, review the included source files (provided) or run the code in a sandbox before giving it access to real data or production secrets. - Avoid providing production API keys or other sensitive credentials to the skill until you confirm the billing flow and trust the operator. If you plan to expose the bundled Flask API, firewall and authenticate it appropriately. If you want, I can list the exact files and network calls in the code or point out any specific lines that send data over the network.

Slug: report-beautifier

Upload Word / Excel / PDF reports → AI analyzes data structure and content → Outputs professional presentations (PPTX / PDF)

---

Billing

$0.01 USDT per call — billed via SkillPay at https://skillpay.me/report-beautifier

A small fee is charged each time you beautify a document. No monthly subscription required.

Privacy Note: Your Feishu User ID (Open ID) may be transmitted to skillpay.me for billing purposes only. Privacy Note: This skill does not store, log, or share any of your document content. All processing is ephemeral.

---

Required Environment Variables

Variable	Description
SKILL_BILLING_API_KEY	SkillPay API key for billing. Leave empty or set to dev for dev mode (balance=999).
SKILL_BILLING_SKILL_ID	Skill ID on SkillPay. Defaults to report-beautifier.

---

Tiered Features

Feature	FREE	PRO
Price	$0 (free)	$0.01 / call
Monthly uses	3	Unlimited
Input formats	Word	Word, Excel, PDF
Templates	1	All 15 templates
Output formats	PPTX preview	PPTX, PDF, PNG
Download	No	Yes
Charts	Basic	Advanced
Scene detection	No	Yes
Speech script	No	Yes

---

Quick Start

from scripts.beautifier import beautify_report

result = beautify_report(
    file_path="/path/to/report.xlsx",
    api_key="PRO-your-api-key",
    template="business_blue",
    output_format="pptx"
)

if result["success"]:
    print(f"Output: {result['output_path']}")
else:
    print(f"Error: {result['error']}")

---

Advanced Usage

from scripts.beautifier import ReportBeautifier, BeautifierConfig

config = BeautifierConfig(
    template_id="tech_purple",
    output_format="pptx",
    include_charts=True,
    quality="high"
)

beautifier = ReportBeautifier(api_key="PRO-your-key", config=config)
result = beautifier.beautify_file("/path/to/report.xlsx")
print(result)

---

Supported Formats

Format	Extensions	Notes
Word	.docx, .doc	Extracts titles, paragraphs, tables
Excel	.xlsx, .xls	Multi-sheet support, smart header detection
PDF	.pdf	Text extraction, simple table detection
CSV	.csv	Auto-parsing with header inference

---

Available Templates (15)

Business: business_blue, finance_gray, government_red
Education/Professional: teaching_green, tech_purple, ocean_blue
Vibrant: vibrant_orange, rose_pink, vibrant_purple
Minimal: minimal_white, night_dark, fresh_cyan
Premium: classic_gold, forest_green, deep_sea_blue

---

Output Formats

• PPTX — PowerPoint presentation (default)
• PDF — PDF document
• PNG — Single chart image

---

Scene Detection

Automatically detects report type and applies matching style:

• financial — Financial reports
• sales — Sales reports
• report — Work reports / presentations
• bidding — Bid proposals
• teaching — Teaching materials
• general — General documents

---

Error Handling

try:
    result = beautify_report(file_path, api_key)
    if not result["success"]:
        print(f"Failed: {result['error']}")
except Exception as e:
    print(f"System error: {e}")

---

Dependencies

python-docx>=1.1.0
openpyxl>=3.1.2
PyPDF2>=3.0.0
python-pptx>=1.0.1
matplotlib>=3.7.0
plotly>=5.18.0
requests>=2.31.0
Pillow>=10.0.0
kaleido>=0.2.1

---

For paid use, visit https://skillpay.me/report-beautifier