[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M76A7NAXP2G3EAYZHWPCWP6V":3,"skill-same:01M76A7NAXP2G3EAYZHWPCWP6V":72},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":15,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":37,"commitSha":38,"skillDirectory":39,"forksCount":13,"repositoryHtmlUrl":40,"repositoryHomepageUrl":6,"ownerHtmlUrl":41,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":42,"install":43,"resources":56},"01M76A7NAXP2G3EAYZHWPCWP6V","excel-workflow",null,"Complete Excel workflow with local file processing, Google Drive sync, and formula preservation.\nProcess Excel files (.xlsx), track changes in SQLite, sync with Google Drive, and preserve formulas during updates.\nUse this skill when users want to upload Excel files, query data, update cells while preserving formulas, or sync with Google Drive.","meghal86\u002Fstacksignal","meghal86","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F37388715?v=4","01M6CS2EW8SK89GH52R2ZEN8QQ","01M728J5CGY456EETEFG6HJBTM",0,"MIT","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fexcel-workflow\u002Fexcel-workflow-skill-package\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fexcel-workflow\u002Fexcel-workflow-skill-package\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: excel-workflow\ndescription: |\n  Complete Excel workflow with local file processing, Google Drive sync, and formula preservation.\n  Process Excel files (.xlsx), track changes in SQLite, sync with Google Drive, and preserve formulas during updates.\n  Use this skill when users want to upload Excel files, query data, update cells while preserving formulas, or sync with Google Drive.\ncompatibility: Requires Python 3.8+, openpyxl, rclone, and Google Drive OAuth setup\nmetadata:\n  author: alexey\n  version: \"1.0.0\"\n  openclaw:\n    emoji: 🔄\n    requires:\n      bins:\n        - rclone\n        - python3\n      env:\n        - OPENCLAW_EXCEL_PATH\n---\n\n# Excel Workflow\n\nComplete workflow for Excel file management with local processing, Google Drive backup, formula preservation, and SQLite tracking.\n\n## Features\n\n- ✅ **Formula Preservation** — Update cells without losing formulas (powered by openpyxl)\n- ✅ **Google Drive Sync** — Automatic backup to Google Drive using rclone\n- ✅ **SQLite Tracking** — Track all files, formulas, and metadata in local database\n- ✅ **Multi-file Support** — Work with multiple Excel files simultaneously\n- ✅ **Data Analysis** — Query data, read formulas, and analyze structure\n- ✅ **Mass Operations** — Create formulas for entire columns at once\n\n## Quick Start\n\n### 1. Upload Excel File\n\nSimply drop an `.xlsx` file into the chat. The workflow automatically:\n1. Analyzes file structure (sheets, formulas)\n2. Uploads to Google Drive (`gdrive:Excel\u002F`)\n3. Saves metadata to SQLite tracker\n\n```bash\n# Manual processing\n~\u002F.openclaw\u002Ftools\u002Fopenclaw-excel\u002Fexcel-workflow process \u002Fpath\u002Fto\u002Ffile.xlsx\n```\n\n### 2. Query Data\n\n```bash\n# Ask questions about your data\n~\u002F.openclaw\u002Ftools\u002Fopenclaw-excel\u002Fexcel-workflow query \"what is total revenue?\" --file sales.xlsx\n```\n\n### 3. Update Cells (Formulas Preserved!)\n\n```bash\n# Update values - formulas stay intact\n~\u002F.openclaw\u002Ftools\u002Fopenclaw-excel\u002Fexcel-workflow update '{\"C2\": 100}' --file sales.xlsx\n\n# Update formulas\n~\u002F.openclaw\u002Ftools\u002Fopenclaw-excel\u002Fexcel-workflow update '{\"D2\": \"=B2*C2*1.5\"}' --file sales.xlsx\n```\n\n## Installation\n\n### Prerequisites\n\n1. **Python 3.8+** with openpyxl\n2. **rclone** for Google Drive integration\n3. **Google Drive** account\n\n### Step 1: Install Dependencies\n\n```bash\n# Install rclone (macOS)\nbrew install rclone\n\n# Python packages (installed in venv automatically)\npip install openpyxl\n```\n\n### Step 2: Setup Google Drive\n\n```bash\n# Configure rclone with Google Drive\nrclone config\n```\n\nFollow prompts:\n- Name: `gdrive`\n- Storage: `drive` (Google Drive)\n- Scope: `1` (Full access)\n- Auto config: `y` (opens browser for OAuth)\n\nVerify:\n```bash\nrclone lsd gdrive:\n```\n\n### Step 3: Create Excel Folder\n\n```bash\nrclone mkdir gdrive:Excel\u002F\n```\n\n### Step 4: Install Skill Files\n\nThe skill consists of 3 components:\n\n1. **Excel CLI** (`~\u002F.openclaw\u002Ftools\u002Fopenclaw-excel\u002Fexcel`)\n   - Commands: `info`, `read`, `update`, `show-formulas`, `get-cell`\n\n2. **Tracker CLI** (`~\u002F.openclaw\u002Ftools\u002Fopenclaw-excel\u002Fexcel-tracker`)\n   - SQLite database at `~\u002F.openclaw\u002Fexcel_tracker.db`\n   - Commands: `add`, `get-latest`, `search`, `list`, `stats`\n\n3. **Workflow Orchestrator** (`~\u002F.openclaw\u002Ftools\u002Fopenclaw-excel\u002Fexcel-workflow`)\n   - Commands: `process`, `query`, `update`, `list`, `stats`\n\nSee [Installation Guide](https:\u002F\u002Fgithub.com\u002Fyour-repo\u002Fexcel-workflow) for detailed setup.\n\n## Commands\n\n### Process Command\n\nAnalyze file, upload to Drive, and save to tracker:\n\n```bash\nexcel-workflow process \u002Fpath\u002Fto\u002Ffile.xlsx [--telegram-id ID]\n```\n\n**Output:**\n```json\n{\n  \"status\": \"success\",\n  \"filename\": \"sales.xlsx\",\n  \"file_id\": 1,\n  \"drive_url\": \"gdrive:Excel\u002Fsales.xlsx\",\n  \"analysis\": {\n    \"sheets\": 2,\n    \"formulas\": 15,\n    \"sheet_names\": [\"Sales\", \"Summary\"]\n  },\n  \"message\": \"✅ File processed successfully!\"\n}\n```\n\n### Query Command\n\nRead data and answer questions:\n\n```bash\nexcel-workflow query \"show me the data\" [--file filename.xlsx]\n```\n\n**Output:**\n```json\n{\n  \"filename\": \"sales.xlsx\",\n  \"file_id\": 1,\n  \"sheets\": [\"Sales\", \"Summary\"],\n  \"data\": [\n    [\n      {\"address\": \"A1\", \"value\": \"Product\", \"type\": \"str\"},\n      {\"address\": \"B1\", \"value\": \"Price\", \"type\": \"int\"}\n    ]\n  ],\n  \"formulas\": [\n    {\"cell\": \"D2\", \"formula\": \"=B2*C2\"}\n  ],\n  \"question\": \"show me the data\",\n  \"context\": {\n    \"sheet_count\": 2,\n    \"formula_count\": 15,\n    \"uploaded_at\": \"2026-02-20 10:30:00\"\n  }\n}\n```\n\n### Update Command\n\nUpdate cells (values or formulas):\n\n```bash\n# Update values\nexcel-workflow update '{\"C2\": 100, \"C3\": 200}' [--file filename.xlsx]\n\n# Update formulas\nexcel-workflow update '{\"D2\": \"=B2*C2*1.5\"}' --file sales.xlsx\n\n# Mass update - create formulas for entire column\nexcel-workflow update '{\"D2\": \"=B2*0.5\", \"D3\": \"=B3*0.5\", ...}' --file data.xlsx\n```\n\n**Output:**\n```json\n{\n  \"status\": \"success\",\n  \"filename\": \"sales.xlsx\",\n  \"updated\": 2,\n  \"changes\": [\n    {\"cell\": \"C2\", \"old_value\": 50, \"new_value\": 100},\n    {\"cell\": \"C3\", \"old_value\": 75, \"new_value\": 200}\n  ],\n  \"message\": \"✅ Updated and re-uploaded to Google Drive\"\n}\n```\n\n### List Command\n\nShow tracked files:\n\n```bash\nexcel-workflow list [--limit 10]\n```\n\n**Output:**\n```json\n[\n  {\n    \"id\": 2,\n    \"original_filename\": \"sales_2026.xlsx\",\n    \"sheet_count\": 2,\n    \"formula_count\": 15,\n    \"uploaded_at\": \"2026-02-20 14:20:00\"\n  },\n  {\n    \"id\": 1,\n    \"original_filename\": \"budget.xlsx\",\n    \"sheet_count\": 3,\n    \"formula_count\": 42,\n    \"uploaded_at\": \"2026-02-19 09:15:30\"\n  }\n]\n```\n\n### Stats Command\n\nShow statistics:\n\n```bash\nexcel-workflow stats\n```\n\n**Output:**\n```json\n{\n  \"total_files\": 5,\n  \"files_on_drive\": 5,\n  \"total_sheets\": 12,\n  \"total_formulas\": 87\n}\n```\n\n## Usage Patterns for AI Agents\n\n### Pattern 1: User Uploads Excel File\n\n**User action:** Uploads `sales.xlsx` via Telegram\n\n**Agent workflow:**\n1. File saved to temporary location by Telegram handler\n2. Detect `.xlsx` extension\n3. Run: `excel-workflow process \u002Fpath\u002Fto\u002Fsales.xlsx --telegram-id \u003Cid>`\n4. Parse JSON result and respond:\n\n```\nAgent: \"✅ I've received and processed sales.xlsx!\n\n📊 Analysis:\n- 2 sheets: Sales, Summary\n- 15 formulas detected\n- ☁️ Uploaded to Google Drive\n\nWhat would you like to know about this file?\"\n```\n\n### Pattern 2: User Asks Question\n\n**User:** \"What's the total revenue in my sales file?\"\n\n**Agent workflow:**\n1. Run: `excel-workflow query \"what is total revenue?\" --file sales.xlsx`\n2. Receive data with all rows and formulas\n3. Analyze the data to find revenue-related columns and totals\n4. Respond with answer:\n\n```\nAgent: \"Looking at your sales.xlsx file:\n\nTotal Revenue: 650,000 руб\n\nBreakdown:\n- iPhone: 150,000 (3 × 50,000)\n- MacBook: 200,000 (2 × 100,000)\n- iPad: 300,000 (5 × 60,000)\n\nThe file has a SUM formula in cell D5 that calculates this automatically.\"\n```\n\n### Pattern 3: User Requests Update\n\n**User:** \"Change iPhone quantity to 20\"\n\n**Agent workflow:**\n1. Query to understand structure: `excel-workflow query \"find iPhone row\"`\n2. Identify that iPhone is in row 2, quantity in column C\n3. Run: `excel-workflow update '{\"C2\": 20}' --file sales.xlsx`\n4. Confirm update:\n\n```\nAgent: \"✅ Updated sales.xlsx:\n\nChanged C2 (iPhone quantity): 3 → 20\n\nNew revenue for iPhone: 1,000,000 руб (was 150,000)\nTotal revenue updated automatically thanks to formulas!\n\nFile has been re-uploaded to Google Drive.\"\n```\n\n### Pattern 4: Mass Formula Creation\n\n**User:** \"Create a column that multiplies price by 0.5 for all products\"\n\n**Agent workflow:**\n1. Read file to determine row count\n2. Generate update JSON with formulas for each row\n3. Run: `excel-workflow update '{\"D2\": \"=B2*0.5\", \"D3\": \"=B3*0.5\", ...}' --file prices.xlsx`\n4. Confirm:\n\n```\nAgent: \"✅ Created formulas for 50 rows!\n\nColumn D now contains =B*0.5 formula for all products.\nFile updated on Google Drive.\"\n```\n\n## Technical Details\n\n### Components\n\n1. **Excel CLI** — openpyxl-based tool for reading\u002Fwriting Excel files\n   - Preserves formulas using `data_only=False`\n   - Commands: `read`, `update`, `info`, `show-formulas`, `get-cell`\n\n2. **Tracker** — SQLite database for file metadata\n   - Location: `~\u002F.openclaw\u002Fexcel_tracker.db`\n   - Tracks: filename, sheets, formulas, paths, timestamps\n\n3. **Workflow Orchestrator** — Integrates Excel CLI, rclone, and tracker\n   - Orchestrates: analyze → upload → track → update cycle\n   - Progress messages to stderr, JSON results to stdout\n\n### File Locations\n\n- **Tracker database:** `~\u002F.openclaw\u002Fexcel_tracker.db`\n- **Google Drive folder:** `gdrive:Excel\u002F`\n- **Local files:** User-specified paths (Telegram downloads to `~\u002F.openclaw\u002Fmedia\u002F`)\n\n### Formula Preservation\n\n**How it works:**\n- openpyxl loads workbooks with `data_only=False`\n- Formulas stored as text strings (e.g., `\"=B2*C2\"`)\n- When updating cell with formula string, openpyxl preserves it\n- Excel recalculates formulas when file is opened\n\n**Example:**\n```python\n# This preserves formulas\nws['D2'] = '=B2*C2'  # Formula remains\nws['B2'] = 100       # Data changes, formula in D2 recalculates\n```\n\n### What's Preserved vs Not Preserved\n\n**✅ Preserved:**\n- Formulas (=SUM, =IF, =B2*C2, etc.)\n- Data (numbers, text, dates)\n- Structure (sheets, tables)\n- Formatting (colors, fonts, borders, bold)\n- Charts (diagrams update automatically)\n\n**⚠️ May Not Work:**\n- Conditional formatting (complex rules)\n- Macros (.xlsm files not supported)\n- Pivot tables (may break)\n- Slicers and advanced filters\n\n## Error Handling\n\n**Common errors:**\n\n1. **File not found**\n   ```json\n   {\"error\": \"File not found: \u002Fpath\u002Fto\u002Ffile.xlsx\"}\n   ```\n\n2. **Google Drive not configured**\n   ```json\n   {\"error\": \"rclone remote 'gdrive' not configured\"}\n   ```\n   Solution: Run `rclone config`\n\n3. **Formula syntax error**\n   ```json\n   {\"error\": \"Invalid formula: =B2*\"}\n   ```\n   Solution: Check formula syntax\n\n4. **Database locked**\n   ```json\n   {\"error\": \"Database is locked\"}\n   ```\n   Solution: Wait and retry\n\n## Examples\n\n### Example 1: Financial Data Analysis\n\n```bash\n# Upload stock data\nexcel-workflow process ~\u002FDesktop\u002FARKK.xlsx\n\n# Query\nexcel-workflow query \"show last 10 rows\" --file ARKK.xlsx\n\n# Add calculated column (50% of price)\n# First, find row count, then generate formulas\nexcel-workflow update '{\"C2\": \"=B2*0.5\", \"C3\": \"=B3*0.5\", ...}' --file ARKK.xlsx\n```\n\n### Example 2: Price List Update\n\n```bash\n# Process price list\nexcel-workflow process prices.xlsx\n\n# Update prices\nexcel-workflow update '{\"B10\": 99.99, \"B11\": 149.99}' --file prices.xlsx\n\n# Add tax column\nexcel-workflow update '{\"D2\": \"=B2*1.2\"}' --file prices.xlsx\n```\n\n### Example 3: Multiple Files\n\n```bash\n# Upload multiple files\nexcel-workflow process january.xlsx\nexcel-workflow process february.xlsx\n\n# List all files\nexcel-workflow list\n\n# Query specific file\nexcel-workflow query \"total sales\" --file january.xlsx\n\n# Stats\nexcel-workflow stats\n```\n\n## Troubleshooting\n\n### Issue: \"rclone not found\"\n\n```bash\n# Install rclone\nbrew install rclone  # macOS\nsudo apt install rclone  # Linux\n```\n\n### Issue: \"openpyxl not installed\"\n\n```bash\n# Install in virtual environment\ncd ~\u002F.openclaw\u002Ftools\u002Fopenclaw-excel\npython3 -m venv venv\n.\u002Fvenv\u002Fbin\u002Fpip install openpyxl\n```\n\n### Issue: \"Google Drive permission denied\"\n\n```bash\n# Reconfigure rclone\nrclone config\n# Delete old gdrive remote and create new one\n```\n\n### Issue: \"Formulas become values\"\n\n**This should NOT happen!** If it does:\n1. Check that `excel` CLI uses `data_only=False` when loading workbook\n2. Ensure formula strings start with `=`\n3. Verify openpyxl version: `pip show openpyxl` (should be 3.1.0+)\n\n## Best Practices\n\n### For Users\n\n1. **Name files descriptively**\n   - Good: `sales_2026_Q1.xlsx`\n   - Bad: `Book1.xlsx`\n\n2. **Ask specific questions**\n   - Good: \"What's the total revenue in January?\"\n   - Bad: \"Tell me about the file\"\n\n3. **Keep file structure consistent**\n   - Makes it easier for AI to understand\n\n### For Developers\n\n1. **Always check file existence** before processing\n2. **Use sessions** for multiple operations on same file\n3. **Handle errors gracefully** with try\u002Fexcept\n4. **Show progress** in stderr, results in stdout\n5. **Validate formulas** before updating cells\n\n## API Reference\n\nSee [Excel CLI Documentation](.\u002Fexcel_cli.md) and [Tracker Documentation](.\u002Ftracker.md) for detailed API reference.\n\n## Resources\n\n- [openpyxl Documentation](https:\u002F\u002Fopenpyxl.readthedocs.io\u002F)\n- [rclone Documentation](https:\u002F\u002Frclone.org\u002Fdocs\u002F)\n- [Microsoft Excel File Format](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fopenspecs\u002Foffice_standards\u002Fms-xlsx\u002F)\n- [Google Drive with rclone](https:\u002F\u002Frclone.org\u002Fdrive\u002F)\n\n## Support\n\n- GitHub Issues: [your-repo\u002Fexcel-workflow\u002Fissues]\n- Documentation: [your-repo\u002Fexcel-workflow\u002Fdocs]\n- Community: [OpenClaw Community]\n\n## License\n\nMIT License - see LICENSE.txt\n\n## Changelog\n\n### Version 1.0.0 (2026-02-20)\n\n- Initial release\n- Formula preservation with openpyxl\n- Google Drive sync via rclone\n- SQLite tracking\n- Multi-file support\n- Mass formula operations\n- AI agent integration patterns\n","# Excel Workflow\n\nComplete workflow for Excel file management with local processing, Google Drive backup, formula preservation, and SQLite tracking.\n\n## Features\n\n- ✅ **Formula Preservation** — Update cells without losing formulas (powered by openpyxl)\n- ✅ **Google Drive Sync** — Automatic backup to Google Drive using rclone\n- ✅ **SQLite Tracking** — Track all files, formulas, and metadata in local database\n- ✅ **Multi-file Support** — Work with multiple Excel files simultaneously\n- ✅ **Data Analysis** — Query data, read formulas, and analyze structure\n- ✅ **Mass Operations** — Create formulas for entire columns at once\n\n## Quick Start\n\n### 1. Upload Excel File\n\nSimply drop an `.xlsx` file into the chat. The workflow automatically:\n1. Analyzes file structure (sheets, formulas)\n2. Uploads to Google Drive (`gdrive:Excel\u002F`)\n3. Saves metadata to SQLite tracker\n\n```bash\n# Manual processing\n~\u002F.openclaw\u002Ftools\u002Fopenclaw-excel\u002Fexcel-workflow process \u002Fpath\u002Fto\u002Ffile.xlsx\n```\n\n### 2. Query Data\n\n```bash\n# Ask questions about your data\n~\u002F.openclaw\u002Ftools\u002Fopenclaw-excel\u002Fexcel-workflow query \"what is total revenue?\" --file sales.xlsx\n```\n\n### 3. Update Cells (Formulas Preserved!)\n\n```bash\n# Update values - formulas stay intact\n~\u002F.openclaw\u002Ftools\u002Fopenclaw-excel\u002Fexcel-workflow update '{\"C2\": 100}' --file sales.xlsx\n\n# Update formulas\n~\u002F.openclaw\u002Ftools\u002Fopenclaw-excel\u002Fexcel-workflow update '{\"D2\": \"=B2*C2*1.5\"}' --file sales.xlsx\n```\n\n## Installation\n\n### Prerequisites\n\n1. **Python 3.8+** with openpyxl\n2. **rclone** for Google Drive integration\n3. **Google Drive** account\n\n### Step 1: Install Dependencies\n\n```bash\n# Install rclone (macOS)\nbrew install rclone\n\n# Python packages (installed in venv automatically)\npip install openpyxl\n```\n\n### Step 2: Setup Google Drive\n\n```bash\n# Configure rclone with Google Drive\nrclone config\n```\n\nFollow prompts:\n- Name: `gdrive`\n- Storage: `drive` (Google Drive)\n- Scope: `1` (Full access)\n- Auto config: `y` (opens browser for OAuth)\n\nVerify:\n```bash\nrclone lsd gdrive:\n```\n\n### Step 3: Create Excel Folder\n\n```bash\nrclone mkdir gdrive:Excel\u002F\n```\n\n### Step 4: Install Skill Files\n\nThe skill consists of 3 components:\n\n1. **Excel CLI** (`~\u002F.openclaw\u002Ftools\u002Fopenclaw-excel\u002Fexcel`)\n   - Commands: `info`, `read`, `update`, `show-formulas`, `get-cell`\n\n2. **Tracker CLI** (`~\u002F.openclaw\u002Ftools\u002Fopenclaw-excel\u002Fexcel-tracker`)\n   - SQLite database at `~\u002F.openclaw\u002Fexcel_tracker.db`\n   - Commands: `add`, `get-latest`, `search`, `list`, `stats`\n\n3. **Workflow Orchestrator** (`~\u002F.openclaw\u002Ftools\u002Fopenclaw-excel\u002Fexcel-workflow`)\n   - Commands: `process`, `query`, `update`, `list`, `stats`\n\nSee [Installation Guide](https:\u002F\u002Fgithub.com\u002Fyour-repo\u002Fexcel-workflow) for detailed setup.\n\n## Commands\n\n### Process Command\n\nAnalyze file, upload to Drive, and save to tracker:\n\n```bash\nexcel-workflow process \u002Fpath\u002Fto\u002Ffile.xlsx [--telegram-id ID]\n```\n\n**Output:**\n```json\n{\n  \"status\": \"success\",\n  \"filename\": \"sales.xlsx\",\n  \"file_id\": 1,\n  \"drive_url\": \"gdrive:Excel\u002Fsales.xlsx\",\n  \"analysis\": {\n    \"sheets\": 2,\n    \"formulas\": 15,\n    \"sheet_names\": [\"Sales\", \"Summary\"]\n  },\n  \"message\": \"✅ File processed successfully!\"\n}\n```\n\n### Query Command\n\nRead data and answer questions:\n\n```bash\nexcel-workflow query \"show me the data\" [--file filename.xlsx]\n```\n\n**Output:**\n```json\n{\n  \"filename\": \"sales.xlsx\",\n  \"file_id\": 1,\n  \"sheets\": [\"Sales\", \"Summary\"],\n  \"data\": [\n    [\n      {\"address\": \"A1\", \"value\": \"Product\", \"type\": \"str\"},\n      {\"address\": \"B1\", \"value\": \"Price\", \"type\": \"int\"}\n    ]\n  ],\n  \"formulas\": [\n    {\"cell\": \"D2\", \"formula\": \"=B2*C2\"}\n  ],\n  \"question\": \"show me the data\",\n  \"context\": {\n    \"sheet_count\": 2,\n    \"formula_count\": 15,\n    \"uploaded_at\": \"2026-02-20 10:30:00\"\n  }\n}\n```\n\n### Update Command\n\nUpdate cells (values or formulas):\n\n```bash\n# Update values\nexcel-workflow update '{\"C2\": 100, \"C3\": 200}' [--file filename.xlsx]\n\n# Update formulas\nexcel-workflow update '{\"D2\": \"=B2*C2*1.5\"}' --file sales.xlsx\n\n# Mass update - create formulas for entire column\nexcel-workflow update '{\"D2\": \"=B2*0.5\", \"D3\": \"=B3*0.5\", ...}' --file data.xlsx\n```\n\n**Output:**\n```json\n{\n  \"status\": \"success\",\n  \"filename\": \"sales.xlsx\",\n  \"updated\": 2,\n  \"changes\": [\n    {\"cell\": \"C2\", \"old_value\": 50, \"new_value\": 100},\n    {\"cell\": \"C3\", \"old_value\": 75, \"new_value\": 200}\n  ],\n  \"message\": \"✅ Updated and re-uploaded to Google Drive\"\n}\n```\n\n### List Command\n\nShow tracked files:\n\n```bash\nexcel-workflow list [--limit 10]\n```\n\n**Output:**\n```json\n[\n  {\n    \"id\": 2,\n    \"original_filename\": \"sales_2026.xlsx\",\n    \"sheet_count\": 2,\n    \"formula_count\": 15,\n    \"uploaded_at\": \"2026-02-20 14:20:00\"\n  },\n  {\n    \"id\": 1,\n    \"original_filename\": \"budget.xlsx\",\n    \"sheet_count\": 3,\n    \"formula_count\": 42,\n    \"uploaded_at\": \"2026-02-19 09:15:30\"\n  }\n]\n```\n\n### Stats Command\n\nShow statistics:\n\n```bash\nexcel-workflow stats\n```\n\n**Output:**\n```json\n{\n  \"total_files\": 5,\n  \"files_on_drive\": 5,\n  \"total_sheets\": 12,\n  \"total_formulas\": 87\n}\n```\n\n## Usage Patterns for AI Agents\n\n### Pattern 1: User Uploads Excel File\n\n**User action:** Uploads `sales.xlsx` via Telegram\n\n**Agent workflow:**\n1. File saved to temporary location by Telegram handler\n2. Detect `.xlsx` extension\n3. Run: `excel-workflow process \u002Fpath\u002Fto\u002Fsales.xlsx --telegram-id \u003Cid>`\n4. Parse JSON result and respond:\n\n```\nAgent: \"✅ I've received and processed sales.xlsx!\n\n📊 Analysis:\n- 2 sheets: Sales, Summary\n- 15 formulas detected\n- ☁️ Uploaded to Google Drive\n\nWhat would you like to know about this file?\"\n```\n\n### Pattern 2: User Asks Question\n\n**User:** \"What's the total revenue in my sales file?\"\n\n**Agent workflow:**\n1. Run: `excel-workflow query \"what is total revenue?\" --file sales.xlsx`\n2. Receive data with all rows and formulas\n3. Analyze the data to find revenue-related columns and totals\n4. Respond with answer:\n\n```\nAgent: \"Looking at your sales.xlsx file:\n\nTotal Revenue: 650,000 руб\n\nBreakdown:\n- iPhone: 150,000 (3 × 50,000)\n- MacBook: 200,000 (2 × 100,000)\n- iPad: 300,000 (5 × 60,000)\n\nThe file has a SUM formula in cell D5 that calculates this automatically.\"\n```\n\n### Pattern 3: User Requests Update\n\n**User:** \"Change iPhone quantity to 20\"\n\n**Agent workflow:**\n1. Query to understand structure: `excel-workflow query \"find iPhone row\"`\n2. Identify that iPhone is in row 2, quantity in column C\n3. Run: `excel-workflow update '{\"C2\": 20}' --file sales.xlsx`\n4. Confirm update:\n\n```\nAgent: \"✅ Updated sales.xlsx:\n\nChanged C2 (iPhone quantity): 3 → 20\n\nNew revenue for iPhone: 1,000,000 руб (was 150,000)\nTotal revenue updated automatically thanks to formulas!\n\nFile has been re-uploaded to Google Drive.\"\n```\n\n### Pattern 4: Mass Formula Creation\n\n**User:** \"Create a column that multiplies price by 0.5 for all products\"\n\n**Agent workflow:**\n1. Read file to determine row count\n2. Generate update JSON with formulas for each row\n3. Run: `excel-workflow update '{\"D2\": \"=B2*0.5\", \"D3\": \"=B3*0.5\", ...}' --file prices.xlsx`\n4. Confirm:\n\n```\nAgent: \"✅ Created formulas for 50 rows!\n\nColumn D now contains =B*0.5 formula for all products.\nFile updated on Google Drive.\"\n```\n\n## Technical Details\n\n### Components\n\n1. **Excel CLI** — openpyxl-based tool for reading\u002Fwriting Excel files\n   - Preserves formulas using `data_only=False`\n   - Commands: `read`, `update`, `info`, `show-formulas`, `get-cell`\n\n2. **Tracker** — SQLite database for file metadata\n   - Location: `~\u002F.openclaw\u002Fexcel_tracker.db`\n   - Tracks: filename, sheets, formulas, paths, timestamps\n\n3. **Workflow Orchestrator** — Integrates Excel CLI, rclone, and tracker\n   - Orchestrates: analyze → upload → track → update cycle\n   - Progress messages to stderr, JSON results to stdout\n\n### File Locations\n\n- **Tracker database:** `~\u002F.openclaw\u002Fexcel_tracker.db`\n- **Google Drive folder:** `gdrive:Excel\u002F`\n- **Local files:** User-specified paths (Telegram downloads to `~\u002F.openclaw\u002Fmedia\u002F`)\n\n### Formula Preservation\n\n**How it works:**\n- openpyxl loads workbooks with `data_only=False`\n- Formulas stored as text strings (e.g., `\"=B2*C2\"`)\n- When updating cell with formula string, openpyxl preserves it\n- Excel recalculates formulas when file is opened\n\n**Example:**\n```python\n# This preserves formulas\nws['D2'] = '=B2*C2'  # Formula remains\nws['B2'] = 100       # Data changes, formula in D2 recalculates\n```\n\n### What's Preserved vs Not Preserved\n\n**✅ Preserved:**\n- Formulas (=SUM, =IF, =B2*C2, etc.)\n- Data (numbers, text, dates)\n- Structure (sheets, tables)\n- Formatting (colors, fonts, borders, bold)\n- Charts (diagrams update automatically)\n\n**⚠️ May Not Work:**\n- Conditional formatting (complex rules)\n- Macros (.xlsm files not supported)\n- Pivot tables (may break)\n- Slicers and advanced filters\n\n## Error Handling\n\n**Common errors:**\n\n1. **File not found**\n   ```json\n   {\"error\": \"File not found: \u002Fpath\u002Fto\u002Ffile.xlsx\"}\n   ```\n\n2. **Google Drive not configured**\n   ```json\n   {\"error\": \"rclone remote 'gdrive' not configured\"}\n   ```\n   Solution: Run `rclone config`\n\n3. **Formula syntax error**\n   ```json\n   {\"error\": \"Invalid formula: =B2*\"}\n   ```\n   Solution: Check formula syntax\n\n4. **Database locked**\n   ```json\n   {\"error\": \"Database is locked\"}\n   ```\n   Solution: Wait and retry\n\n## Examples\n\n### Example 1: Financial Data Analysis\n\n```bash\n# Upload stock data\nexcel-workflow process ~\u002FDesktop\u002FARKK.xlsx\n\n# Query\nexcel-workflow query \"show last 10 rows\" --file ARKK.xlsx\n\n# Add calculated column (50% of price)\n# First, find row count, then generate formulas\nexcel-workflow update '{\"C2\": \"=B2*0.5\", \"C3\": \"=B3*0.5\", ...}' --file ARKK.xlsx\n```\n\n### Example 2: Price List Update\n\n```bash\n# Process price list\nexcel-workflow process prices.xlsx\n\n# Update prices\nexcel-workflow update '{\"B10\": 99.99, \"B11\": 149.99}' --file prices.xlsx\n\n# Add tax column\nexcel-workflow update '{\"D2\": \"=B2*1.2\"}' --file prices.xlsx\n```\n\n### Example 3: Multiple Files\n\n```bash\n# Upload multiple files\nexcel-workflow process january.xlsx\nexcel-workflow process february.xlsx\n\n# List all files\nexcel-workflow list\n\n# Query specific file\nexcel-workflow query \"total sales\" --file january.xlsx\n\n# Stats\nexcel-workflow stats\n```\n\n## Troubleshooting\n\n### Issue: \"rclone not found\"\n\n```bash\n# Install rclone\nbrew install rclone  # macOS\nsudo apt install rclone  # Linux\n```\n\n### Issue: \"openpyxl not installed\"\n\n```bash\n# Install in virtual environment\ncd ~\u002F.openclaw\u002Ftools\u002Fopenclaw-excel\npython3 -m venv venv\n.\u002Fvenv\u002Fbin\u002Fpip install openpyxl\n```\n\n### Issue: \"Google Drive permission denied\"\n\n```bash\n# Reconfigure rclone\nrclone config\n# Delete old gdrive remote and create new one\n```\n\n### Issue: \"Formulas become values\"\n\n**This should NOT happen!** If it does:\n1. Check that `excel` CLI uses `data_only=False` when loading workbook\n2. Ensure formula strings start with `=`\n3. Verify openpyxl version: `pip show openpyxl` (should be 3.1.0+)\n\n## Best Practices\n\n### For Users\n\n1. **Name files descriptively**\n   - Good: `sales_2026_Q1.xlsx`\n   - Bad: `Book1.xlsx`\n\n2. **Ask specific questions**\n   - Good: \"What's the total revenue in January?\"\n   - Bad: \"Tell me about the file\"\n\n3. **Keep file structure consistent**\n   - Makes it easier for AI to understand\n\n### For Developers\n\n1. **Always check file existence** before processing\n2. **Use sessions** for multiple operations on same file\n3. **Handle errors gracefully** with try\u002Fexcept\n4. **Show progress** in stderr, results in stdout\n5. **Validate formulas** before updating cells\n\n## API Reference\n\nSee [Excel CLI Documentation](.\u002Fexcel_cli.md) and [Tracker Documentation](.\u002Ftracker.md) for detailed API reference.\n\n## Resources\n\n- [openpyxl Documentation](https:\u002F\u002Fopenpyxl.readthedocs.io\u002F)\n- [rclone Documentation](https:\u002F\u002Frclone.org\u002Fdocs\u002F)\n- [Microsoft Excel File Format](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fopenspecs\u002Foffice_standards\u002Fms-xlsx\u002F)\n- [Google Drive with rclone](https:\u002F\u002Frclone.org\u002Fdrive\u002F)\n\n## Support\n\n- GitHub Issues: [your-repo\u002Fexcel-workflow\u002Fissues]\n- Documentation: [your-repo\u002Fexcel-workflow\u002Fdocs]\n- Community: [OpenClaw Community]\n\n## License\n\nMIT License - see LICENSE.txt\n\n## Changelog\n\n### Version 1.0.0 (2026-02-20)\n\n- Initial release\n- Formula preservation with openpyxl\n- Google Drive sync via rclone\n- SQLite tracking\n- Multi-file support\n- Mass formula operations\n- AI agent integration patterns\n",{"name":5,"metadata":24,"description":35,"compatibility":36},{"author":25,"version":26,"openclaw":27},"alexey","1.0.0",{"emoji":28,"requires":29},"🔄",{"env":30,"bins":32},[31],"OPENCLAW_EXCEL_PATH",[33,34],"rclone","python3","Complete Excel workflow with local file processing, Google Drive sync, and formula preservation.\nProcess Excel files (.xlsx), track changes in SQLite, sync with Google Drive, and preserve formulas during updates.\nUse this skill when users want to upload Excel files, query data, update cells while preserving formulas, or sync with Google Drive.\n","Requires Python 3.8+, openpyxl, rclone, and Google Drive OAuth setup","main","54afe4b75ed2eb8f0feabb2f5b57dfa4bcbb3c44",".agents\u002Fskills\u002Fexcel-workflow\u002Fexcel-workflow-skill-package","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal","https:\u002F\u002Fgithub.com\u002Fmeghal86","2026-05-17 14:11:28",{"source":8,"skillName":5,"commands":44,"prompt":54,"zipAvailable":55},[45,48,51],{"tool":46,"command":47},"npx","npx skills add meghal86\u002Fstacksignal --skill excel-workflow",{"tool":49,"command":50},"bunx","bunx skills add meghal86\u002Fstacksignal --skill excel-workflow",{"tool":52,"command":53},"pnpm","pnpm dlx skills add meghal86\u002Fstacksignal --skill excel-workflow","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fexcel-workflow\u002Fexcel-workflow-skill-package\u002FSKILL.md",true,[57,63,68],{"path":58,"resourceType":59,"resourceTypeDesc":60,"sizeBytes":61,"sourceHtmlUrl":62},"_meta.json","REFERENCE","参考文档",53,"https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fexcel-workflow\u002Fexcel-workflow-skill-package\u002F_meta.json",{"path":64,"resourceType":65,"resourceTypeDesc":66,"sizeBytes":67,"sourceHtmlUrl":15},"LICENSE.txt","LICENSE","许可证",1073,{"path":69,"resourceType":59,"resourceTypeDesc":60,"sizeBytes":70,"sourceHtmlUrl":71},"README.md",1662,"https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fexcel-workflow\u002Fexcel-workflow-skill-package\u002FREADME.md",[73,82,90,98,106,113],{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":77,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":81},"01M78XH0FRP65NYEDHF2BT7NB1","zvukogram","Text-to-Speech via Zvukogram API with SSML support. Use when you need to generate speech from text, create podcasts, voice notifications, or work with audio. Supports speed control, stress marks, English word transcription, and audio fragment merging.","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzvukogram\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzvukogram\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":86,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":81},"01M78XEND5ASXYB6MN8AQQGJAF","zohomail","Zoho Mail API integration with managed OAuth. Send, receive, and manage emails, folders, and labels.\nUse this skill when users want to send emails, read messages, manage folders, or work with email labels in Zoho Mail.\nFor other third party apps, use the api-gateway skill (https:\u002F\u002Fclawhub.ai\u002Fbyungkyu\u002Fapi-gateway).\nRequires network access and valid Maton API key.","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzohomail\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzohomail\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":94,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":81},"01M78XEBBV3C6DRZFAJXP6RDKS","zoho-recruit","Zoho Recruit API integration with managed OAuth. Manage candidates, job openings, interviews, and recruitment workflows.\nUse this skill when users want to read, create, update, or search recruitment data like candidates, job openings, interviews, and applications in Zoho Recruit.\nFor other third party apps, use the api-gateway skill (https:\u002F\u002Fclawhub.ai\u002Fbyungkyu\u002Fapi-gateway).\nRequires network access and valid Maton API key.","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-recruit\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-recruit\u002FSKILL.md",[],[],{"skillNo":99,"name":100,"nameZh":6,"description":101,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":102,"sourceHtmlUrl":103,"categories":104,"keywords":105,"publishedAt":81},"01M78XE5CQG75DZWYSKGXFR99T","zoho-people","Zoho People API integration with managed OAuth. Manage employees, departments, designations, attendance, and leave.\nUse this skill when users want to read, create, update, or query HR data like employees, departments, designations, and forms in Zoho People.\nFor other third party apps, use the api-gateway skill (https:\u002F\u002Fclawhub.ai\u002Fbyungkyu\u002Fapi-gateway).\nRequires network access and valid Maton API key.","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-people\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-people\u002FSKILL.md",[],[],{"skillNo":107,"name":108,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":109,"sourceHtmlUrl":110,"categories":111,"keywords":112,"publishedAt":81},"01M78XDZKMZAJYFJJFT7MR5ZN2","zoho-mail","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-mail\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-mail\u002FSKILL.md",[],[],{"skillNo":114,"name":115,"nameZh":6,"description":116,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":117,"sourceHtmlUrl":118,"categories":119,"keywords":120,"publishedAt":81},"01M78XDST8JK0WVDA1F3VPNWXD","zoho-inventory","Zoho Inventory API integration with managed OAuth. Manage items, sales orders, invoices, purchase orders, bills, contacts, and shipments.\nUse this skill when users want to read, create, update, or delete inventory items, sales orders, invoices, purchase orders, bills, or other inventory records in Zoho Inventory.\nFor other third party apps, use the api-gateway skill (https:\u002F\u002Fclawhub.ai\u002Fbyungkyu\u002Fapi-gateway).\nRequires network access and valid Maton API key.","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-inventory\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fmeghal86\u002Fstacksignal\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fzoho-inventory\u002FSKILL.md",[],[]]