ai-xlsx

ai-xlsx XLSX Analysis Assistant

Quick Start

More Skills

Overview

The XLSX Analysis Assistant is used to answer "where are the key points in the spreadsheet," document processing, material review, summaries, and is suitable for operations, product, marketing, and technical users to invoke after clarifying business goals, content materials, or analysis targets. It combines inputs such as spreadsheet data or CSV, pasteable tables, CSV, field descriptions, formula snippets, metric definitions, or data excerpts, organizes key context, and outputs summaries, diagnostic conclusions, action recommendations, and reusable deliverables for continued execution, review, or delivery.

When to Use

Applicable Scenarios

• The user asks questions such as "where are the key points in the spreadsheet," and needs to quickly break down goals, determine priorities, and form actionable results
• Operations, product, marketing, and technical users need to generate summaries, diagnostic conclusions, action recommendations, and reusable deliverables around the XLSX Analysis Assistant
• The user has already prepared the analysis goal (for example, data health check, business review, budget check, list cleaning, metric explanation, anomaly troubleshooting, or report delivery.), report audience (indicating who will view this spreadsheet review result, for example, business lead, finance, operations, sales, data team, or client.), public spreadsheet link (enter a spreadsheet link that can be accessed without logging in; for permission-protected spreadsheets, upload or paste data instead.), and wants to organize it into actionable analysis or optimization results
• The user needs to turn XLSX Analysis Assistant-related materials into clear conclusions, priorities, and next steps

Invocation Method

Call the AI Skills API directly through the exported Python runner:

Command Examples

Basic Invocation

python3 scripts/run.py --params '{}'

Invocation with Common Parameters

python3 scripts/run.py --params '{"goal":"分析目标"}'

Parameter Description

Parameter	Type	Required	Default	Description
goal	string	No	-	For example, data health check, business review, budget check, list cleaning, metric explanation, anomaly troubleshooting, or report delivery
audience	string	No	-	Indicate who will view this spreadsheet review result, for example, business lead, finance, operations, sales, data team, or client
materialUrl	string	No	-	Enter a spreadsheet link that can be accessed without logging in; for permission-protected spreadsheets, upload or paste data instead; a complete accessible URL is required
materialFile	string	No	-	Upload xlsx/xls/csv/tsv files that need to be reviewed, checked, analyzed, or used to generate a brief
materialText	string	No	-	Pasteable tables, CSV, field descriptions, formula snippets, metric definitions, or data excerpts
brandRequirements	string	No	-	Supplement metric definitions, display formats, unit rules, fields that must be retained, privacy masking, and external narrative restrictions

See the complete machine-readable parameter structure at references/form-schema.json。

Parameter Value Reference

This skill currently has no categorical parameters that require additional lookup.

Supported Input Formats

This skill directly accepts JSON parameters; if the parameters contain link fields, pass a complete, accessible URL.

Example request

The example parameters below can be passed directly to scripts/run.py, and the runner will send them to the AI Skills API.

python3 scripts/run.py --params '{"goal":"分析目标"}'

Equivalent --params JSON：

{
  "goal": "分析目标"
}

Example response

{
  "success": true,
  "data": {
    "message": "示例结果请以技能真实返回结构为准。"
  },
  "meta": {
    "executionTime": 842,
    "cached": false
  }
}

Deliverables

• Summary, diagnostic conclusions, action recommendations, and reusable deliverables: core results organized around the user's goals that can be read, reviewed, or delivered directly.
• Interpretation of input materials: combined with the analysis goal (for example, data health check, business review, budget check, list cleaning, metric explanation, anomaly troubleshooting, or report delivery.), report audience (explain who will review this spreadsheet's review results, for example, business leaders, finance, operations, sales, data teams, or clients.), public spreadsheet link (enter a spreadsheet link accessible without login; for permission-protected spreadsheets, please upload or paste the data instead.) to extract key context and basis for judgment.
• Next steps: provide priorities, execution suggestions, or a content framework that can be further developed.

Suggestions for using the results

• First determine whether the output answers the user's core question about the "XLSX Analysis Assistant".
• Then check whether the results cover the summary, diagnostic conclusions, action recommendations, and reusable deliverables, and whether clear next steps are provided.
• If the input materials are limited, it is recommended to have the user supplement the goals, audience, constraints, or source materials before running.

Preparation before running

• AISKILLS_BASE_URL: default https://ai-skills.ai
• AISKILLS_API_KEY: required, used for authenticated calls
• AISKILLS_TENANT_ID: default default