update-markdown-file-index

par github

Générer et maintenir des index de fichiers dans des documents markdown en analysant les dossiers et en mettant à jour ou créant des listes de fichiers organisées. Analyse les fichiers markdown cibles et découvre les fichiers correspondant aux motifs spécifiés dans les dossiers désignés. Génère trois options de format de tableau : listes simples avec descriptions, tableaux détaillés avec métadonnées de type/taille, ou sections catégorisées regroupées par type de fichier. Identifie automatiquement les sections d'index existantes par motifs d'en-tête ("index", "files", "contents") et met à jour...

npx skills add https://github.com/github/awesome-copilot --skill update-markdown-file-index

Télécharger ZIP GitHub

37.7k

Update Markdown File Index

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

Process

Scan: Read the target markdown file ${file} to understand existing structure
Discover: List all files in the specified folder ${input:folder} matching pattern ${input:pattern}
Analyze: Identify if an existing table/index section exists to update, or create new structure
Structure: Generate appropriate table/list format based on file types and existing content
Update: Replace existing section or add new section with file index
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}

- [filename.ext](path/to/filename.ext) - Description
- [filename2.ext](path/to/filename2.ext) - Description

Option 2: Detailed Table

| File | Type | Description |
|------|------|-------------|
| [filename.ext](path/to/filename.ext) | Extension | Description |
| [filename2.ext](path/to/filename2.ext) | Extension | Description |

Option 3: Categorized Sections

Group files by type/category with separate sections or sub-tables.

Update Strategy

🔄 Update existing: If table/index section exists, replace content while preserving structure
➕ Add new: If no existing section, create new section using best-fit format
📋 Preserve: Maintain existing markdown formatting, heading levels, and document flow
🔗 Links: Use relative paths for file links within the repository