#!/usr/bin/env node const fs = require("fs"); const path = require("path"); // Template sections for the README const TEMPLATES = { header: `# 🤖 Awesome GitHub Copilot Customizations Enhance your GitHub Copilot experience with community-contributed instructions, prompts, and configurations. Get consistent AI assistance that follows your team's coding standards and project requirements. ## 🎯 GitHub Copilot Customization Features GitHub Copilot provides three main ways to customize AI responses and tailor assistance to your specific workflows, team guidelines, and project requirements: | **🔧 Custom Instructions** | **📝 Reusable Prompts** | **🧩 Custom Chat Modes** | | --- | --- | --- | | Define common guidelines for tasks like code generation, reviews, and commit messages. Describe *how* tasks should be performed

**Benefits:**
• Automatic inclusion in every chat request
• Repository-wide consistency
• Multiple implementation options | Create reusable, standalone prompts for specific tasks. Describe *what* should be done with optional task-specific guidelines

**Benefits:**
• Eliminate repetitive prompt writing
• Shareable across teams
• Support for variables and dependencies | Define chat behavior, available tools, and codebase interaction patterns within specific boundaries for each request

**Benefits:**
• Context-aware assistance
• Tool configuration
• Role-specific workflows | > **💡 Pro Tip:** Custom instructions only affect Copilot Chat (not inline code completions). You can combine all three customization types - use custom instructions for general guidelines, prompt files for specific tasks, and chat modes to control the interaction context. ## 📝 Contributing We welcome contributions! Please see our [Contributing Guide](./CONTRIBUTING.md) for details on how to submit new instructions and prompts.`, instructionsSection: `## 📋 Custom Instructions Team and project-specific instructions to enhance GitHub Copilot's behavior for specific technologies and coding practices:`, instructionsUsage: `> 💡 **Usage**: Copy these instructions to your \`.github/copilot-instructions.md\` file or create task-specific \`.github/.instructions.md\` files in your workspace's \`.github/instructions\` folder.`, promptsSection: `## 🎯 Reusable Prompts Ready-to-use prompt templates for specific development scenarios and tasks, defining prompt text with a specific mode, model, and available set of tools.`, promptsUsage: `> 💡 **Usage**: Use \`/prompt-name\` in VS Code chat, run \`Chat: Run Prompt\` command, or hit the run button while you have a prompt open.`, chatmodesSection: `## 🧩 Custom Chat Modes Custom chat modes define specific behaviors and tools for GitHub Copilot Chat, enabling enhanced context-aware assistance for particular tasks or workflows.`, chatmodesUsage: `> 💡 **Usage**: Create new chat modes using the command \`Chat: Configure Chat Modes...\`, then switch your chat mode in the Chat input from _Agent_ or _Ask_ to your own mode.`, footer: `## 📚 Additional Resources - [VS Code Copilot Customization Documentation](https://code.visualstudio.com/docs/copilot/copilot-customization) - Official Microsoft documentation - [GitHub Copilot Chat Documentation](https://code.visualstudio.com/docs/copilot/chat/copilot-chat) - Complete chat feature guide - [Custom Chat Modes](https://code.visualstudio.com/docs/copilot/chat/chat-modes) - Advanced chat configuration - [VS Code Settings](https://code.visualstudio.com/docs/getstarted/settings) - General VS Code configuration guide ## 🛠️ Development Configuration This repository uses various configuration files to ensure consistent code style and avoid issues with line endings: - [\`.editorconfig\`](.editorconfig) - Defines coding styles across different editors and IDEs - [\`.gitattributes\`](.gitattributes) - Ensures consistent line endings in text files - [\`.vscode/settings.json\`](.vscode/settings.json) - VS Code-specific settings for this repository - [\`.vscode/extensions.json\`](.vscode/extensions.json) - Recommended VS Code extensions > 💡 **Note**: All markdown files in this repository use LF line endings (Unix-style) to avoid mixed line endings issues. The repository is configured to automatically handle line endings conversion. ## 📄 License This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. ## 🤝 Code of Conduct Please note that this project is released with a [Contributor Code of Conduct](CODE_OF_CONDUCT.md). By participating in this project you agree to abide by its terms. ## ™️ Trademarks This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow [Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general). Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.`, }; // Add error handling utility function safeFileOperation(operation, filePath, defaultValue = null) { try { return operation(); } catch (error) { console.error(`Error processing file ${filePath}: ${error.message}`); return defaultValue; } } function extractTitle(filePath) { return safeFileOperation( () => { const content = fs.readFileSync(filePath, "utf8"); const lines = content.split("\n"); // Step 1: Look for title in frontmatter for all file types let inFrontmatter = false; let frontmatterEnded = false; for (const line of lines) { if (line.trim() === "---") { if (!inFrontmatter) { inFrontmatter = true; } else if (!frontmatterEnded) { frontmatterEnded = true; } continue; } if (inFrontmatter && !frontmatterEnded) { // Look for title field in frontmatter if (line.includes("title:")) { // Extract everything after 'title:' const afterTitle = line .substring(line.indexOf("title:") + 6) .trim(); // Remove quotes if present const cleanTitle = afterTitle.replace(/^['"]|['"]$/g, ""); return cleanTitle; } } } // Reset for second pass inFrontmatter = false; frontmatterEnded = false; // Step 2: For prompt/chatmode/instructions files, look for heading after frontmatter if ( filePath.includes(".prompt.md") || filePath.includes(".chatmode.md") || filePath.includes(".instructions.md") ) { for (const line of lines) { if (line.trim() === "---") { if (!inFrontmatter) { inFrontmatter = true; } else if (inFrontmatter && !frontmatterEnded) { frontmatterEnded = true; } continue; } if (frontmatterEnded && line.startsWith("# ")) { return line.substring(2).trim(); } } // Step 3: Format filename for prompt/chatmode/instructions files if no heading found const basename = path.basename( filePath, filePath.includes(".prompt.md") ? ".prompt.md" : filePath.includes(".chatmode.md") ? ".chatmode.md" : ".instructions.md" ); return basename .replace(/[-_]/g, " ") .replace(/\b\w/g, (l) => l.toUpperCase()); } // Step 4: For instruction files, look for the first heading for (const line of lines) { if (line.startsWith("# ")) { return line.substring(2).trim(); } } // Step 5: Fallback to filename const basename = path.basename(filePath, path.extname(filePath)); return basename .replace(/[-_]/g, " ") .replace(/\b\w/g, (l) => l.toUpperCase()); }, filePath, path .basename(filePath, path.extname(filePath)) .replace(/[-_]/g, " ") .replace(/\b\w/g, (l) => l.toUpperCase()) ); } function extractDescription(filePath) { return safeFileOperation( () => { const content = fs.readFileSync(filePath, "utf8"); // Parse frontmatter for description (for both prompts and instructions) const lines = content.split("\n"); let inFrontmatter = false; let frontmatterEnded = false; // For multi-line descriptions let isMultilineDescription = false; let multilineDescription = []; for (let i = 0; i < lines.length; i++) { const line = lines[i]; if (line.trim() === "---") { if (!inFrontmatter) { inFrontmatter = true; } else if (inFrontmatter && !frontmatterEnded) { frontmatterEnded = true; break; } continue; } if (inFrontmatter && !frontmatterEnded) { // Check for multi-line description with pipe syntax (|) const multilineMatch = line.match(/^description:\s*\|(\s*)$/); if (multilineMatch) { isMultilineDescription = true; // Continue to next line to start collecting the multi-line content continue; } // If we're collecting a multi-line description if (isMultilineDescription) { // If the line has no indentation or has another frontmatter key, stop collecting if (!line.startsWith(" ") || line.match(/^[a-zA-Z0-9_-]+:/)) { isMultilineDescription = false; // Join the collected lines and return return multilineDescription.join(" ").trim(); } // Add the line to our multi-line collection (removing the 2-space indentation) multilineDescription.push(line.substring(2)); } else { // Look for single-line description field in frontmatter const descriptionMatch = line.match( /^description:\s*['"]?(.+?)['"]?$/ ); if (descriptionMatch) { return descriptionMatch[1]; } } } } // If we've collected multi-line description but the frontmatter ended if (multilineDescription.length > 0) { return multilineDescription.join(" ").trim(); } return null; }, filePath, null ); } /** * Collect metadata for all files in a directory */ function collectFileMetadata(dirPath, fileExtension, urlPrefix) { if (!fs.existsSync(dirPath)) { return []; } const files = fs .readdirSync(dirPath) .filter((file) => file.endsWith(fileExtension)) .sort(); return files.map((file) => { const filePath = path.join(dirPath, file); const title = extractTitle(filePath); const description = extractDescription(filePath); const link = encodeURI(`${urlPrefix}/${file}`); return { filename: file, title, description, link }; }); } /** * Helper function to deduce file path from filename and type */ function getFilePath(filename, type) { const typeToDir = { 'instructions': 'instructions', 'prompts': 'prompts', 'chatmodes': 'chatmodes' }; const dirName = typeToDir[type]; return dirName ? path.join(__dirname, dirName, filename) : null; } /** * Generate fallback description for instructions */ function generateFallbackDescription(title, type) { if (type === 'instructions') { const topic = title.split(" ").pop().replace(/s$/, ""); return `${topic} specific coding standards and best practices`; } return null; } /** * Create comprehensive index of all copilot customizations */ function createIndex() { const instructionsDir = path.join(__dirname, "instructions"); const promptsDir = path.join(__dirname, "prompts"); const chatmodesDir = path.join(__dirname, "chatmodes"); const instructions = collectFileMetadata(instructionsDir, ".md", "instructions"); const prompts = collectFileMetadata(promptsDir, ".prompt.md", "prompts"); const chatmodes = collectFileMetadata(chatmodesDir, ".chatmode.md", "chatmodes"); console.log(`Found ${instructions.length} instruction files`); console.log(`Found ${prompts.length} prompt files`); console.log(`Found ${chatmodes.length} chat mode files`); return { generated: new Date().toISOString(), instructions, prompts, chatmodes }; } /** * Generate the instructions section from index data */ function generateInstructionsSection(indexData) { const { instructions } = indexData; let instructionsContent = ""; for (const item of instructions) { const { title, link, description } = item; if (description && description !== "null") { instructionsContent += `- [${title}](${link}) - ${description}\n`; } else { const fallbackDesc = generateFallbackDescription(title, 'instructions'); instructionsContent += `- [${title}](${link}) - ${fallbackDesc}\n`; } } return `${TEMPLATES.instructionsSection}\n\n${instructionsContent}\n${TEMPLATES.instructionsUsage}`; } /** * Generate the prompts section from index data */ function generatePromptsSection(indexData) { const { prompts } = indexData; let promptsContent = ""; for (const item of prompts) { const { title, link, description } = item; if (description && description !== "null") { promptsContent += `- [${title}](${link}) - ${description}\n`; } else { promptsContent += `- [${title}](${link})\n`; } } return `${TEMPLATES.promptsSection}\n\n${promptsContent}\n${TEMPLATES.promptsUsage}`; } /** * Generate the chat modes section from index data */ function generateChatModesSection(indexData) { const { chatmodes } = indexData; // If no chat modes, return empty string if (chatmodes.length === 0) { return ""; } let chatmodesContent = ""; for (const item of chatmodes) { const { title, link, description } = item; if (description && description !== "null") { chatmodesContent += `- [${title}](${link}) - ${description}\n`; } else { chatmodesContent += `- [${title}](${link})\n`; } } return `${TEMPLATES.chatmodesSection}\n\n${chatmodesContent}\n${TEMPLATES.chatmodesUsage}`; } /** * Generate the complete README.md content from index data */ function generateReadme(indexData) { // Generate each section const instructionsSection = generateInstructionsSection(indexData); const promptsSection = generatePromptsSection(indexData); const chatmodesSection = generateChatModesSection(indexData); // Build the complete README content with template sections let readmeContent = [TEMPLATES.header, instructionsSection, promptsSection]; // Only include chat modes section if we have any chat modes if (chatmodesSection) { readmeContent.push(chatmodesSection); } // Add footer readmeContent.push(TEMPLATES.footer); return readmeContent.join("\n\n"); } // Main execution try { console.log("Creating index.json and generating README.md..."); // Step 1: Create the comprehensive index const indexData = createIndex(); // Step 2: Write index.json const indexPath = path.join(__dirname, "index.json"); fs.writeFileSync(indexPath, JSON.stringify(indexData, null, 2)); console.log("index.json created successfully!"); // Step 3: Generate README from index data const readmePath = path.join(__dirname, "README.md"); const newReadmeContent = generateReadme(indexData); // Check if the README file already exists if (fs.existsSync(readmePath)) { const originalContent = fs.readFileSync(readmePath, "utf8"); const hasChanges = originalContent !== newReadmeContent; if (hasChanges) { fs.writeFileSync(readmePath, newReadmeContent); console.log("README.md updated successfully!"); } else { console.log("README.md is already up to date. No changes needed."); } } else { // Create the README file if it doesn't exist fs.writeFileSync(readmePath, newReadmeContent); console.log("README.md created successfully!"); } } catch (error) { console.error(`Error generating files: ${error.message}`); process.exit(1); }