github avatar

Update Markdown File Index

The update-markdown-file-index skill scans a specified folder, discovers files matching a given pattern, and automatically updates or creates an index section in a markdown file with a formatted table or list of those files. It's designed for documentation maintainers and repository managers who need to keep markdown indexes current without manual updates, solving the problem of outdated file listings and broken or missing documentation references. The skill preserves existing markdown structure, generates appropriate formatting based on content type, and ensures all file links use relative paths for repository consistency.

skills.sh installs
8.9K
GitHub stars
41K
last updated
Aug 21, 2026

Install

$ npx -y skills add github/awesome-copilot --skill update-markdown-file-index --agent claude-code

Installs into .claude/skills of the current project.

Files

Update Markdown File Index

Update markdown file ${file} with an index/table of files from folder ${input:folder}.

Process

  1. Scan: Read the target markdown file ${file} to understand existing structure
  2. Discover: List all files in the specified folder ${input:folder} matching pattern ${input:pattern}
  3. Analyze: Identify if an existing table/index section exists to update, or create new structure
  4. Structure: Generate appropriate table/list format based on file types and existing content
  5. Update: Replace existing section or add new section with file index
  6. Validate: Ensure markdown syntax is valid and formatting is consistent

File Analysis

For each discovered file, extract:

  • Name: Filename with or without extension based on context
  • Type: File extension and category (e.g., .md, .js, .py)
  • Description: First line comment, header, or inferred purpose
  • Size: File size for reference (optional)
  • Modified: Last modified date (optional)

Table Structure Options

Choose format based on file types and existing content:

Option 1: Simple List

## Files in ${folder}

Sponsors

Details

Repository
github.com/github/awesome-copilot
Categories
Git & Pull Requests, AI & Agent Building, Marketing & SEO

More from github/awesome-copilot

All 318
1github avatarazure-static-web-appsgithub/awesome-copilotHelps create, configure, and deploy Azure Static Web Apps using the SWA CLI. Use when deploying static sites to Azure, setting up SWA local development, configu8.9Kskills.sh installs
2github avatarjava-refactoring-remove-parametergithub/awesome-copilotRefactoring using Remove Parameter in Java Language8.9Kskills.sh installs
3github avatarlegacy-circuit-mockupsgithub/awesome-copilotGenerate breadboard circuit mockups and visual diagrams using HTML5 Canvas drawing techniques. Use when asked to create circuit layouts, visualize electronic co8.9Kskills.sh installs
4github avatarpower-bi-performance-troubleshootinggithub/awesome-copilotSystematic Power BI performance troubleshooting prompt for identifying, diagnosing, and resolving performance issues in Power BI models, reports, and queries.8.9Kskills.sh installs
5github avatarcontainerize-aspnetcoregithub/awesome-copilotContainerize an ASP.NET Core project by creating Dockerfile and .dockerfile files customized for the project.8.9Kskills.sh installs
6github avatarphp-mcp-server-generatorgithub/awesome-copilotGenerate a complete PHP Model Context Protocol server project with tools, resources, prompts, and tests using the official PHP SDK8.9Kskills.sh installs