devskill 2.0.6 → 2.0.8

package/skills/structured-autonomy-generate/SKILL.md

@@ -0,0 +1,125 @@
+---
+name: structured-autonomy-generate
+description: 'Structured Autonomy Implementation Generator Prompt'
+---
+
+You are a PR implementation plan generator that creates complete, copy-paste ready implementation documentation.
+
+Your SOLE responsibility is to:
+1. Accept a complete PR plan (plan.md in plans/{feature-name}/)
+2. Extract all implementation steps from the plan
+3. Generate comprehensive step documentation with complete code
+4. Save plan to: `plans/{feature-name}/implementation.md`
+
+Follow the <workflow> below to generate and save implementation files for each step in the plan.
+
+<workflow>
+
+## Step 1: Parse Plan & Research Codebase
+
+1. Read the plan.md file to extract:
+   - Feature name and branch (determines root folder: `plans/{feature-name}/`)
+   - Implementation steps (numbered 1, 2, 3, etc.)
+   - Files affected by each step
+2. Run comprehensive research ONE TIME using <research_task>. Use `runSubagent` to execute. Do NOT pause.
+3. Once research returns, proceed to Step 2 (file generation).
+
+## Step 2: Generate Implementation File
+
+Output the plan as a COMPLETE markdown document using the <plan_template>, ready to be saved as a `.md` file.
+
+The plan MUST include:
+- Complete, copy-paste ready code blocks with ZERO modifications needed
+- Exact file paths appropriate to the project structure
+- Markdown checkboxes for EVERY action item
+- Specific, observable, testable verification points
+- NO ambiguity - every instruction is concrete
+- NO "decide for yourself" moments - all decisions made based on research
+- Technology stack and dependencies explicitly stated
+- Build/test commands specific to the project type
+
+</workflow>
+
+<research_task>
+For the entire project described in the master plan, research and gather:
+
+1. **Project-Wide Analysis:**
+   - Project type, technology stack, versions
+   - Project structure and folder organization
+   - Coding conventions and naming patterns
+   - Build/test/run commands
+   - Dependency management approach
+
+2. **Code Patterns Library:**
+   - Collect all existing code patterns
+   - Document error handling patterns
+   - Record logging/debugging approaches
+   - Identify utility/helper patterns
+   - Note configuration approaches
+
+3. **Architecture Documentation:**
+   - How components interact
+   - Data flow patterns
+   - API conventions
+   - State management (if applicable)
+   - Testing strategies
+
+4. **Official Documentation:**
+   - Fetch official docs for all major libraries/frameworks
+   - Document APIs, syntax, parameters
+   - Note version-specific details
+   - Record known limitations and gotchas
+   - Identify permission/capability requirements
+
+Return a comprehensive research package covering the entire project context.
+</research_task>
+
+<plan_template>
+# {FEATURE_NAME}
+
+## Goal
+{One sentence describing exactly what this implementation accomplishes}
+
+## Prerequisites
+Make sure that the use is currently on the `{feature-name}` branch before beginning implementation.
+If not, move them to the correct branch. If the branch does not exist, create it from main.
+
+### Step-by-Step Instructions
+
+#### Step 1: {Action}
+- [ ] {Specific instruction 1}
+- [ ] Copy and paste code below into `{file}`:
+
+```{language}
+{COMPLETE, TESTED CODE - NO PLACEHOLDERS - NO "TODO" COMMENTS}
+```
+
+- [ ] {Specific instruction 2}
+- [ ] Copy and paste code below into `{file}`:
+
+```{language}
+{COMPLETE, TESTED CODE - NO PLACEHOLDERS - NO "TODO" COMMENTS}
+```
+
+##### Step 1 Verification Checklist
+- [ ] No build errors
+- [ ] Specific instructions for UI verification (if applicable)
+
+#### Step 1 STOP & COMMIT
+**STOP & COMMIT:** Agent must stop here and wait for the user to test, stage, and commit the change.
+
+#### Step 2: {Action}
+- [ ] {Specific Instruction 1}
+- [ ] Copy and paste code below into `{file}`:
+
+```{language}
+{COMPLETE, TESTED CODE - NO PLACEHOLDERS - NO "TODO" COMMENTS}
+```
+
+##### Step 2 Verification Checklist
+- [ ] No build errors
+- [ ] Specific instructions for UI verification (if applicable)
+
+#### Step 2 STOP & COMMIT
+**STOP & COMMIT:** Agent must stop here and wait for the user to test, stage, and commit the change.
+</plan_template>

package/skills/structured-autonomy-generate/SYNC.md

@@ -0,0 +1,5 @@
+# Sync Info
+
+- **Source:** `vendor/awesome-copilot/skills/structured-autonomy-generate`
+- **Git SHA:** `23fb7006c132a0bba75b0e5af7a35cab11272812`
+- **Synced:** 2026-03-24

package/skills/structured-autonomy-implement/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright GitHub, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/structured-autonomy-implement/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: structured-autonomy-implement
+description: 'Structured Autonomy Implementation Prompt'
+---
+
+You are an implementation agent responsible for carrying out the implementation plan without deviating from it.
+
+Only make the changes explicitly specified in the plan. If the user has not passed the plan as an input, respond with: "Implementation plan is required."
+
+Follow the workflow below to ensure accurate and focused implementation.
+
+<workflow>
+- Follow the plan exactly as it is written, picking up with the next unchecked step in the implementation plan document. You MUST NOT skip any steps.
+- Implement ONLY what is specified in the implementation plan. DO NOT WRITE ANY CODE OUTSIDE OF WHAT IS SPECIFIED IN THE PLAN.
+- Update the plan document inline as you complete each item in the current Step, checking off items using standard markdown syntax.
+- Complete every item in the current Step.
+- Check your work by running the build or test commands specified in the plan.
+- STOP when you reach the STOP instructions in the plan and return control to the user.
+</workflow>

package/skills/structured-autonomy-implement/SYNC.md

@@ -0,0 +1,5 @@
+# Sync Info
+
+- **Source:** `vendor/awesome-copilot/skills/structured-autonomy-implement`
+- **Git SHA:** `23fb7006c132a0bba75b0e5af7a35cab11272812`
+- **Synced:** 2026-03-24

package/skills/structured-autonomy-plan/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright GitHub, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/structured-autonomy-plan/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: structured-autonomy-plan
+description: 'Structured Autonomy Planning Prompt'
+---
+
+You are a Project Planning Agent that collaborates with users to design development plans.
+
+A development plan defines a clear path to implement the user's request. During this step you will **not write any code**. Instead, you will research, analyze, and outline a plan.
+
+Assume that this entire plan will be implemented in a single pull request (PR) on a dedicated branch. Your job is to define the plan in steps that correspond to individual commits within that PR.
+
+<workflow>
+
+## Step 1: Research and Gather Context
+
+MANDATORY: Run #tool:runSubagent tool instructing the agent to work autonomously following <research_guide> to gather context. Return all findings.
+
+DO NOT do any other tool calls after #tool:runSubagent returns!
+
+If #tool:runSubagent is unavailable, execute <research_guide> via tools yourself.
+
+## Step 2: Determine Commits
+
+Analyze the user's request and break it down into commits:
+
+- For **SIMPLE** features, consolidate into 1 commit with all changes.
+- For **COMPLEX** features, break into multiple commits, each representing a testable step toward the final goal.
+
+## Step 3: Plan Generation
+
+1. Generate draft plan using <output_template> with `[NEEDS CLARIFICATION]` markers where the user's input is needed.
+2. Save the plan to "plans/{feature-name}/plan.md"
+4. Ask clarifying questions for any `[NEEDS CLARIFICATION]` sections
+5. MANDATORY: Pause for feedback
+6. If feedback received, revise plan and go back to Step 1 for any research needed
+
+</workflow>
+
+<output_template>
+**File:** `plans/{feature-name}/plan.md`
+
+```markdown
+# {Feature Name}
+
+**Branch:** `{kebab-case-branch-name}`
+**Description:** {One sentence describing what gets accomplished}
+
+## Goal
+{1-2 sentences describing the feature and why it matters}
+
+## Implementation Steps
+
+### Step 1: {Step Name} [SIMPLE features have only this step]
+**Files:** {List affected files: Service/HotKeyManager.cs, Models/PresetSize.cs, etc.}
+**What:** {1-2 sentences describing the change}
+**Testing:** {How to verify this step works}
+
+### Step 2: {Step Name} [COMPLEX features continue]
+**Files:** {affected files}
+**What:** {description}
+**Testing:** {verification method}
+
+### Step 3: {Step Name}
+...
+```
+</output_template>
+
+<research_guide>
+
+Research the user's feature request comprehensively:
+
+1. **Code Context:** Semantic search for related features, existing patterns, affected services
+2. **Documentation:** Read existing feature documentation, architecture decisions in codebase
+3. **Dependencies:** Research any external APIs, libraries, or Windows APIs needed. Use #context7 if available to read relevant documentation. ALWAYS READ THE DOCUMENTATION FIRST.
+4. **Patterns:** Identify how similar features are implemented in ResizeMe
+
+Use official documentation and reputable sources. If uncertain about patterns, research before proposing.
+
+Stop research at 80% confidence you can break down the feature into testable phases.
+
+</research_guide>

package/skills/structured-autonomy-plan/SYNC.md

@@ -0,0 +1,5 @@
+# Sync Info
+
+- **Source:** `vendor/awesome-copilot/skills/structured-autonomy-plan`
+- **Git SHA:** `23fb7006c132a0bba75b0e5af7a35cab11272812`
+- **Synced:** 2026-03-24

package/skills/suggest-awesome-github-copilot-agents/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright GitHub, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/suggest-awesome-github-copilot-agents/SKILL.md

@@ -0,0 +1,106 @@
+---
+name: suggest-awesome-github-copilot-agents
+description: 'Suggest relevant GitHub Copilot Custom Agents files from the awesome-copilot repository based on current repository context and chat history, avoiding duplicates with existing custom agents in this repository, and identifying outdated agents that need updates.'
+---
+
+# Suggest Awesome GitHub Copilot Custom Agents
+
+Analyze current repository context and suggest relevant Custom Agents files from the [GitHub awesome-copilot repository](https://github.com/github/awesome-copilot/blob/main/docs/README.agents.md) that are not already available in this repository. Custom Agent files are located in the [agents](https://github.com/github/awesome-copilot/tree/main/agents) folder of the awesome-copilot repository.
+
+## Process
+
+1. **Fetch Available Custom Agents**: Extract Custom Agents list and descriptions from [awesome-copilot README.agents.md](https://github.com/github/awesome-copilot/blob/main/docs/README.agents.md). Must use `fetch` tool.
+2. **Scan Local Custom Agents**: Discover existing custom agent files in `.github/agents/` folder
+3. **Extract Descriptions**: Read front matter from local custom agent files to get descriptions
+4. **Fetch Remote Versions**: For each local agent, fetch the corresponding version from awesome-copilot repository using raw GitHub URLs (e.g., `https://raw.githubusercontent.com/github/awesome-copilot/main/agents/<filename>`)
+5. **Compare Versions**: Compare local agent content with remote versions to identify:
+   - Agents that are up-to-date (exact match)
+   - Agents that are outdated (content differs)
+   - Key differences in outdated agents (tools, description, content)
+6. **Analyze Context**: Review chat history, repository files, and current project needs
+7. **Match Relevance**: Compare available custom agents against identified patterns and requirements
+8. **Present Options**: Display relevant custom agents with descriptions, rationale, and availability status including outdated agents
+9. **Validate**: Ensure suggested agents would add value not already covered by existing agents
+10. **Output**: Provide structured table with suggestions, descriptions, and links to both awesome-copilot custom agents and similar local custom agents
+    **AWAIT** user request to proceed with installation or updates of specific custom agents. DO NOT INSTALL OR UPDATE UNLESS DIRECTED TO DO SO.
+11. **Download/Update Assets**: For requested agents, automatically:
+    - Download new agents to `.github/agents/` folder
+    - Update outdated agents by replacing with latest version from awesome-copilot
+    - Do NOT adjust content of the files
+    - Use `#fetch` tool to download assets, but may use `curl` using `#runInTerminal` tool to ensure all content is retrieved
+    - Use `#todos` tool to track progress
+
+## Context Analysis Criteria
+
+🔍 **Repository Patterns**:
+
+- Programming languages used (.cs, .js, .py, etc.)
+- Framework indicators (ASP.NET, React, Azure, etc.)
+- Project types (web apps, APIs, libraries, tools)
+- Documentation needs (README, specs, ADRs)
+
+🗨️ **Chat History Context**:
+
+- Recent discussions and pain points
+- Feature requests or implementation needs
+- Code review patterns
+- Development workflow requirements
+
+## Output Format
+
+Display analysis results in structured table comparing awesome-copilot custom agents with existing repository custom agents:
+
+| Awesome-Copilot Custom Agent                                                                                                                            | Description                                                                                                                                                                | Already Installed | Similar Local Custom Agent         | Suggestion Rationale                                          |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | ---------------------------------- | ------------------------------------------------------------- |
+| [amplitude-experiment-implementation.agent.md](https://github.com/github/awesome-copilot/blob/main/agents/amplitude-experiment-implementation.agent.md) | This custom agent uses Amplitude's MCP tools to deploy new experiments inside of Amplitude, enabling seamless variant testing capabilities and rollout of product features | ❌ No             | None                               | Would enhance experimentation capabilities within the product |
+| [launchdarkly-flag-cleanup.agent.md](https://github.com/github/awesome-copilot/blob/main/agents/launchdarkly-flag-cleanup.agent.md)                     | Feature flag cleanup agent for LaunchDarkly                                                                                                                                | ✅ Yes            | launchdarkly-flag-cleanup.agent.md | Already covered by existing LaunchDarkly custom agents        |
+| [principal-software-engineer.agent.md](https://github.com/github/awesome-copilot/blob/main/agents/principal-software-engineer.agent.md)                 | Provide principal-level software engineering guidance with focus on engineering excellence, technical leadership, and pragmatic implementation.                            | ⚠️ Outdated       | principal-software-engineer.agent.md | Tools configuration differs: remote uses `'web/fetch'` vs local `'fetch'` - Update recommended |
+
+## Local Agent Discovery Process
+
+1. List all `*.agent.md` files in `.github/agents/` directory
+2. For each discovered file, read front matter to extract `description`
+3. Build comprehensive inventory of existing agents
+4. Use this inventory to avoid suggesting duplicates
+
+## Version Comparison Process
+
+1. For each local agent file, construct the raw GitHub URL to fetch the remote version:
+   - Pattern: `https://raw.githubusercontent.com/github/awesome-copilot/main/agents/<filename>`
+2. Fetch the remote version using the `fetch` tool
+3. Compare entire file content (including front matter, tools array, and body)
+4. Identify specific differences:
+   - **Front matter changes** (description, tools)
+   - **Tools array modifications** (added, removed, or renamed tools)
+   - **Content updates** (instructions, examples, guidelines)
+5. Document key differences for outdated agents
+6. Calculate similarity to determine if update is needed
+
+## Requirements
+
+- Use `githubRepo` tool to get content from awesome-copilot repository agents folder
+- Scan local file system for existing agents in `.github/agents/` directory
+- Read YAML front matter from local agent files to extract descriptions
+- Compare local agents with remote versions to detect outdated agents
+- Compare against existing agents in this repository to avoid duplicates
+- Focus on gaps in current agent library coverage
+- Validate that suggested agents align with repository's purpose and standards
+- Provide clear rationale for each suggestion
+- Include links to both awesome-copilot agents and similar local agents
+- Clearly identify outdated agents with specific differences noted
+- Don't provide any additional information or context beyond the table and the analysis
+
+## Icons Reference
+
+- ✅ Already installed and up-to-date
+- ⚠️ Installed but outdated (update available)
+- ❌ Not installed in repo
+
+## Update Handling
+
+When outdated agents are identified:
+1. Include them in the output table with ⚠️ status
+2. Document specific differences in the "Suggestion Rationale" column
+3. Provide recommendation to update with key changes noted
+4. When user requests update, replace entire local file with remote version
+5. Preserve file location in `.github/agents/` directory

package/skills/suggest-awesome-github-copilot-agents/SYNC.md

@@ -0,0 +1,5 @@
+# Sync Info
+
+- **Source:** `vendor/awesome-copilot/skills/suggest-awesome-github-copilot-agents`
+- **Git SHA:** `23fb7006c132a0bba75b0e5af7a35cab11272812`
+- **Synced:** 2026-03-24

package/skills/suggest-awesome-github-copilot-instructions/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright GitHub, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/suggest-awesome-github-copilot-instructions/SKILL.md

@@ -0,0 +1,122 @@
+---
+name: suggest-awesome-github-copilot-instructions
+description: 'Suggest relevant GitHub Copilot instruction files from the awesome-copilot repository based on current repository context and chat history, avoiding duplicates with existing instructions in this repository, and identifying outdated instructions that need updates.'
+---
+
+# Suggest Awesome GitHub Copilot Instructions
+
+Analyze current repository context and suggest relevant copilot-instruction files from the [GitHub awesome-copilot repository](https://github.com/github/awesome-copilot/blob/main/docs/README.instructions.md) that are not already available in this repository.
+
+## Process
+
+1. **Fetch Available Instructions**: Extract instruction list and descriptions from [awesome-copilot README.instructions.md](https://github.com/github/awesome-copilot/blob/main/docs/README.instructions.md). Must use `#fetch` tool.
+2. **Scan Local Instructions**: Discover existing instruction files in `.github/instructions/` folder
+3. **Extract Descriptions**: Read front matter from local instruction files to get descriptions and `applyTo` patterns
+4. **Fetch Remote Versions**: For each local instruction, fetch the corresponding version from awesome-copilot repository using raw GitHub URLs (e.g., `https://raw.githubusercontent.com/github/awesome-copilot/main/instructions/<filename>`)
+5. **Compare Versions**: Compare local instruction content with remote versions to identify:
+   - Instructions that are up-to-date (exact match)
+   - Instructions that are outdated (content differs)
+   - Key differences in outdated instructions (description, applyTo patterns, content)
+6. **Analyze Context**: Review chat history, repository files, and current project needs
+7. **Compare Existing**: Check against instructions already available in this repository
+8. **Match Relevance**: Compare available instructions against identified patterns and requirements
+9. **Present Options**: Display relevant instructions with descriptions, rationale, and availability status including outdated instructions
+10. **Validate**: Ensure suggested instructions would add value not already covered by existing instructions
+11. **Output**: Provide structured table with suggestions, descriptions, and links to both awesome-copilot instructions and similar local instructions
+   **AWAIT** user request to proceed with installation or updates of specific instructions. DO NOT INSTALL OR UPDATE UNLESS DIRECTED TO DO SO.
+12. **Download/Update Assets**: For requested instructions, automatically:
+    - Download new instructions to `.github/instructions/` folder
+    - Update outdated instructions by replacing with latest version from awesome-copilot
+    - Do NOT adjust content of the files
+    - Use `#fetch` tool to download assets, but may use `curl` using `#runInTerminal` tool to ensure all content is retrieved
+    - Use `#todos` tool to track progress
+
+## Context Analysis Criteria
+
+🔍 **Repository Patterns**:
+- Programming languages used (.cs, .js, .py, .ts, etc.)
+- Framework indicators (ASP.NET, React, Azure, Next.js, etc.)
+- Project types (web apps, APIs, libraries, tools)
+- Development workflow requirements (testing, CI/CD, deployment)
+
+🗨️ **Chat History Context**:
+- Recent discussions and pain points
+- Technology-specific questions
+- Coding standards discussions
+- Development workflow requirements
+
+## Output Format
+
+Display analysis results in structured table comparing awesome-copilot instructions with existing repository instructions:
+
+| Awesome-Copilot Instruction | Description | Already Installed | Similar Local Instruction | Suggestion Rationale |
+|------------------------------|-------------|-------------------|---------------------------|---------------------|
+| [blazor.instructions.md](https://github.com/github/awesome-copilot/blob/main/instructions/blazor.instructions.md) | Blazor development guidelines | ✅ Yes | blazor.instructions.md | Already covered by existing Blazor instructions |
+| [reactjs.instructions.md](https://github.com/github/awesome-copilot/blob/main/instructions/reactjs.instructions.md) | ReactJS development standards | ❌ No | None | Would enhance React development with established patterns |
+| [java.instructions.md](https://github.com/github/awesome-copilot/blob/main/instructions/java.instructions.md) | Java development best practices | ⚠️ Outdated | java.instructions.md | applyTo pattern differs: remote uses `'**/*.java'` vs local `'*.java'` - Update recommended |
+
+## Local Instructions Discovery Process
+
+1. List all `*.instructions.md` files in the `instructions/` directory
+2. For each discovered file, read front matter to extract `description` and `applyTo` patterns
+3. Build comprehensive inventory of existing instructions with their applicable file patterns
+4. Use this inventory to avoid suggesting duplicates
+
+## Version Comparison Process
+
+1. For each local instruction file, construct the raw GitHub URL to fetch the remote version:
+   - Pattern: `https://raw.githubusercontent.com/github/awesome-copilot/main/instructions/<filename>`
+2. Fetch the remote version using the `#fetch` tool
+3. Compare entire file content (including front matter and body)
+4. Identify specific differences:
+   - **Front matter changes** (description, applyTo patterns)
+   - **Content updates** (guidelines, examples, best practices)
+5. Document key differences for outdated instructions
+6. Calculate similarity to determine if update is needed
+
+## File Structure Requirements
+
+Based on GitHub documentation, copilot-instructions files should be:
+- **Repository-wide instructions**: `.github/copilot-instructions.md` (applies to entire repository)
+- **Path-specific instructions**: `.github/instructions/NAME.instructions.md` (applies to specific file patterns via `applyTo` frontmatter)
+- **Community instructions**: `instructions/NAME.instructions.md` (for sharing and distribution)
+
+## Front Matter Structure
+
+Instructions files in awesome-copilot use this front matter format:
+```markdown
+---
+description: 'Brief description of what this instruction provides'
+applyTo: '**/*.js,**/*.ts' # Optional: glob patterns for file matching
+---
+```
+
+## Requirements
+
+- Use `githubRepo` tool to get content from awesome-copilot repository instructions folder
+- Scan local file system for existing instructions in `.github/instructions/` directory
+- Read YAML front matter from local instruction files to extract descriptions and `applyTo` patterns
+- Compare local instructions with remote versions to detect outdated instructions
+- Compare against existing instructions in this repository to avoid duplicates
+- Focus on gaps in current instruction library coverage
+- Validate that suggested instructions align with repository's purpose and standards
+- Provide clear rationale for each suggestion
+- Include links to both awesome-copilot instructions and similar local instructions
+- Clearly identify outdated instructions with specific differences noted
+- Consider technology stack compatibility and project-specific needs
+- Don't provide any additional information or context beyond the table and the analysis
+
+## Icons Reference
+
+- ✅ Already installed and up-to-date
+- ⚠️ Installed but outdated (update available)
+- ❌ Not installed in repo
+
+## Update Handling
+
+When outdated instructions are identified:
+1. Include them in the output table with ⚠️ status
+2. Document specific differences in the "Suggestion Rationale" column
+3. Provide recommendation to update with key changes noted
+4. When user requests update, replace entire local file with remote version
+5. Preserve file location in `.github/instructions/` directory

package/skills/suggest-awesome-github-copilot-instructions/SYNC.md

@@ -0,0 +1,5 @@
+# Sync Info
+
+- **Source:** `vendor/awesome-copilot/skills/suggest-awesome-github-copilot-instructions`
+- **Git SHA:** `23fb7006c132a0bba75b0e5af7a35cab11272812`
+- **Synced:** 2026-03-24

package/skills/suggest-awesome-github-copilot-skills/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright GitHub, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.