[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6XBVYTSDXTHWSJNXT6TGP06":3,"skill-same:01M6XBVYTSDXTHWSJNXT6TGP06":56},{"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":17,"publishedAt":25,"linkOnly":26,"markdownContent":27,"markdownBody":28,"frontMatter":29,"refName":30,"commitSha":31,"skillDirectory":32,"forksCount":13,"repositoryHtmlUrl":33,"repositoryHomepageUrl":6,"ownerHtmlUrl":34,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":35,"install":36,"resources":49},"01M6XBVYTSDXTHWSJNXT6TGP06","prioritize-reference-files",null,"Ensures agents read and use provided reference files before searching or fabricating data","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\u002Fprioritize-reference-files\u002FSKILL.md",[],[18,19,20,21,22,23,24],"prioritize","reference","files","prioritize reference files","data","read","use","2026-11-10 10:12:30",false,"---\nname: prioritize-reference-files\ndescription: Ensures agents read and use provided reference files before searching or fabricating data\n---\n\n# Prioritize Reference Files\n\n## Purpose\n\nThis skill ensures that when reference files are provided in task context, you MUST read and extract data from them FIRST before attempting web searches or generating synthetic data. Ignoring available structured data leads to fabricated outputs and incorrect results.\n\n## Core Principle\n\n**Reference files in context > Web search > Data fabrication (never)**\n\n## Workflow\n\n### Step 1: Scan Task Context for Reference Files\n\nBefore taking any action, identify all files provided in the task context:\n- Look for file attachments, uploads, or references in the task description\n- Common formats: `.xlsx`, `.csv`, `.json`, `.pdf`, `.docx`, `.txt`\n- Check for phrases like \"attached\", \"provided\", \"reference file\", \"see file\"\n\n### Step 2: Read Reference Files First\n\nUse the appropriate tool to read each reference file:\n\n```python\n# For Excel files\nread_file(filetype=\"xlsx\", file_path=\"path\u002Fto\u002Ffile.xlsx\")\n\n# For CSV files  \nread_file(filetype=\"csv\", file_path=\"path\u002Fto\u002Ffile.csv\")\n\n# For PDF files\nread_file(filetype=\"pdf\", file_path=\"path\u002Fto\u002Ffile.pdf\")\n\n# For JSON files\nread_file(filetype=\"json\", file_path=\"path\u002Fto\u002Ffile.json\")\n\n# For text files\nread_file(filetype=\"txt\", file_path=\"path\u002Fto\u002Ffile.txt\")\n```\n\n**If read_file fails on .docx files** (returns error, empty content, or 'unknown error'):\n\n**Fallback Approach 1: Direct zipfile\u002FXML extraction via run_shell**\n```bash\n# .docx files are ZIP archives containing XML; extract document.xml directly\nunzip -p path\u002Fto\u002Ffile.docx word\u002Fdocument.xml | grep -oP '(?\u003C=\u003Cw:t>)[^\u003C]+' | tr '\\n' ' '\n```\nOr for more complete extraction:\n```bash\nmkdir -p \u002Ftmp\u002Fdocx_extract && cd \u002Ftmp\u002Fdocx_extract && unzip path\u002Fto\u002Ffile.docx && cat word\u002Fdocument.xml\n```\n\n**Fallback Approach 2: Use shell_agent for complex extraction**\nIf direct extraction fails, delegate to shell_agent:\n```\nshell_agent(task=\"Extract text content from path\u002Fto\u002Ffile.docx using zipfile and XML parsing\")\n```\nThe agent will attempt multiple extraction methods and report results.\n\n**Fallback Approach 3: Verify extraction success before proceeding**\nAfter any extraction method, confirm content was retrieved:\n- Check that output is non-empty and contains expected document structure\n- Look for familiar text from the document (headings, known phrases)\n- If extraction appears incomplete, try an alternative method\n- Document which method succeeded: \"Content extracted using [method] after read_file failed\"\n\n**Important**: Never proceed to data fabrication if reference files exist but read_file fails. Always attempt at least one fallback extraction method first.\n\n### Step 3: Extract and Validate Data\n\nAfter reading:\n1. Parse the content to understand the data structure\n2. Identify relevant fields\u002Fcolumns for your task\n3. Verify the data is complete and usable\n4. Note any limitations or missing information\n\n### Step 4: Use Reference Data as Primary Source\n\n- Base all outputs on the reference file data\n- Only supplement with web search if reference data is incomplete\n- NEVER fabricate data when reference files exist\n- If reference data is insufficient, explicitly state what's missing\n\n### Step 5: Document Data Source\n\nIn your outputs, acknowledge the source:\n- \"Data sourced from [filename]\"\n- \"Based on provided reference file: [filename]\"\n- This confirms you used the actual provided data\n\n## Anti-Patterns to Avoid\n\n❌ **Ignoring reference files** and searching the web instead\n❌ **Fabricating data** when structured data is available\n❌ **Assuming file contents** without reading them\n❌ **Using outdated web data** when current reference files exist\n❌ **Giving up after read_file fails** without trying fallback extraction methods\n\n## Example\n\n**Task Context**: \"Create a property listings report. See Massabama_active_listings.xlsx for current data.\"\n\n**Correct Approach**:\n```\n1. Read Massabama_active_listings.xlsx first\n2. Extract property addresses, prices, specifications\n3. Generate report using actual listing data\n4. Note: \"Data sourced from Massabama_active_listings.xlsx\"\n```\n\n**Incorrect Approach**:\n```\n1. Search web for \"Massabama property listings\"\n2. Fabricate property data from search results\n3. Create report with unverified\u002Fgenerated data\n```\n\n## Verification Checklist\n\nBefore completing any task with reference files:\n\n- [ ] I have identified all reference files in the task context\n- [ ] I have read each reference file using appropriate tools\n- [ ] I have extracted relevant data from the files\n- [ ] My output is based on the reference file data\n- [ ] I have documented the data source in my output\n\n## When Web Search is Appropriate\n\nOnly search the web when:\n- Reference files don't exist for the required data\n- Reference files are incomplete AND supplemental info is needed\n- You need to verify or update time-sensitive information\n- You explicitly state what the reference files lack\n\n---\n","# Prioritize Reference Files\n\n## Purpose\n\nThis skill ensures that when reference files are provided in task context, you MUST read and extract data from them FIRST before attempting web searches or generating synthetic data. Ignoring available structured data leads to fabricated outputs and incorrect results.\n\n## Core Principle\n\n**Reference files in context > Web search > Data fabrication (never)**\n\n## Workflow\n\n### Step 1: Scan Task Context for Reference Files\n\nBefore taking any action, identify all files provided in the task context:\n- Look for file attachments, uploads, or references in the task description\n- Common formats: `.xlsx`, `.csv`, `.json`, `.pdf`, `.docx`, `.txt`\n- Check for phrases like \"attached\", \"provided\", \"reference file\", \"see file\"\n\n### Step 2: Read Reference Files First\n\nUse the appropriate tool to read each reference file:\n\n```python\n# For Excel files\nread_file(filetype=\"xlsx\", file_path=\"path\u002Fto\u002Ffile.xlsx\")\n\n# For CSV files  \nread_file(filetype=\"csv\", file_path=\"path\u002Fto\u002Ffile.csv\")\n\n# For PDF files\nread_file(filetype=\"pdf\", file_path=\"path\u002Fto\u002Ffile.pdf\")\n\n# For JSON files\nread_file(filetype=\"json\", file_path=\"path\u002Fto\u002Ffile.json\")\n\n# For text files\nread_file(filetype=\"txt\", file_path=\"path\u002Fto\u002Ffile.txt\")\n```\n\n**If read_file fails on .docx files** (returns error, empty content, or 'unknown error'):\n\n**Fallback Approach 1: Direct zipfile\u002FXML extraction via run_shell**\n```bash\n# .docx files are ZIP archives containing XML; extract document.xml directly\nunzip -p path\u002Fto\u002Ffile.docx word\u002Fdocument.xml | grep -oP '(?\u003C=\u003Cw:t>)[^\u003C]+' | tr '\\n' ' '\n```\nOr for more complete extraction:\n```bash\nmkdir -p \u002Ftmp\u002Fdocx_extract && cd \u002Ftmp\u002Fdocx_extract && unzip path\u002Fto\u002Ffile.docx && cat word\u002Fdocument.xml\n```\n\n**Fallback Approach 2: Use shell_agent for complex extraction**\nIf direct extraction fails, delegate to shell_agent:\n```\nshell_agent(task=\"Extract text content from path\u002Fto\u002Ffile.docx using zipfile and XML parsing\")\n```\nThe agent will attempt multiple extraction methods and report results.\n\n**Fallback Approach 3: Verify extraction success before proceeding**\nAfter any extraction method, confirm content was retrieved:\n- Check that output is non-empty and contains expected document structure\n- Look for familiar text from the document (headings, known phrases)\n- If extraction appears incomplete, try an alternative method\n- Document which method succeeded: \"Content extracted using [method] after read_file failed\"\n\n**Important**: Never proceed to data fabrication if reference files exist but read_file fails. Always attempt at least one fallback extraction method first.\n\n### Step 3: Extract and Validate Data\n\nAfter reading:\n1. Parse the content to understand the data structure\n2. Identify relevant fields\u002Fcolumns for your task\n3. Verify the data is complete and usable\n4. Note any limitations or missing information\n\n### Step 4: Use Reference Data as Primary Source\n\n- Base all outputs on the reference file data\n- Only supplement with web search if reference data is incomplete\n- NEVER fabricate data when reference files exist\n- If reference data is insufficient, explicitly state what's missing\n\n### Step 5: Document Data Source\n\nIn your outputs, acknowledge the source:\n- \"Data sourced from [filename]\"\n- \"Based on provided reference file: [filename]\"\n- This confirms you used the actual provided data\n\n## Anti-Patterns to Avoid\n\n❌ **Ignoring reference files** and searching the web instead\n❌ **Fabricating data** when structured data is available\n❌ **Assuming file contents** without reading them\n❌ **Using outdated web data** when current reference files exist\n❌ **Giving up after read_file fails** without trying fallback extraction methods\n\n## Example\n\n**Task Context**: \"Create a property listings report. See Massabama_active_listings.xlsx for current data.\"\n\n**Correct Approach**:\n```\n1. Read Massabama_active_listings.xlsx first\n2. Extract property addresses, prices, specifications\n3. Generate report using actual listing data\n4. Note: \"Data sourced from Massabama_active_listings.xlsx\"\n```\n\n**Incorrect Approach**:\n```\n1. Search web for \"Massabama property listings\"\n2. Fabricate property data from search results\n3. Create report with unverified\u002Fgenerated data\n```\n\n## Verification Checklist\n\nBefore completing any task with reference files:\n\n- [ ] I have identified all reference files in the task context\n- [ ] I have read each reference file using appropriate tools\n- [ ] I have extracted relevant data from the files\n- [ ] My output is based on the reference file data\n- [ ] I have documented the data source in my output\n\n## When Web Search is Appropriate\n\nOnly search the web when:\n- Reference files don't exist for the required data\n- Reference files are incomplete AND supplemental info is needed\n- You need to verify or update time-sensitive information\n- You explicitly state what the reference files lack\n\n---\n",{"name":5,"description":7},"main","0650921d63895de3997bc81f1ff1d0ac67032072","gdpval_bench\u002Fskills\u002Fprioritize-reference-files","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":37,"prompt":47,"zipAvailable":48},[38,41,44],{"tool":39,"command":40},"npx","npx skills add UF-gzj\u002Fopenspace-claude-evolution --skill prioritize-reference-files",{"tool":42,"command":43},"bunx","bunx skills add UF-gzj\u002Fopenspace-claude-evolution --skill prioritize-reference-files",{"tool":45,"command":46},"pnpm","pnpm dlx skills add UF-gzj\u002Fopenspace-claude-evolution --skill prioritize-reference-files","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fprioritize-reference-files\u002FSKILL.md",true,[50],{"path":51,"resourceType":52,"resourceTypeDesc":53,"sizeBytes":54,"sourceHtmlUrl":55},".skill_id","OTHER","其他",40,"https:\u002F\u002Fgithub.com\u002FUF-gzj\u002Fopenspace-claude-evolution\u002Fblob\u002Fmain\u002Fgdpval_bench\u002Fskills\u002Fprioritize-reference-files\u002F.skill_id",[57,81,97,106,134,150],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":25},"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",[],[64,65,66,67,68,69,70,71,72,73,74,75,76,20,77,78,79,80],"check","write","write special chars ts check","typescript","filters","characters","Existing","type-checking","for","errors","script","output","type","only","template","file","python",{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":25},"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",[],[88,89,65,79,90,80,91,92,93,94,23,78,95,96,69,72,74],"readback","write special chars readback","helper","post","via","scripts","cleanup","verification","with",{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":25},"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",[],[104,65,69,105,74,92,78,79,80,72],"write special chars heredoc","shell",{"skillNo":107,"name":108,"nameZh":6,"description":109,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":110,"categories":111,"keywords":117,"publishedAt":25},"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",[112],{"categoryNo":113,"categoryName":114,"taxonomyType":115,"taxonomyTypeDesc":116},"01JBSEEDCAT000000000000033","数据分析师","PROFESSION","适用职业",[19,118,119,120,121,67,122,123,124,125,126,72,127,128,129,130,131,132,133,22],"worldmonitor","worldmonitor reference","architecture","dashboard","css","scheduler","layer","hierarchy","source","extracting","panel","patterns","edge functions","integrations","open","api",{"skillNo":135,"name":136,"nameZh":6,"description":137,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":138,"categories":139,"keywords":140,"publishedAt":25},"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",[],[141,142,143,144,72,145,96,146,147,148,149],"virtual list","list","virtual","chunk","dom","rendering","recycling","implement","performance",{"skillNo":151,"name":152,"nameZh":6,"description":153,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":154,"categories":155,"keywords":156,"publishedAt":25},"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",[],[157,158,159,160,161,162,79,163,164,165],"directory","verify directory structure","structure","verify","access","first","issues","diagnose","file access"]