Claude Agent Skill · by Github

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 i

Install
Terminal · npx
$npx skills add https://github.com/github/awesome-copilot --skill update-markdown-file-index
Works with Paperclip

How Update Markdown File Index fits into a Paperclip company.

Update Markdown File Index drops into any Paperclip agent that handles this kind of work. Assign it to a specialist inside a pre-configured PaperclipOrg company and the skill becomes available on every heartbeat — no prompt engineering, no tool wiring.

S
SaaS FactoryPaired

Pre-configured AI company — 18 agents, 18 skills, one-time purchase.

$27$59
Explore pack
Source file
SKILL.md76 lines
Expand
---name: update-markdown-file-indexdescription: 'Update a markdown file section with an index/table of files from a specified folder.'--- # 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 structure2. **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 structure4. **Structure**: Generate appropriate table/list format based on file types and existing content5. **Update**: Replace existing section or add new section with file index6. **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 ```markdown## 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 ## Section Identification Look for existing sections with these patterns: - Headings containing: "index", "files", "contents", "directory", "list"- Tables with file-related columns- Lists with file links- HTML comments marking file index sections ## Requirements - Preserve existing markdown structure and formatting- Use relative paths for file links- Include file descriptions when available- Sort files alphabetically by default- Handle special characters in filenames- Validate all generated markdown syntax