[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6KFF2DF405379XZND36W6RJ":3,"skill-same:01M6KFF2DF405379XZND36W6RJ":71},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":28,"publishedAt":38,"linkOnly":39,"markdownContent":40,"markdownBody":41,"frontMatter":42,"refName":43,"commitSha":44,"skillDirectory":45,"forksCount":14,"repositoryHtmlUrl":46,"repositoryHomepageUrl":6,"ownerHtmlUrl":47,"ownerBlogUrl":48,"ownerDescription":49,"updatedAt":50,"install":51,"resources":64},"01M6KFF2DF405379XZND36W6RJ","excel-debug-extraction",null,"Iteratively debug Excel structure with exploratory scripts before writing extraction logic","xyliu-cs\u002FOpenSpace-GDPval","xyliu-cs","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F89236536?v=4","01M6KF8Z1V4TXS86CKSH48BY8T","xy","01M6KF8Z67443W0SHXM85JEF0B",0,"MIT","https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fexcel-debug-extraction\u002FSKILL.md",[18,23],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000004","电子表格","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":26,"taxonomyTypeDesc":27},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[29,30,31,32,33,34,35,36,37],"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","af1b40a42167d09c30b3a63000aa14ace4c1e229","gdpval_bench\u002Fskills\u002Fexcel-debug-extraction","https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval","https:\u002F\u002Fgithub.com\u002Fxyliu-cs","https:\u002F\u002Fxyliu-cs.github.io","PhD Student in CS, CUHK-Shenzhen.","2026-04-06 20:32:15",{"source":8,"skillName":5,"commands":52,"prompt":62,"zipAvailable":63},[53,56,59],{"tool":54,"command":55},"npx","npx skills add xyliu-cs\u002FOpenSpace-GDPval --skill excel-debug-extraction",{"tool":57,"command":58},"bunx","bunx skills add xyliu-cs\u002FOpenSpace-GDPval --skill excel-debug-extraction",{"tool":60,"command":61},"pnpm","pnpm dlx skills add xyliu-cs\u002FOpenSpace-GDPval --skill excel-debug-extraction","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fexcel-debug-extraction\u002FSKILL.md",true,[65],{"path":66,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":69,"sourceHtmlUrl":70},".skill_id","OTHER","其他",36,"https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fexcel-debug-extraction\u002F.skill_id",[72,85,93,108,132,152],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":38},"01M6KG8MF1S664SWBDENYRSCK8","zip-export-deliverable","Ensures codebase deliverables are properly exported as ZIP archives through a dedicated finalization step","https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fzip-export-deliverable\u002FSKILL.md",[],[79,80,81,82,83,84],"zip export deliverable","zip","export","deliverables","codebase","as",{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":38},"01M6KG8GAZWHHEK7VNJDW0ME21","zip-deliverable-finalization","Ensure codebase deliverables are properly packaged as ZIP exports in a dedicated final step","https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fzip-deliverable-finalization\u002FSKILL.md",[],[92,80,82,83,84],"zip deliverable finalization",{"skillNo":94,"name":95,"nameZh":6,"description":96,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":38},"01M6KG8CMQQ1PYMNTSRZ9VS1MD","zero-iteration-failure-analysis","Identify and handle agent failures with 0 iterations as pre-execution system issues","https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fzero-iteration-failure-analysis\u002FSKILL.md",[],[100,101,102,103,104,37,105,106,84,107],"failure analysis","ZeRO","analysis","iteration","zero iteration failure analysis","issues","execution","system",{"skillNo":109,"name":110,"nameZh":6,"description":111,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":112,"categories":113,"keywords":117,"publishedAt":38},"01M6KG86W3PA07FT9W58YHHERM","write-file-fallback-report","Generate professional documents using write_file when primary data sources fail, leveraging embedded domain knowledge instead of external retrieval","https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fwrite-file-fallback-report\u002FSKILL.md",[114],{"categoryNo":115,"categoryName":116,"taxonomyType":26,"taxonomyTypeDesc":27},"01JBSEEDCAT000000000000034","行政与办公人员",[118,119,120,121,122,123,124,125,126,127,128,129,130,131],"fallback","write","file","report","write file fallback report","domain","professional","sources","retrieval","generate","embedded","documents","data","knowledge",{"skillNo":133,"name":134,"nameZh":6,"description":135,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":136,"categories":137,"keywords":141,"publishedAt":38},"01M6KG82GAEY3GG77CMGCK1C2T","fallback-doc-with-delegation","Generate professional documents after tool failures using shell_agent for complex formats or write_file for simple text\u002Fmarkdown","https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fwrite-file-fallback-report-enhanced\u002FSKILL.md",[138],{"categoryNo":139,"categoryName":140,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",[142,37,118,143,144,145,129,127,120,146,147,148,119,149,124,150,151],"fallback doc with delegation","doc","delegation","shell","markdown","tool","text","simple","formats","for",{"skillNo":153,"name":154,"nameZh":6,"description":155,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":156,"categories":157,"keywords":159,"publishedAt":38},"01M6KG7WT7GX5NYCGEFHW22NV7","context-anchored-fallback-report","Generate documents with write_file when retrieval tools fail, with explicit guardrails against task context drift","https:\u002F\u002Fgithub.com\u002Fxyliu-cs\u002FOpenSpace-GDPval\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fwrite-file-fallback-report-enhanced-4bc5c2\u002FSKILL.md",[158],{"categoryNo":115,"categoryName":116,"taxonomyType":26,"taxonomyTypeDesc":27},[118,121,160,161,127,120,162,163,119,164,165,126,37,166,129],"context","context anchored fallback report","Guardrails","Tools","task","drift","context drift"]