agentleFS
xcrrrxcrrr/claude-skills/skills/files/xlsx/SKILL.md

xlsx

Skill6 starsChanged 8 months agoMITView on GitHub

Use this skill when designing Excel or Google Sheets workbooks with formulas, named ranges, pivot tables, charts, and data validation, or when creating financial models, trackers, and dashboards in spreadsheet format. Not for database design or SQL queries. Not for generating CSV files without workbook structure.

194 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use Video Generation, VLM and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • huang-x-hSkill

    Video Generation

    Implement AI-powered video generation capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to generate videos from text prompts or images, create video content programmatically, or build applications that produce video outputs. Supports asynchronous task management with status polling and result retrieval.

    Also in 6 projects that use this

  • huang-x-hSkill

    VLM

    Implement vision-based AI chat capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to analyze images, describe visual content, or create applications that combine image understanding with conversational AI. Supports image URLs and base64 encoded images for multimodal interactions.

    Also in 6 projects that use this

  • dav-niu474Skill

    gift-evaluator

    The PRIMARY tool for Spring Festival gift analysis and social interaction generation. Use this skill when users upload photos of gifts (alcohol, tea, supplements, etc.) to inquire about their value, authenticity, or how to respond socially. Integrates visual perception, market valuation, and HTML card generation.

    Also in 5 projects that use this

  • dav-niu474Skill

    Podcast Generate

    Generate podcast episodes from user-provided content or by searching the web for specified topics. If user uploads a text file/article, creates a dual-host dialogue podcast (or single-host upon request). If no content is provided, searches the web for information about the user-specified topic and generates a podcast. Duration scales with content size (3-20 minutes, ~240 chars/min). Uses z-ai-web-dev-sdk for LLM script generation and TTS audio synthesis. Outputs both a podcast script (Markdown) and a complete audio file (WAV).

    Also in 5 projects that use this

  • Liang-MHSkill

    stock_analysis

    获取 A 股、基金和港股的实时行情和技术分析数据

    Also in 5 projects that use this

  • SeifBenayedSkill

    file-reading

    Use this skill when a file has been uploaded but its content is NOT in your context — only its path at /mnt/user-data/uploads/ is listed in an uploaded_files block. This skill is a router: it tells you which tool to use for each file type (pdf, docx, xlsx, csv, json, images, archives, ebooks) so you read the right amount the right way instead of blindly running cat on a binary. Triggers: any mention of /mnt/user-data/uploads/, an uploaded_files section, a file_path tag, or a user asking about an uploaded file you have not yet read. Do NOT use this skill if the file content is already visible in your context inside a documents block — you already have it.

    Also in 5 projects that use this

  • +1 more from huang-x-h
  • +5 more from dav-niu474

The file

We split this skill into the rules it gives an agent

12 rules. 0 are common, 7 are distinctive, and 5 are very specific to this project.

  • 0

    Common

    Most of the 188 edited versions we read keep these.

  • 7

    Distinctive

    This author's own choices. Worth a look.

  • 5

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    README / Instructions sheet: Document the workbook purpose, how to use it, input cells, and assumptions.

    line 46
  2. Very specific:

    Inputs / Assumptions sheet: All user-modifiable inputs in one place.

    line 47
  3. Distinctive:

    Add an input message (tooltip) and an error alert message for each validation.

    line 63
  4. Distinctive:

    Never hard-code values in formula cells — all constants belong in named cells on the Inputs sheet

    line 228
  5. Distinctive:

    Use Excel Tables (Ctrl+T) for all data ranges — they auto-expand and work with structured references

    line 229
  6. Distinctive:

    Keep one concept per column — never store two data points in one cell (e.g., "100 units - estimate")

    line 231
  7. Distinctive:

    Test formulas at boundary conditions: empty cells, zero values, negative values, future dates

    line 232
  8. Distinctive:

    Document complex formulas with a comment in the adjacent cell explaining what it calculates

    line 233
  9. Very specific:

    Use IFERROR to handle divide-by-zero and missing lookups gracefully rather than showing #N/A

    line 234
  10. Distinctive:

    Not protecting formula cells — users accidentally overwrite calculated cells with typed values

    line 240
  11. Very specific:

    Use Ctrl+[ to jump to a formula's precedent cells — follow the formula chain

    line 247
  12. Very specific:

    Use Power Query (Get & Transform) to pull and transform data from external sources without VBA

    line 251

“Common” is measured: kept by at least 6 in 10 of the 188 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

XLSX

Overview

This skill covers the design and implementation of Excel-compatible workbooks (.xlsx) and Google Sheets for professional use. It addresses workbook architecture (sheet organization, tab naming, data vs. calculation vs. presentation layers), formula design (lookup formulas, array formulas, dynamic arrays), named ranges for readable and maintainable formulas, pivot tables for summarization, charts for visualization, data validation for input integrity, and conditional formatting for visual cues. Outputs are either complete spreadsheet designs with formula specifications or Python code using openpyxl or xlsxwriter for programmatic workbook generation.

When to Use

  • Designing a financial model (budget, forecast, P&L, cash flow) in spreadsheet format
  • Building a data tracker with validation, dropdowns, and summary dashboards
  • Creating a reporting workbook that automatically calculates KPIs from raw data input
  • Designing a pivot table structure for multi-dimensional data summarization
  • Specifying formulas and structure for a workbook someone else will build in Excel
  • Generating Excel workbooks programmatically from application data using Python
  • Auditing or improving an existing spreadsheet's formula logic and structure

When NOT to Use

  • Replacing a proper relational database for data with more than ~100,000 rows
  • Building real-time dashboards that require live database connectivity (use BI tools like Tableau or Power BI)
  • Designing data pipelines or ETL processes (use data engineering tools)
  • Creating presentations (use pptx skill)
  • Generating PDF reports (use pdf or docx skills)

Quick Reference

TaskApproach
Look up a value from a tableXLOOKUP(lookup_value, lookup_range, return_range) or INDEX/MATCH
Sum with conditionsSUMIFS(sum_range, criteria_range1, criteria1, ...)
Count with conditionsCOUNTIFS(range1, criteria1, range2, criteria2, ...)
Dynamic subtotalsSUBTOTAL(9, range) — respects filters; 9 = SUM
Protect formula cellsLock formula cells; protect sheet; leave input cells unlocked
Create a dropdown listData Validation → List → specify source range or comma-separated values
Name a rangeFormulas → Name Manager → New; use in formulas as =SUM(Revenue)
Pivot table refreshRight-click pivot → Refresh; or VBA ThisWorkbook.RefreshAll

Instructions

  1. Design the workbook architecture — Separate concerns across sheets:
    • README / Instructions sheet: Document the workbook purpose, how to use it, input cells, and assumptions.
    • Inputs / Assumptions sheet: All user-modifiable inputs in one place. Color-code input cells (e.g., blue font or yellow fill).
    • Data / Raw Data sheet(s): Source data that feeds calculations. Formatted as structured Tables (Ctrl+T).
    • Calculations / Model sheet(s): Formulas and intermediate calculations. No hard-coded values — all reference the Inputs sheet.
    • Dashboard / Summary sheet: Charts, KPIs, and formatted output for stakeholders. No formulas — only links to calculation sheets.
  2. Define named ranges — Name every important range or cell: input assumptions (e.g., Discount_Rate, Headcount_2025), summary outputs, and frequently-referenced lookup tables. Named ranges make formulas readable: =Revenue * Gross_Margin_Rate is clearer than =B12 * Assumptions!C5.
  3. Build lookup structures — Use structured Tables (Ctrl+T) for all data ranges. Table references (Table1[Column]) update automatically when rows are added, unlike fixed ranges. For lookups, prefer XLOOKUP over VLOOKUP — it supports left-lookups, exact/approximate match, and a default-if-not-found value.
  4. Design the formula layer — Write formulas that are: (a) readable — use named ranges and intermediate cells rather than nesting 5 functions deep; (b) auditable — one calculation step per cell; (c) consistent — the same formula across a row or column, not one-off adjustments; (d) error-handled — wrap in IFERROR or IFNA where appropriate.
  5. Add data validation — Apply data validation to all input cells to prevent invalid entries:
    • Numeric inputs: whole number or decimal with min/max bounds
    • Category inputs: dropdown list from a named range or fixed list
    • Date inputs: date validation with reasonable min/max
    • Text inputs: text length validation where appropriate Add an input message (tooltip) and an error alert message for each validation.
  6. Build pivot tables for summarization — Place the source data in a structured Table. Insert pivot tables on a separate sheet. Design the pivot layout: rows (grouping dimensions), columns (time or category), values (sum/count/average), and filters (slicers for interactive filtering). Add a slicer for the most important filter dimension.
  7. Design charts — For each chart: specify the chart type and why (column for comparison, line for trends, combo for dual-axis), identify the data series, write the chart title as an insight statement (not a description), add data labels on the key series, remove chart junk (gridlines unless needed, legend if only one series, border). Keep the color palette consistent with the workbook theme.
  8. Apply conditional formatting — Use sparingly for maximum impact: traffic light colors (red/yellow/green) for KPI status, data bars for magnitude visualization in tables, color scales for heatmaps, and icon sets for directional indicators. Always define the rules explicitly so they are reproducible.
  9. Protect the workbook — Lock all formula cells (Format Cells → Protection → Locked). Leave input cells unlocked. Protect the sheet (Review → Protect Sheet) with a password if needed. Consider also hiding rows/columns used for intermediate calculations that users shouldn't modify.
  10. Document assumptions and version — Add a README sheet with: workbook purpose, owner, last updated date, version number, list of input cells and their descriptions, list of outputs and how to interpret them, and known limitations. Add a version history table at the bottom of the README.

Examples

Example 1: Monthly Expense Tracker Workbook

Input: A small team needs a personal/team monthly expense tracker with categories, budget vs. actual comparison, and a summary dashboard.

Output:

Workbook structure:

Sheet 1: README
  - Purpose, how to use, input cells highlighted
  - Version: 1.0 | Owner: Finance Team | Updated: 2025-01

Sheet 2: Budgets (Inputs)
  Named ranges: Budget_Jan, Budget_Feb, ... Budget_Dec (or annual budget split by month)
  Table structure:
    | Category | Annual Budget | Jan Budget | Feb Budget | ... | Dec Budget |
    | Salaries | $120,000      | $10,000    | $10,000    | ... | $10,000    |
    | Software  | $24,000      | $2,000     | $2,000     | ... | $2,000     |
    | Travel    | $12,000      | $0         | $500       | ... | $2,000     |
  Input validation: Numeric, min $0
  Note: Only the Budgets sheet should be editable by most users

Sheet 3: Transactions (Data)
  Formatted as Excel Table "Transactions"
  Columns: Date | Description | Category | Amount | Approved By | Notes
  Category column: Dropdown validation from Budget category list
  Amount: Positive number validation; no negatives (use separate refund row)

Sheet 4: Monthly Summary (Calculations)
  SUMIFS formula for actuals by category by month:
    =SUMIFS(Transactions[Amount], Transactions[Category], [@Category],
            Transactions[Date], ">="&DATE(Year, Month, 1),
            Transactions[Date], "<"&DATE(Year, Month+1, 1))
  
  Variance formula: =Budget_Amount - Actual_Amount
  Variance %: =IF(Budget_Amount=0, "N/A", Variance/Budget_Amount)
  Status: =IF(Variance_Pct < -0.1, "Over Budget", IF(Variance_Pct < 0, "Watch", "On Track"))
  Conditional formatting: Status cell — red/yellow/green based on text value

Sheet 5: Dashboard
  KPI Cards (top row):
    Total Budget YTD | Actual Spend YTD | Remaining Budget | % Budget Used
  
  Chart 1: Stacked bar chart — Budget vs Actual by Category (current month)
  Chart 2: Line chart — Cumulative spend vs cumulative budget over the year
  Chart 3: Donut chart — Spend by category as % of total
  Slicer: Month selector (updates all charts)

Key formulas:

-- Actual spend for a category in a specific month --
=SUMIFS(
    Transactions[Amount],
    Transactions[Category], B5,
    Transactions[Date], ">="&DATE($B$2, $C$2, 1),
    Transactions[Date], "<"&EOMONTH(DATE($B$2, $C$2, 1), 0)+1
)

-- Budget utilization status (with color via conditional formatting) --
=IF(D5/C5 > 1, "OVER", IF(D5/C5 > 0.9, "WATCH", "OK"))

-- Year-to-date actual spend (all months through current) --
=SUMIFS(
    Transactions[Amount],
    Transactions[Date], ">="&DATE(YEAR(TODAY()), 1, 1),
    Transactions[Date], "<="&TODAY()
)

Example 2: Sales Pipeline Spreadsheet with Dashboard

Input: A sales team needs a pipeline tracker that shows deals by stage, weighted pipeline value, forecast by month, and rep performance.

Output:

Workbook structure and formulas:

Sheet 1: Deals (Data — Excel Table "Pipeline")
  Columns and validation:
    Deal ID        | Auto-increment (=MAX(Pipeline[Deal_ID])+1 for new row)
    Company        | Text, required
    Deal Owner     | Dropdown: named range "SalesReps" from Config sheet
    Stage          | Dropdown: Prospect / Qualified / Proposal / Negotiation / Closed Won / Closed Lost
    Deal Value ($) | Number, min $0
    Close Date     | Date, must be >= TODAY()
    Probability (%)| Auto-fill from Stage using XLOOKUP:
                     =XLOOKUP([@Stage], Config!A:A, Config!B:B, "")
    Weighted Value  | =[@[Deal Value]]*[@[Probability]]
    Days in Stage   | =TODAY()-[@[Stage Entry Date]]
    Notes          | Text

Sheet 2: Config (Inputs — locked except admin)
  Stage Probabilities:
    | Stage        | Probability | Target Days in Stage |
    | Prospect     | 10%         | 14                   |
    | Qualified    | 25%         | 21                   |
    | Proposal     | 50%         | 14                   |
    | Negotiation  | 75%         | 10                   |
    | Closed Won   | 100%        | —                    |
    | Closed Lost  | 0%          | —                    |
  Named range: SalesReps (list of rep names)
  Named range: Stages (list of stage names for validation)

Sheet 3: Forecast (Calculations)
  Monthly forecast by rep:
    =SUMPRODUCT(
        (Pipeline[Deal_Owner]=A3) *
        (MONTH(Pipeline[Close_Date])=B2) *
        (YEAR(Pipeline[Close_Date])=YEAR(TODAY())) *
        Pipeline[Weighted_Value]
    )
  
  Stage funnel (count by stage):
    =COUNTIFS(Pipeline[Stage], "Qualified", Pipeline[Deal_Owner], $A3)

Sheet 4: Rep Scorecards (Calculations)
  Per-rep metrics:
    | Rep Name | Open Pipeline | Wtd Pipeline | Deals Won MTD | Win Rate | Avg Deal Size |
  
  Win Rate: =COUNTIFS(Pipeline[Deal_Owner], A3, Pipeline[Stage], "Closed Won") /
              MAX(1, COUNTIFS(Pipeline[Deal_Owner], A3, Pipeline[Stage], "Closed Won") +
                     COUNTIFS(Pipeline[Deal_Owner], A3, Pipeline[Stage], "Closed Lost"))

Sheet 5: Dashboard
  Slicers: Month, Deal Owner, Stage
  
  Chart 1: Funnel chart — deals count and value by stage
  Chart 2: Bar chart — weighted pipeline by rep (sorted descending)
  Chart 3: Line chart — monthly forecast vs. monthly quota
  Chart 4: Horizontal bar — days in stage by deal (aging heatmap — highlight if > target)
  
  KPI Cards:
    Total Open Pipeline: =SUMIFS(Pipeline[Deal Value], Pipeline[Stage], "<>Closed Won", Pipeline[Stage], "<>Closed Lost")
    Weighted Pipeline: =SUMIFS(Pipeline[Weighted Value], ...)
    Deals Closing This Month: =COUNTIFS(...)
    Forecast vs. Quota: =[Forecast MTD] / [Quota MTD]

Conditional formatting rules:

Days in Stage column:
  Green: <= target days for stage
  Yellow: target days < days <= 2× target
  Red: > 2× target days (deal is stalled)

Win Rate cell:
  Green: >= 30%
  Yellow: 20–30%
  Red: < 20%

Best Practices

  • Never hard-code values in formula cells — all constants belong in named cells on the Inputs sheet
  • Use Excel Tables (Ctrl+T) for all data ranges — they auto-expand and work with structured references
  • Color-code consistently: blue/yellow = user input, white = calculated, gray = locked/reference
  • Keep one concept per column — never store two data points in one cell (e.g., "100 units - estimate")
  • Test formulas at boundary conditions: empty cells, zero values, negative values, future dates
  • Document complex formulas with a comment in the adjacent cell explaining what it calculates
  • Use IFERROR to handle divide-by-zero and missing lookups gracefully rather than showing #N/A

Common Mistakes

  • Using VLOOKUP with a fixed column index — it breaks if columns are inserted; use XLOOKUP or INDEX/MATCH
  • Circular references — often caused by accidentally referencing a cell in its own formula; use iterative calc only when intentional
  • Mixing data and formatting in the same cells (e.g., writing "$1,200 est." — store 1200 and format the cell)
  • Not protecting formula cells — users accidentally overwrite calculated cells with typed values
  • Using merged cells in data tables — they break sorting, filtering, and SUMIFS functions
  • Forgetting to refresh pivot tables after updating source data — add a refresh button with a simple macro
  • Building massive all-in-one sheets instead of separating inputs, calculations, and outputs into layers

Tips & Tricks

  • Press Ctrl+~ to toggle between formula view and value view — great for auditing
  • Use Ctrl+[ to jump to a formula's precedent cells — follow the formula chain
  • LAMBDA function lets you define reusable custom functions in Excel without VBA
  • LET function stores intermediate calculations in named variables within a single formula
  • For programmatic generation, openpyxl handles formulas and styles; xlsxwriter is faster for large datasets
  • Use Power Query (Get & Transform) to pull and transform data from external sources without VBA
  • Name your Excel Tables descriptively (Pipeline, Budgets, not Table1, Table2) — structured references become self-documenting

Related Skills

  • docx
  • pdf

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.