Usage instructions
Skills Overview
openclaw-reportstudio-community is a practical skill focused on converting local data files into business report generation. It parses the user's natural language needs and securely converts local CSV/XLSX data files into professional deliverables in XLSX, PDF and PPTX formats, which is especially suitable for business analysis, weekly and monthly reports, and other scenarios.
Core usage
The workflow of this skill is divided into four stages: first, parse the user's natural language instructions, extract file path, analysis dimensions, time granularity (day/week/month), TopN disassembly and other parameters; then throughsubprocesssafe callreportstudio.cli.mainThe module processes source files in a read-only manner; strictly follows conservative principles during the generation process, and only outputs quantitative conclusions supported by data. In the case of insufficient history, a clear warning will be issued rather than forced calculation of month-on-month and year-on-year calculations; finally, a JSON structure containing product paths, data tables, meta-information and warnings will be returned, and a human-speaking summary will be provided to facilitate user acceptance.
Significant advantages
safe and conservative:Clearly declare "read only, do not change source files, and do not default to the external network". All data processing is completed locally, and there is no risk of uploading sensitive information.Delivery in multiple formats: A single execution can generate editable XLSX, PDF suitable for printing and sharing, and PPTX for presentation to meet the needs of different scenarios.Intelligent analysis: Support daily/weekly/monthly granular trend analysis, automatically dismantle TopN dimensions, and transform raw data into readable business insights.Anti-hallucination design: It has a built-in conservative principle and refuses to fabricate causal relationships. It will provide clear warnings for missing data or failed field identification to avoid misleading conclusions.
potential limitations
Source credibility: The author is a personal account (T3 level). Although the code has passed the security audit, long-term maintenance stability needs to be observed.Dependency management: Core functions depend on externalreportstudioPython package, users need to ensure that the source of the package is trustworthy and the version is compatible.Path verification: The current implementation of the traversal verification of the input file path is not strict enough, and there is a theoretical risk of path traversal.functional boundaries: The community version only supports read-only operations and cannot write to the database or modify source files. It is not suitable for scenarios that require data writeback.
Suitable for groups
This skill is especially suitable for those who need to frequently produce data reporting materialsbusiness analyst、financial managersandOperations team, able to quickly transform raw data tables into professional reports that can be submitted directly to management. For those who value data privacy and want to avoid cloud transmissionInternal users of the enterprise, and those that need to generate standardized weekly and monthly report templatesproject managerThe same applies.
Risks of use
Input validation risks: Although there is no command injection vulnerability, users are advised to ensure--fileThe parameters point to files within the expected range to avoid misreading sensitive system files.Depend on security risks: Need to ensurereportstudioThe package comes from a trusted source and it is recommended to install it in a virtual environment and verify the hash.Data quality depends on: Output quality is highly dependent on the format specification of the input CSV/XLSX, and field identification failures or incorrect data types may result in warnings or empty tables.Performance considerations: Processing large files may consume more memory and computing resources. It is recommended to reserve sufficient resources in the local environment.
Safety review
Core usage
openclaw-reportstudio-communityIt is a natural language wrapper for the ReportStudio Community. Its core capability is to convert local CSV/XLSX data files into static business reports that can be directly delivered. Users only need to describe their needs in natural language (such as "generate monthly report", "top 10 product analysis", "make PPT report materials") and provide the file path, and Skill can automatically parse the intention and execute the report generation process.
The workflow is divided into four steps: ① Parse the user's natural language extraction parameters (file path, time granularity, disassembly dimensions/indicators, TopN number, etc.); ② Call local through subprocessreportstudio.cli.mainModule execution report generation; ③ Return JSON output including product path, data table, meta information and warnings; ④ Summarize the deliverable status to the user in one sentence.
The supported output format is a three-piece set of XLSX + PDF + PPTX by default, the time granularity is optional day/week/month, and any dimension column can be specified for TopN disassembly. The Community Edition is expressly limited toread-only mode: Do not write to the database, do not modify the source file, and do not connect to the external network by default.
Significant advantages
- Zero Illusion Promise: Strictly generate conclusions based on data provided by users, do not fabricate cause and effect, and proactively prompt warnings when there is insufficient history rather than hard calculation of year-on-year and month-on-month comparisons.
- Multiple formats delivered in one delivery: A single call can simultaneously produce three formats: Excel (can be edited twice), PDF (formal archive), and PPT (report presentation).
- Natural language threshold is low: Users do not need to learn SQL or reporting tools, just describe their needs in "human words"
- Clear security boundaries: Pure local processing, no external API calls, no hard-coding of sensitive information, simple code structure (only 4 files/212 lines)
- Trusted source: The maintainer is GitHub organization openclaw, and static scanning has obtained an S-level (95 points) security rating.
Potential Disadvantages and Limitations
- Depends on pre-installed environment: Must be installed in advance
reportstudioPython module, otherwise it will not run - Big data truncation: Data exceeding 6,000 rows will be automatically truncated and a warning will be generated. Very large data sets require preprocessing.
- subprocess calling method: The current version calls local modules through subprocess.run. Although the risk is controllable, it is not an optimal implementation (it is recommended that future versions directly import)
- Community edition features are limited: Read-only mode means that advanced functions such as interactive drilling and real-time data connection cannot be performed
- Automatic inference of dimensions/metrics: If the user does not specify it, the first column dimension and first column value will be taken by default. Complex schema may not be inferred as expected.
Suitable for the crowd
- Need to quickly convert raw data into reporting materialsBusiness analysts, operations personnel, financial specialists
- Those who pursue "data speaking" and hate the illusion of AIconservative data user
- Those who have no technical background but need to produce weekly/monthly reports regularlymanagers and assistants
- Sensitive to data security and requirementsLocalized offline processingcorporate environment
General risks
|Risk point|illustrate|Mitigation measures|
|--------|------|----------|
|Input file path injection|User-supplied paths may be maliciously constructed|Skill internally uses argparse for parsing, and no command injection vulnerability has been found; users are advised to ensure that the path is trustworthy.|
|Sensitive file reading|System files may be accessed through soft links, etc.|Use in a controlled environment and avoid running with root privileges|
|Output directory override|Default `./artifacts` may be accidentally overwritten|Check the directory write permission and specify an independent output path for important scenarios|
|Missing dependencies|The reportstudio module is not installed, causing the call to fail.|Perform `pip install reportstudio` verification before use|
Overall, this is aSafe and conservative, clear goals, suitable for standardized reporting scenariosData tools are particularly suitable for workflows that pursue "acceptable deliverables" rather than "exploratory analysis".
data-analyticsdocsofficeproductivityfinance-accountingautomationchart
Copyright and takedown notice: AI Islands curates this page from public information. Skills, code, documents and packages remain the property of their original authors or rights holders. This listing is provided for indexing, research and installation convenience. If you believe any listing or download link infringes your rights, contact ai-islands@streamflowintel.com with proof of ownership, relevant URLs and your request. We will review and remove or adjust the content promptly. Review package permissions, dependencies and safety risks before installing.