{"id":"1b636da8-d4a4-4b99-939e-42041dcac381","shortId":"jb5vPV","kind":"skill","title":"Update Markdown File Index","tagline":"Awesome Copilot skill by Github","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"],"capabilities":["skill","source-github","category-awesome-copilot"],"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":{"install_from":"skills.sh"}},"qualityScore":"0.300","qualityRationale":"deterministic score 0.30 from registry signals: · indexed on skills.sh · published under github/awesome-copilot","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:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T11:40:19.611Z","embedding":null,"createdAt":"2026-04-18T20:26:00.080Z","updatedAt":"2026-04-22T11:40:19.611Z","lastSeenAt":"2026-04-22T11:40:19.611Z","tsv":"'1':28,163 '2':40,177 '3':55,192 '4':70 '5':83 '6':95 'add':89,219 'alphabet':305 'analysi':107 'analyz':56 'appropri':73 'avail':302 'awesom':5 'base':76,119,155 'best':230 'best-fit':229 'categor':193 'categori':126 'category-awesome-copilot' 'charact':310 'choos':153 'column':274 'comment':134,280 'consist':105 'contain':263 'content':82,161,215,266 'context':121 'copilot':6 'creat':67,225 'date':148 'default':307 'descript':131,172,175,182,186,190,300 'detail':178 'directori':267 'discov':41,110 'document':241 'e.g':127 'ensur':97 'exist':38,60,63,81,86,160,209,213,223,235,257,287 'extens':118,124,185,189 'extract':112 'file':3,12,16,17,22,34,35,44,78,93,106,111,123,140,157,167,180,196,248,265,272,277,282,296,299,304 'file-rel':271 'filenam':114,312 'filename.ext':170,183 'filename2.ext':173,187 'first':132 'fit':231 'flow':242 'folder':24,26,48,50,169 'format':75,103,154,232,237,291 'generat':72,315 'github':9 'group':195 'handl':308 'head':238,262 'header':135 'html':279 'identif':254 'identifi':57 'includ':298 'index':4,13,94,264,283 'index/table':20 'infer':137 'input':25,49,53 'js':129 'last':146 'level':239 'line':133 'link':243,249,278,297 'list':42,165,268,275 'look':255 'maintain':234 'mark':281 'markdown':2,11,15,33,98,166,236,288,316 'match':51 'md':128 'modifi':145,147 'name':113 'new':68,90,220,226 'option':144,149,152,162,176,191 'path':246,294 'path/to/filename.ext':171,184 'path/to/filename2.ext':174,188 'pattern':52,54,261 'preserv':217,233,286 'process':27 'purpos':138 'py':130 'read':30 'refer':143 'relat':245,273,293 'replac':85,214 'repositori':252 'requir':285 'scan':29 'section':62,87,91,194,201,212,224,227,253,258,284 'separ':200 'simpl':164 'size':139,141 'skill':7 'sort':303 'source-github' 'special':309 'specifi':47 'strategi':207 'structur':39,69,71,151,218,289 'sub':204 'sub-tabl':203 'syntax':99,317 'tabl':150,179,205,269 'table/index':61,211 'table/list':74 'target':32 'type':79,122,158,181 'type/category':198 'understand':37 'updat':1,10,14,65,84,206,208 'use':228,244,292 'valid':96,101,313 'within':250 'without':117","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-04-22T06:52:33.580Z"},{"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-04-22T11:40:19.611Z"}],"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","source":"skills_sh","category":"awesome-copilot","skills_sh_url":"https://skills.sh/github/awesome-copilot/update-markdown-file-index"},"updatedAt":"2026-04-22T11:40:19.611Z"}}