update-markdown-file-index

bởi github

Tạo và duy trì chỉ mục tệp trong tài liệu markdown bằng cách quét thư mục và cập nhật hoặc tạo danh sách tệp có tổ chức. Quét các tệp markdown mục tiêu và phát hiện các tệp khớp với mẫu đã chỉ định trong các thư mục được chỉ định. Tạo ba tùy chọn định dạng bảng: danh sách đơn giản có mô tả, bảng chi tiết có siêu dữ liệu loại/kích thước, hoặc các phần phân loại theo nhóm loại tệp. Tự động xác định các phần chỉ mục hiện có bằng mẫu tiêu đề ("index", "files", "contents") và cập nhật...

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

Tải 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