[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6XBJYBAD3J6AWSY1XR6X4JB":3,"skill-same:01M6XBJYBAD3J6AWSY1XR6X4JB":68},{"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":6,"sourceHtmlUrl":15,"categories":16,"keywords":27,"publishedAt":37,"linkOnly":38,"markdownContent":39,"markdownBody":40,"frontMatter":41,"refName":42,"commitSha":43,"skillDirectory":44,"forksCount":13,"repositoryHtmlUrl":45,"repositoryHomepageUrl":6,"ownerHtmlUrl":46,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":47,"install":48,"resources":61},"01M6XBJYBAD3J6AWSY1XR6X4JB","excel-debug-extraction",null,"Iteratively debug Excel structure with exploratory scripts before writing extraction logic","UF-gzj\u002Fopenspace-claude-evolution","UF-gzj","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F272393507?v=4","01M6XBCZB755P01VVYGQWPYZY3","01M6XBCZFJA5AREA17WGETA3FW",0,"MIT","https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fexcel-debug-extraction\u002FSKILL.md",[17,22],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000004","电子表格","SCENARIO","使用场景",{"categoryNo":23,"categoryName":24,"taxonomyType":25,"taxonomyTypeDesc":26},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[28,29,30,31,32,33,34,35,36],"xlsx","debug","extraction","excel debug extraction","writing","structure","logic","scripts","with","2026-11-10 10:12:30",false,"---\nname: excel-debug-extraction\ndescription: Iteratively debug Excel structure with exploratory scripts before writing extraction logic\n---\n\n# Excel Debug-First Extraction Workflow\n\nWhen working with poorly-structured, complex, or unfamiliar Excel files, use this iterative debugging approach to map the data layout before writing your final extraction logic.\n\n## When to Use This Skill\n\n- Excel files with inconsistent formatting or merged cells\n- Files received from external sources with unknown structure\n- Complex workbooks with multiple sheets and interdependencies\n- When initial parsing attempts fail or produce unexpected results\n\n## Workflow Steps\n\n### Step 1: Initial Structure Reconnaissance\n\nBefore writing extraction logic, create a debug script to explore the file structure:\n\n```python\n# debug_structure.py\nfrom openpyxl import load_workbook\n\nwb = load_workbook('file.xlsx')\nprint(f\"Sheets: {wb.sheetnames}\")\n\nfor sheet_name in wb.sheetnames:\n    ws = wb[sheet_name]\n    print(f\"\\n=== Sheet: {sheet_name} ===\")\n    print(f\"Dimensions: {ws.dimensions}\")\n    \n    # Print first 10 rows to understand header structure\n    for row in ws.iter_rows(min_row=1, max_row=10, values_only=True):\n        print([str(cell)[:50] for cell in row])\n```\n\n### Step 2: Map Column Positions\n\nIdentify where key data fields are located:\n\n```python\n# debug_columns.py\nfrom openpyxl import load_workbook\n\nwb = load_workbook('file.xlsx')\nws = wb['Sheet1']\n\n# Examine header row to find column indices\nheader_row = 1\ncolumn_map = {}\n\nfor col in ws.iter_cols(min_row=header_row, max_row=header_row):\n    for cell in col:\n        if cell.value:\n            column_map[str(cell.value)] = cell.column_letter\n\nprint(\"Column mapping:\", column_map)\n\n# Sample data rows to verify structure\nfor row_num in range(2, min(6, ws.max_row + 1)):\n    row_data = [ws.cell(row=row_num, column=col).value \n                for col in range(1, ws.max_column + 1)]\n    print(f\"Row {row_num}: {row_data}\")\n```\n\n### Step 3: Identify Row Patterns\n\nUnderstand how data rows are structured (e.g., summary rows, detail rows, blank separators):\n\n```python\n# debug_rows.py\nfrom openpyxl import load_workbook\n\nwb = load_workbook('file.xlsx')\nws = wb['Sheet1']\n\nrow_types = []\nfor row_num in range(1, min(30, ws.max_row + 1)):\n    row_values = [ws.cell(row=row_num, column=col).value \n                  for col in range(1, ws.max_column + 1)]\n    \n    non_empty = sum(1 for v in row_values if v is not None and str(v).strip())\n    \n    # Classify row type\n    if non_empty == 0:\n        row_type = \"blank\"\n    elif non_empty == 1:\n        row_type = \"summary\u002Flabel\"\n    elif non_empty == ws.max_column:\n        row_type = \"full_data\"\n    else:\n        row_type = \"partial\"\n    \n    row_types.append((row_num, row_type, row_values[:5]))\n\nfor rt in row_types:\n    print(f\"Row {rt[0]} ({rt[1]}): {rt[2]}\")\n```\n\n### Step 4: Document Findings\n\nBefore writing extraction logic, summarize:\n- Sheet names and their purposes\n- Header row location and column mappings\n- Data row patterns (which rows contain actual data vs. headers\u002Fsummaries)\n- Any special formatting (merged cells, blank separators, grouping rows)\n\n### Step 5: Write Extraction Logic\n\nIncorporate findings into your final processing script:\n\n```python\n# extract_data.py\nfrom openpyxl import load_workbook\nimport pandas as pd\n\nwb = load_workbook('file.xlsx')\nws = wb['Sheet1']\n\n# Use column mappings from debug phase\nSTORE_COL = 'B'  # Column 2\nWEEK1_COL = 'D'  # Column 4\nWEEK2_COL = 'E'  # Column 5\n\n# Skip header rows and summary rows based on debug findings\ndata_rows = []\nfor row_num in range(5, ws.max_row + 1):  # Start after header based on debug\n    # Skip summary\u002Fblank rows\n    if ws.cell(row=row_num, column=2).value is None:\n        continue\n    if 'TOTAL' in str(ws.cell(row=row_num, column=2).value).upper():\n        continue\n    \n    row_data = {\n        'store': ws.cell(row=row_num, column=2).value,\n        'week1': ws.cell(row=row_num, column=4).value,\n        'week2': ws.cell(row=row_num, column=5).value,\n    }\n    data_rows.append(row_data)\n\ndf = pd.DataFrame(data_rows)\nprint(df.head())\n```\n\n## Best Practices\n\n1. **Always start with exploration** - Never assume Excel structure matches expectations\n2. **Save debug scripts** - Keep them in your project for future reference and debugging\n3. **Print generously** - Use verbose output during exploration to catch edge cases\n4. **Verify row-by-row** - Don't assume all data rows follow the same pattern\n5. **Handle merged cells** - Check for merged cells that span multiple rows\u002Fcolumns\n\n## Common Pitfalls to Avoid\n\n- Assuming header is always row 1\n- Assuming all rows between first and last contain data\n- Not checking for hidden sheets or protected ranges\n- Ignoring cell formatting that indicates row type (bold, indentation)\n- Not handling None values or empty strings consistently\n\n## File Naming Convention\n\nUse descriptive names for debug scripts:\n- `debug_structure.py` - Overall file\u002Fsheet structure\n- `debug_columns.py` - Column positions and headers\n- `debug_rows.py` - Row patterns and data boundaries\n- `debug_values.py` - Value patterns and edge cases\n\nKeep debug scripts alongside your extraction script for maintainability.","# Excel Debug-First Extraction Workflow\n\nWhen working with poorly-structured, complex, or unfamiliar Excel files, use this iterative debugging approach to map the data layout before writing your final extraction logic.\n\n## When to Use This Skill\n\n- Excel files with inconsistent formatting or merged cells\n- Files received from external sources with unknown structure\n- Complex workbooks with multiple sheets and interdependencies\n- When initial parsing attempts fail or produce unexpected results\n\n## Workflow Steps\n\n### Step 1: Initial Structure Reconnaissance\n\nBefore writing extraction logic, create a debug script to explore the file structure:\n\n```python\n# debug_structure.py\nfrom openpyxl import load_workbook\n\nwb = load_workbook('file.xlsx')\nprint(f\"Sheets: {wb.sheetnames}\")\n\nfor sheet_name in wb.sheetnames:\n    ws = wb[sheet_name]\n    print(f\"\\n=== Sheet: {sheet_name} ===\")\n    print(f\"Dimensions: {ws.dimensions}\")\n    \n    # Print first 10 rows to understand header structure\n    for row in ws.iter_rows(min_row=1, max_row=10, values_only=True):\n        print([str(cell)[:50] for cell in row])\n```\n\n### Step 2: Map Column Positions\n\nIdentify where key data fields are located:\n\n```python\n# debug_columns.py\nfrom openpyxl import load_workbook\n\nwb = load_workbook('file.xlsx')\nws = wb['Sheet1']\n\n# Examine header row to find column indices\nheader_row = 1\ncolumn_map = {}\n\nfor col in ws.iter_cols(min_row=header_row, max_row=header_row):\n    for cell in col:\n        if cell.value:\n            column_map[str(cell.value)] = cell.column_letter\n\nprint(\"Column mapping:\", column_map)\n\n# Sample data rows to verify structure\nfor row_num in range(2, min(6, ws.max_row + 1)):\n    row_data = [ws.cell(row=row_num, column=col).value \n                for col in range(1, ws.max_column + 1)]\n    print(f\"Row {row_num}: {row_data}\")\n```\n\n### Step 3: Identify Row Patterns\n\nUnderstand how data rows are structured (e.g., summary rows, detail rows, blank separators):\n\n```python\n# debug_rows.py\nfrom openpyxl import load_workbook\n\nwb = load_workbook('file.xlsx')\nws = wb['Sheet1']\n\nrow_types = []\nfor row_num in range(1, min(30, ws.max_row + 1)):\n    row_values = [ws.cell(row=row_num, column=col).value \n                  for col in range(1, ws.max_column + 1)]\n    \n    non_empty = sum(1 for v in row_values if v is not None and str(v).strip())\n    \n    # Classify row type\n    if non_empty == 0:\n        row_type = \"blank\"\n    elif non_empty == 1:\n        row_type = \"summary\u002Flabel\"\n    elif non_empty == ws.max_column:\n        row_type = \"full_data\"\n    else:\n        row_type = \"partial\"\n    \n    row_types.append((row_num, row_type, row_values[:5]))\n\nfor rt in row_types:\n    print(f\"Row {rt[0]} ({rt[1]}): {rt[2]}\")\n```\n\n### Step 4: Document Findings\n\nBefore writing extraction logic, summarize:\n- Sheet names and their purposes\n- Header row location and column mappings\n- Data row patterns (which rows contain actual data vs. headers\u002Fsummaries)\n- Any special formatting (merged cells, blank separators, grouping rows)\n\n### Step 5: Write Extraction Logic\n\nIncorporate findings into your final processing script:\n\n```python\n# extract_data.py\nfrom openpyxl import load_workbook\nimport pandas as pd\n\nwb = load_workbook('file.xlsx')\nws = wb['Sheet1']\n\n# Use column mappings from debug phase\nSTORE_COL = 'B'  # Column 2\nWEEK1_COL = 'D'  # Column 4\nWEEK2_COL = 'E'  # Column 5\n\n# Skip header rows and summary rows based on debug findings\ndata_rows = []\nfor row_num in range(5, ws.max_row + 1):  # Start after header based on debug\n    # Skip summary\u002Fblank rows\n    if ws.cell(row=row_num, column=2).value is None:\n        continue\n    if 'TOTAL' in str(ws.cell(row=row_num, column=2).value).upper():\n        continue\n    \n    row_data = {\n        'store': ws.cell(row=row_num, column=2).value,\n        'week1': ws.cell(row=row_num, column=4).value,\n        'week2': ws.cell(row=row_num, column=5).value,\n    }\n    data_rows.append(row_data)\n\ndf = pd.DataFrame(data_rows)\nprint(df.head())\n```\n\n## Best Practices\n\n1. **Always start with exploration** - Never assume Excel structure matches expectations\n2. **Save debug scripts** - Keep them in your project for future reference and debugging\n3. **Print generously** - Use verbose output during exploration to catch edge cases\n4. **Verify row-by-row** - Don't assume all data rows follow the same pattern\n5. **Handle merged cells** - Check for merged cells that span multiple rows\u002Fcolumns\n\n## Common Pitfalls to Avoid\n\n- Assuming header is always row 1\n- Assuming all rows between first and last contain data\n- Not checking for hidden sheets or protected ranges\n- Ignoring cell formatting that indicates row type (bold, indentation)\n- Not handling None values or empty strings consistently\n\n## File Naming Convention\n\nUse descriptive names for debug scripts:\n- `debug_structure.py` - Overall file\u002Fsheet structure\n- `debug_columns.py` - Column positions and headers\n- `debug_rows.py` - Row patterns and data boundaries\n- `debug_values.py` - Value patterns and edge cases\n\nKeep debug scripts alongside your extraction script for maintainability.",{"name":5,"description":7},"main","0650921d63895de3997bc81f1ff1d0ac67032072","gdpval_bench\u002Fskills\u002Fexcel-debug-extraction","https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution","https:\u002F\u002Fgithub.com\u002FUF-gzj","2026-04-16 09:31:03",{"source":8,"skillName":5,"commands":49,"prompt":59,"zipAvailable":60},[50,53,56],{"tool":51,"command":52},"npx","npx skills add UF-gzj\u002Fopenspace-claude-evolution --skill excel-debug-extraction",{"tool":54,"command":55},"bunx","bunx skills add UF-gzj\u002Fopenspace-claude-evolution --skill excel-debug-extraction",{"tool":57,"command":58},"pnpm","pnpm dlx skills add UF-gzj\u002Fopenspace-claude-evolution --skill excel-debug-extraction","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fexcel-debug-extraction\u002FSKILL.md",true,[62],{"path":63,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":66,"sourceHtmlUrl":67},".skill_id","OTHER","其他",36,"https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fexcel-debug-extraction\u002F.skill_id",[69,94,109,118,146,162],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":37},"01M6XCCXD3NCM2YKR3WNGBASPC","write-special-chars-ts-check","Workaround for write_file failures caused by special characters (apostrophes, backticks, template literals) using a Python heredoc script, plus a reliable TypeScript type-checking step that filters output to only the newly-written files to avoid being misled by pre-existing errors.","https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fshowcase\u002Fskills\u002Fwrite-special-chars-ts-check\u002FSKILL.md",[],[76,77,78,79,80,81,82,83,84,85,86,87,88,89,90,91,92,93],"check","write","write special chars ts check","typescript","filters","characters","Existing","type-checking","for","errors","script","output","type","files","only","template","file","python",{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":37},"01M6XCCT7E3J922Q345PBGSHPN","write-special-chars-readback","Workaround for write_file failures caused by special characters (apostrophes, backticks, template literals) using a Python heredoc script, with mandatory post-write verification via read_file and cleanup of \u002Ftmp helper scripts.","https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fshowcase\u002Fskills\u002Fwrite-special-chars-readback\u002FSKILL.md",[],[101,102,77,92,103,93,104,105,35,106,107,91,108,36,81,84,86],"readback","write special chars readback","helper","post","via","cleanup","read","verification",{"skillNo":110,"name":111,"nameZh":6,"description":112,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":113,"categories":114,"keywords":115,"publishedAt":37},"01M6XCCMQX1R8B6FECWB3P63T7","write-special-chars-heredoc","Workaround for write_file failures caused by special characters (apostrophes, backticks, template literals) by using a Python heredoc script executed via shell.","https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fshowcase\u002Fskills\u002Fwrite-special-chars-heredoc\u002FSKILL.md",[],[116,77,81,117,86,105,91,92,93,84],"write special chars heredoc","shell",{"skillNo":119,"name":120,"nameZh":6,"description":121,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":122,"categories":123,"keywords":127,"publishedAt":37},"01M6XCCG41M994JJEX6VN52PEP","worldmonitor-reference","Curated architecture index of the WorldMonitor open-source dashboard. Reference for extracting patterns — vanilla TypeScript, Panel class hierarchy, service layer, CSS grid, API edge functions, refresh scheduler, and 60+ data source integrations.","https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fshowcase\u002Fskills\u002Fworldmonitor-reference\u002FSKILL.md",[124],{"categoryNo":125,"categoryName":126,"taxonomyType":25,"taxonomyTypeDesc":26},"01JBSEEDCAT000000000000033","数据分析师",[128,129,130,131,132,79,133,134,135,136,137,84,138,139,140,141,142,143,144,145],"reference","worldmonitor","worldmonitor reference","architecture","dashboard","css","scheduler","layer","hierarchy","source","extracting","panel","patterns","edge functions","integrations","open","api","data",{"skillNo":147,"name":148,"nameZh":6,"description":149,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":150,"categories":151,"keywords":152,"publishedAt":37},"01M6XCCCHWNKG2W4VH9E6A10HF","virtual-list","Implement efficient virtual scrolling for rendering large lists with DOM recycling, chunk-based rendering, and performance optimizations","https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fshowcase\u002Fskills\u002Fvirtual-list\u002FSKILL.md",[],[153,154,155,156,84,157,36,158,159,160,161],"virtual list","list","virtual","chunk","dom","rendering","recycling","implement","performance",{"skillNo":163,"name":164,"nameZh":6,"description":165,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":166,"categories":167,"keywords":168,"publishedAt":37},"01M6XCC7X8PKMR2DEW91XGHYSV","verify-directory-structure","Diagnose and resolve file access issues by first verifying the directory structure.","https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fshowcase\u002Fskills\u002Fverify-directory-structure\u002FSKILL.md",[],[169,170,33,171,172,173,92,174,175,176],"directory","verify directory structure","verify","access","first","issues","diagnose","file access"]