{"id":"1b636da8-d4a4-4b99-939e-42041dcac381","shortId":"jb5vPV","kind":"skill","title":"update-markdown-file-index","tagline":"Update a markdown file section with an index/table of files from a specified folder.","description":"# Update Markdown File Index\n\nUpdate markdown file `${file}` with an index/table of files from folder `${input:folder}`.\n\n## Process\n\n1. **Scan**: Read the target markdown file `${file}` to understand existing structure\n2. **Discover**: List all files in the specified folder `${input:folder}` matching pattern `${input:pattern}`\n3. **Analyze**: Identify if an existing table/index section exists to update, or create new structure\n4. **Structure**: Generate appropriate table/list format based on file types and existing content\n5. **Update**: Replace existing section or add new section with file index\n6. **Validate**: Ensure markdown syntax is valid and formatting is consistent\n\n## File Analysis\n\nFor each discovered file, extract:\n\n- **Name**: Filename with or without extension based on context\n- **Type**: File extension and category (e.g., `.md`, `.js`, `.py`)\n- **Description**: First line comment, header, or inferred purpose\n- **Size**: File size for reference (optional)\n- **Modified**: Last modified date (optional)\n\n## Table Structure Options\n\nChoose format based on file types and existing content:\n\n### Option 1: Simple List\n\n```markdown\n## Files in ${folder}\n\n- [filename.ext](path/to/filename.ext) - Description\n- [filename2.ext](path/to/filename2.ext) - Description\n```\n\n### Option 2: Detailed Table\n\n| File | Type | Description |\n|------|------|-------------|\n| [filename.ext](path/to/filename.ext) | Extension | Description |\n| [filename2.ext](path/to/filename2.ext) | Extension | Description |\n\n### Option 3: Categorized Sections\n\nGroup files by type/category with separate sections or sub-tables.\n\n## Update Strategy\n\n- 🔄 **Update existing**: If table/index section exists, replace content while preserving structure\n- ➕ **Add new**: If no existing section, create new section using best-fit format\n- 📋 **Preserve**: Maintain existing markdown formatting, heading levels, and document flow\n- 🔗 **Links**: Use relative paths for file links within the repository\n\n## Section Identification\n\nLook for existing sections with these patterns:\n\n- Headings containing: \"index\", \"files\", \"contents\", \"directory\", \"list\"\n- Tables with file-related columns\n- Lists with file links\n- HTML comments marking file index sections\n\n## Requirements\n\n- Preserve existing markdown structure and formatting\n- Use relative paths for file links\n- Include file descriptions when available\n- Sort files alphabetically by default\n- Handle special characters in filenames\n- Validate all generated markdown syntax","tags":["update","markdown","file","index","awesome","copilot","github","agent-skills","agents","custom-agents","github-copilot","hacktoberfest"],"capabilities":["skill","source-github","skill-update-markdown-file-index","topic-agent-skills","topic-agents","topic-awesome","topic-custom-agents","topic-github-copilot","topic-hacktoberfest","topic-prompt-engineering"],"categories":["awesome-copilot"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/github/awesome-copilot/update-markdown-file-index","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add github/awesome-copilot","source_repo":"https://github.com/github/awesome-copilot","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 33270 github stars · SKILL.md body (2,512 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:52:27.548Z","embedding":null,"createdAt":"2026-04-18T20:26:00.080Z","updatedAt":"2026-05-18T18:52:27.548Z","lastSeenAt":"2026-05-18T18:52:27.548Z","tsv":"'1':38,173 '2':50,187 '3':65,202 '4':80 '5':93 '6':105 'add':99,229 'alphabet':315 'analysi':117 'analyz':66 'appropri':83 'avail':312 'base':86,129,165 'best':240 'best-fit':239 'categor':203 'categori':136 'charact':320 'choos':163 'column':284 'comment':144,290 'consist':115 'contain':273 'content':92,171,225,276 'context':131 'creat':77,235 'date':158 'default':317 'descript':141,182,185,192,196,200,310 'detail':188 'directori':277 'discov':51,120 'document':251 'e.g':137 'ensur':107 'exist':48,70,73,91,96,170,219,223,233,245,267,297 'extens':128,134,195,199 'extract':122 'file':4,9,15,22,26,27,32,44,45,54,88,103,116,121,133,150,167,177,190,206,258,275,282,287,292,306,309,314 'file-rel':281 'filenam':124,322 'filename.ext':180,193 'filename2.ext':183,197 'first':142 'fit':241 'flow':252 'folder':19,34,36,58,60,179 'format':85,113,164,242,247,301 'generat':82,325 'group':205 'handl':318 'head':248,272 'header':145 'html':289 'identif':264 'identifi':67 'includ':308 'index':5,23,104,274,293 'index/table':13,30 'infer':147 'input':35,59,63 'js':139 'last':156 'level':249 'line':143 'link':253,259,288,307 'list':52,175,278,285 'look':265 'maintain':244 'mark':291 'markdown':3,8,21,25,43,108,176,246,298,326 'match':61 'md':138 'modifi':155,157 'name':123 'new':78,100,230,236 'option':154,159,162,172,186,201 'path':256,304 'path/to/filename.ext':181,194 'path/to/filename2.ext':184,198 'pattern':62,64,271 'preserv':227,243,296 'process':37 'purpos':148 'py':140 'read':40 'refer':153 'relat':255,283,303 'replac':95,224 'repositori':262 'requir':295 'scan':39 'section':10,72,97,101,204,211,222,234,237,263,268,294 'separ':210 'simpl':174 'size':149,151 'skill' 'skill-update-markdown-file-index' 'sort':313 'source-github' 'special':319 'specifi':18,57 'strategi':217 'structur':49,79,81,161,228,299 'sub':214 'sub-tabl':213 'syntax':109,327 'tabl':160,189,215,279 'table/index':71,221 'table/list':84 'target':42 'topic-agent-skills' 'topic-agents' 'topic-awesome' 'topic-custom-agents' 'topic-github-copilot' 'topic-hacktoberfest' 'topic-prompt-engineering' 'type':89,132,168,191 'type/category':208 'understand':47 'updat':2,6,20,24,75,94,216,218 'update-markdown-file-index':1 'use':238,254,302 'valid':106,111,323 'within':260 'without':127","prices":[{"id":"183e4ade-021e-434d-b5d1-84954a3005ee","listingId":"1b636da8-d4a4-4b99-939e-42041dcac381","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"github","category":"awesome-copilot","install_from":"skills.sh"},"createdAt":"2026-04-18T20:26:00.080Z"}],"sources":[{"listingId":"1b636da8-d4a4-4b99-939e-42041dcac381","source":"github","sourceId":"github/awesome-copilot/update-markdown-file-index","sourceUrl":"https://github.com/github/awesome-copilot/tree/main/skills/update-markdown-file-index","isPrimary":false,"firstSeenAt":"2026-04-18T21:51:34.401Z","lastSeenAt":"2026-05-18T18:52:27.548Z"},{"listingId":"1b636da8-d4a4-4b99-939e-42041dcac381","source":"skills_sh","sourceId":"github/awesome-copilot/update-markdown-file-index","sourceUrl":"https://skills.sh/github/awesome-copilot/update-markdown-file-index","isPrimary":true,"firstSeenAt":"2026-04-18T20:26:00.080Z","lastSeenAt":"2026-05-07T22:40:18.490Z"}],"details":{"listingId":"1b636da8-d4a4-4b99-939e-42041dcac381","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"github","slug":"update-markdown-file-index","github":{"repo":"github/awesome-copilot","stars":33270,"topics":["agent-skills","agents","ai","awesome","custom-agents","github-copilot","hacktoberfest","prompt-engineering"],"license":"mit","html_url":"https://github.com/github/awesome-copilot","pushed_at":"2026-05-18T01:26:59Z","description":"Community-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.","skill_md_sha":"3bcb8efc810e4d40f181c3e33a9fbbd62b3619f0","skill_md_path":"skills/update-markdown-file-index/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/github/awesome-copilot/tree/main/skills/update-markdown-file-index"},"layout":"multi","source":"github","category":"awesome-copilot","frontmatter":{"name":"update-markdown-file-index","description":"Update a markdown file section with an index/table of files from a specified folder."},"skills_sh_url":"https://skills.sh/github/awesome-copilot/update-markdown-file-index"},"updatedAt":"2026-05-18T18:52:27.548Z"}}