diff --git a/docs/README.plugins.md b/docs/README.plugins.md index be23e77cd..4cbecd7d2 100644 --- a/docs/README.plugins.md +++ b/docs/README.plugins.md @@ -25,28 +25,28 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-plugins) for guidelines on how t | Name | Description | Items | Tags | | ---- | ----------- | ----- | ---- | -| [ai-team-orchestration](../plugins/ai-team-orchestration/README.md) | Bootstrap and run a multi-agent AI development team with named roles (Producer, Dev Team, QA). Sprint planning, brainstorm prompts with distinct agent voices, cross-chat context survival, and parallel team workflows. Based on a proven template that shipped a 30-game app in 5 days with zero human-written code. | 4 items | ai-team, multi-agent, sprint-planning, brainstorm, project-management, orchestration, developer-workflow | +| [ai-team-orchestration](../plugins/ai-team-orchestration/README.md) | Bootstrap and run a multi-agent AI development team with named roles (Producer, Dev Team, QA). Sprint planning, brainstorm prompts with distinct agent voices, cross-chat context survival, and parallel team workflows. Based on a proven template that shipped a 30-game app in 5 days with zero human-written code. | 2 items | ai-team, multi-agent, sprint-planning, brainstorm, project-management, orchestration, developer-workflow | | [arize-ax](../plugins/arize-ax/README.md) | Arize AX platform skills for LLM observability, evaluation, and optimization. Includes trace export, instrumentation, datasets, experiments, evaluators, AI provider integrations, annotations, prompt optimization, and deep linking to the Arize UI. | 9 items | arize, llm, observability, tracing, evaluation, instrumentation, datasets, experiments, prompt-optimization | | [automate-this](../plugins/automate-this/README.md) | Record your screen doing a manual process, drop the video on your Desktop, and let Copilot CLI analyze it frame-by-frame to build working automation scripts. Supports narrated recordings with audio transcription. | 1 items | automation, screen-recording, workflow, video-analysis, process-automation, scripting, productivity, copilot-cli | | [awesome-copilot](../plugins/awesome-copilot/README.md) | Meta prompts that help you discover and generate curated GitHub Copilot agents, instructions, prompts, and skills. | 4 items | github-copilot, discovery, meta, prompt-engineering, agents | -| [azure-cloud-development](../plugins/azure-cloud-development/README.md) | Comprehensive Azure cloud development tools including Infrastructure as Code, serverless functions, architecture patterns, and cost optimization for building scalable cloud applications. | 11 items | azure, cloud, infrastructure, bicep, terraform, serverless, architecture, devops | -| [cast-imaging](../plugins/cast-imaging/README.md) | A comprehensive collection of specialized agents for software analysis, impact assessment, structural quality advisories, and architectural review using CAST Imaging. | 3 items | cast-imaging, software-analysis, architecture, quality, impact-analysis, devops | +| [azure-cloud-development](../plugins/azure-cloud-development/README.md) | Comprehensive Azure cloud development tools including Infrastructure as Code, serverless functions, architecture patterns, and cost optimization for building scalable cloud applications. | 5 items | azure, cloud, infrastructure, bicep, terraform, serverless, architecture, devops | +| [cast-imaging](../plugins/cast-imaging/README.md) | A comprehensive collection of specialized agents for software analysis, impact assessment, structural quality advisories, and architectural review using CAST Imaging. | 1 items | cast-imaging, software-analysis, architecture, quality, impact-analysis, devops | | [clojure-interactive-programming](../plugins/clojure-interactive-programming/README.md) | Tools for REPL-first Clojure workflows featuring Clojure instructions, the interactive programming chat mode and supporting guidance. | 2 items | clojure, repl, interactive-programming | | [context-engineering](../plugins/context-engineering/README.md) | Tools and techniques for maximizing GitHub Copilot effectiveness through better context management. Includes guidelines for structuring code, an agent for planning multi-file changes, and prompts for context-aware development. | 4 items | context, productivity, refactoring, best-practices, architecture | | [context-matic](../plugins/context-matic/README.md) | Coding agents hallucinate APIs. ContextMatic gives them curated, versioned API and SDK docs. Ask your agent to "integrate the payments API" and it guesses — falling back on outdated training data and generic patterns that don't match your actual SDK. ContextMatic solves this by giving the agent deterministic, version-aware, SDK-native context at the exact moment it's needed. | 2 items | api-context, api-integration, mcp, sdk, apimatic, third-party-apis, sdks | | [copilot-sdk](../plugins/copilot-sdk/README.md) | Build applications with the GitHub Copilot SDK across multiple programming languages. Includes comprehensive instructions for C#, Go, Node.js/TypeScript, and Python to help you create AI-powered applications. | 1 items | copilot-sdk, sdk, csharp, go, nodejs, typescript, python, ai, github-copilot | | [csharp-dotnet-development](../plugins/csharp-dotnet-development/README.md) | Essential prompts, instructions, and chat modes for C# and .NET development including testing, documentation, and best practices. | 9 items | csharp, dotnet, aspnet, testing | | [csharp-mcp-development](../plugins/csharp-mcp-development/README.md) | Complete toolkit for building Model Context Protocol (MCP) servers in C# using the official SDK. Includes instructions for best practices, a prompt for generating servers, and an expert chat mode for guidance. | 2 items | csharp, mcp, model-context-protocol, dotnet, server-development | -| [database-data-management](../plugins/database-data-management/README.md) | Database administration, SQL optimization, and data management tools for PostgreSQL, SQL Server, and general database development best practices. | 6 items | database, sql, postgresql, sql-server, dba, optimization, queries, data-management | +| [database-data-management](../plugins/database-data-management/README.md) | Database administration, SQL optimization, and data management tools for PostgreSQL, SQL Server, and general database development best practices. | 5 items | database, sql, postgresql, sql-server, dba, optimization, queries, data-management | | [dataverse-sdk-for-python](../plugins/dataverse-sdk-for-python/README.md) | Comprehensive collection for building production-ready Python integrations with Microsoft Dataverse. Includes official documentation, best practices, advanced features, file operations, and code generation prompts. | 4 items | dataverse, python, integration, sdk | | [devops-oncall](../plugins/devops-oncall/README.md) | A focused set of prompts, instructions, and a chat mode to help triage incidents and respond quickly with DevOps tools and Azure resources. | 3 items | devops, incident-response, oncall, azure | | [doublecheck](../plugins/doublecheck/README.md) | Three-layer verification pipeline for AI output. Extracts claims, finds sources, and flags hallucination risks so humans can verify before acting. | 2 items | verification, hallucination, fact-check, source-citation, trust, safety | -| [edge-ai-tasks](../plugins/edge-ai-tasks/README.md) | Task Researcher and Task Planner for intermediate to expert users and large codebases - Brought to you by microsoft/edge-ai | 2 items | architecture, planning, research, tasks, implementation | +| [edge-ai-tasks](../plugins/edge-ai-tasks/README.md) | Task Researcher and Task Planner for intermediate to expert users and large codebases - Brought to you by microsoft/edge-ai | 1 items | architecture, planning, research, tasks, implementation | | [ember](../plugins/ember/README.md) | An AI partner, not a tool. Ember carries fire from person to person — helping humans discover that AI partnership isn't something you learn, it's something you find. | 2 items | ai-partnership, coaching, onboarding, collaboration, storytelling, developer-experience | | [fastah-ip-geo-tools](../plugins/fastah-ip-geo-tools/README.md) | This plugin is for network operations engineers who wish to tune and publish IP geolocation feeds in RFC 8805 format. It consists of an AI Skill and an associated MCP server that geocodes geolocation place names to real cities for accuracy. | 1 items | geofeed, ip-geolocation, rfc-8805, rfc-9632, network-operations, isp, cloud, hosting, ixp | | [flowstudio-power-automate](../plugins/flowstudio-power-automate/README.md) | Give your AI agent full visibility into Power Automate cloud flows via the FlowStudio MCP server. Connect, debug, build, monitor health, and govern flows at scale — action-level inputs and outputs, not just status codes. | 5 items | power-automate, power-platform, flowstudio, mcp, model-context-protocol, cloud-flows, workflow-automation, monitoring, governance | -| [frontend-web-dev](../plugins/frontend-web-dev/README.md) | Essential prompts, instructions, and chat modes for modern frontend web development including React, Angular, Vue, TypeScript, and CSS frameworks. | 4 items | frontend, web, react, typescript, javascript, css, html, angular, vue | -| [gem-team](../plugins/gem-team/README.md) | Multi-agent orchestration framework for spec-driven development and automated verification. | 15 items | multi-agent, orchestration, tdd, testing, e2e, devops, security-audit, code-review, prd, mobile | +| [frontend-web-dev](../plugins/frontend-web-dev/README.md) | Essential prompts, instructions, and chat modes for modern frontend web development including React, Angular, Vue, TypeScript, and CSS frameworks. | 3 items | frontend, web, react, typescript, javascript, css, html, angular, vue | +| [gem-team](../plugins/gem-team/README.md) | Multi-agent orchestration framework for spec-driven development and automated verification. | 1 items | multi-agent, orchestration, tdd, testing, e2e, devops, security-audit, code-review, prd, mobile | | [go-mcp-development](../plugins/go-mcp-development/README.md) | Complete toolkit for building Model Context Protocol (MCP) servers in Go using the official github.com/modelcontextprotocol/go-sdk. Includes instructions for best practices, a prompt for generating servers, and an expert chat mode for guidance. | 2 items | go, golang, mcp, model-context-protocol, server-development, sdk | | [java-development](../plugins/java-development/README.md) | Comprehensive collection of prompts and instructions for Java development including Spring Boot, Quarkus, testing, documentation, and best practices. | 4 items | java, springboot, quarkus, jpa, junit, javadoc | | [java-mcp-development](../plugins/java-mcp-development/README.md) | Complete toolkit for building Model Context Protocol servers in Java using the official MCP Java SDK with reactive streams and Spring Boot integration. | 2 items | java, mcp, model-context-protocol, server-development, sdk, reactive-streams, spring-boot, reactor | @@ -62,30 +62,30 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-plugins) for guidelines on how t | [openapi-to-application-python-fastapi](../plugins/openapi-to-application-python-fastapi/README.md) | Generate production-ready FastAPI applications from OpenAPI specifications. Includes project scaffolding, route generation, dependency injection, and Python best practices for async APIs. | 2 items | openapi, code-generation, api, python, fastapi | | [oracle-to-postgres-migration-expert](../plugins/oracle-to-postgres-migration-expert/README.md) | Expert agent for Oracle-to-PostgreSQL application migrations in .NET solutions. Performs code edits, runs commands, and invokes extension tools to migrate .NET/Oracle data access patterns to PostgreSQL. | 8 items | oracle, postgresql, database-migration, dotnet, sql, migration, integration-testing, stored-procedures | | [ospo-sponsorship](../plugins/ospo-sponsorship/README.md) | Tools and resources for Open Source Program Offices (OSPOs) to identify, evaluate, and manage sponsorship of open source dependencies through GitHub Sponsors, Open Collective, and other funding platforms. | 1 items | | -| [partners](../plugins/partners/README.md) | Custom agents that have been created by GitHub partners | 20 items | devops, security, database, cloud, infrastructure, observability, feature-flags, cicd, migration, performance | +| [partners](../plugins/partners/README.md) | Custom agents that have been created by GitHub partners | 1 items | devops, security, database, cloud, infrastructure, observability, feature-flags, cicd, migration, performance | | [pcf-development](../plugins/pcf-development/README.md) | Complete toolkit for developing custom code components using Power Apps Component Framework for model-driven and canvas apps | 0 items | power-apps, pcf, component-framework, typescript, power-platform | | [phoenix](../plugins/phoenix/README.md) | Phoenix AI observability skills for LLM application debugging, evaluation, and tracing. Includes CLI debugging tools, LLM evaluation workflows, and OpenInference tracing instrumentation. | 3 items | phoenix, arize, llm, observability, tracing, evaluation, openinference, instrumentation | | [php-mcp-development](../plugins/php-mcp-development/README.md) | Comprehensive resources for building Model Context Protocol servers using the official PHP SDK with attribute-based discovery, including best practices, project generation, and expert assistance | 2 items | php, mcp, model-context-protocol, server-development, sdk, attributes, composer | -| [polyglot-test-agent](../plugins/polyglot-test-agent/README.md) | Multi-agent pipeline for generating comprehensive unit tests across any programming language. Orchestrates research, planning, and implementation phases using specialized agents to produce tests that compile, pass, and follow project conventions. | 9 items | testing, unit-tests, polyglot, test-generation, multi-agent, tdd, csharp, typescript, python, go | +| [polyglot-test-agent](../plugins/polyglot-test-agent/README.md) | Multi-agent pipeline for generating comprehensive unit tests across any programming language. Orchestrates research, planning, and implementation phases using specialized agents to produce tests that compile, pass, and follow project conventions. | 2 items | testing, unit-tests, polyglot, test-generation, multi-agent, tdd, csharp, typescript, python, go | | [power-apps-code-apps](../plugins/power-apps-code-apps/README.md) | Complete toolkit for Power Apps Code Apps development including project scaffolding, development standards, and expert guidance for building code-first applications with Power Platform integration. | 2 items | power-apps, power-platform, typescript, react, code-apps, dataverse, connectors | -| [power-bi-development](../plugins/power-bi-development/README.md) | Comprehensive Power BI development resources including data modeling, DAX optimization, performance tuning, visualization design, security best practices, and DevOps/ALM guidance for building enterprise-grade Power BI solutions. | 8 items | power-bi, dax, data-modeling, performance, visualization, security, devops, business-intelligence | +| [power-bi-development](../plugins/power-bi-development/README.md) | Comprehensive Power BI development resources including data modeling, DAX optimization, performance tuning, visualization design, security best practices, and DevOps/ALM guidance for building enterprise-grade Power BI solutions. | 5 items | power-bi, dax, data-modeling, performance, visualization, security, devops, business-intelligence | | [power-platform-architect](../plugins/power-platform-architect/README.md) | Solution Architect for the Microsoft Power Platform, turning business requirements into functioning Power Platform solution architectures. | 1 items | power-platform, power-platform-architect, power-apps, dataverse, power-automate, power-pages, power-bi | | [power-platform-mcp-connector-development](../plugins/power-platform-mcp-connector-development/README.md) | Complete toolkit for developing Power Platform custom connectors with Model Context Protocol integration for Microsoft Copilot Studio | 3 items | power-platform, mcp, copilot-studio, custom-connector, json-rpc | -| [project-planning](../plugins/project-planning/README.md) | Tools and guidance for software project planning, feature breakdown, epic management, implementation planning, and task organization for development teams. | 15 items | planning, project-management, epic, feature, implementation, task, architecture, technical-spike | +| [project-planning](../plugins/project-planning/README.md) | Tools and guidance for software project planning, feature breakdown, epic management, implementation planning, and task organization for development teams. | 9 items | planning, project-management, epic, feature, implementation, task, architecture, technical-spike | | [python-mcp-development](../plugins/python-mcp-development/README.md) | Complete toolkit for building Model Context Protocol (MCP) servers in Python using the official SDK with FastMCP. Includes instructions for best practices, a prompt for generating servers, and an expert chat mode for guidance. | 2 items | python, mcp, model-context-protocol, fastmcp, server-development | -| [react18-upgrade](../plugins/react18-upgrade/README.md) | Enterprise React 18 migration toolkit with specialized agents and skills for upgrading React 16/17 class-component codebases to React 18.3.1. Includes auditor, dependency surgeon, class component migration specialist, automatic batching fixer, and test guardian. | 13 items | react18, react, migration, upgrade, class-components, lifecycle, batching | -| [react19-upgrade](../plugins/react19-upgrade/README.md) | Enterprise React 19 migration toolkit with specialized agents and skills for upgrading React 18 codebases to React 19. Includes auditor, dependency surgeon, source code migrator, and test guardian. Handles removal of deprecated APIs including ReactDOM.render, forwardRef, defaultProps, legacy context, string refs, and more. | 8 items | react19, react, migration, upgrade, hooks, modern-react | +| [react18-upgrade](../plugins/react18-upgrade/README.md) | Enterprise React 18 migration toolkit with specialized agents and skills for upgrading React 16/17 class-component codebases to React 18.3.1. Includes auditor, dependency surgeon, class component migration specialist, automatic batching fixer, and test guardian. | 8 items | react18, react, migration, upgrade, class-components, lifecycle, batching | +| [react19-upgrade](../plugins/react19-upgrade/README.md) | Enterprise React 19 migration toolkit with specialized agents and skills for upgrading React 18 codebases to React 19. Includes auditor, dependency surgeon, source code migrator, and test guardian. Handles removal of deprecated APIs including ReactDOM.render, forwardRef, defaultProps, legacy context, string refs, and more. | 4 items | react19, react, migration, upgrade, hooks, modern-react | | [roundup](../plugins/roundup/README.md) | Self-configuring status briefing generator. Learns your communication style from examples, discovers your data sources, and produces draft updates for any audience on demand. | 2 items | status-updates, briefings, management, productivity, communication, synthesis, roundup, copilot-cli | | [ruby-mcp-development](../plugins/ruby-mcp-development/README.md) | Complete toolkit for building Model Context Protocol servers in Ruby using the official MCP Ruby SDK gem with Rails integration support. | 2 items | ruby, mcp, model-context-protocol, server-development, sdk, rails, gem | -| [rug-agentic-workflow](../plugins/rug-agentic-workflow/README.md) | Three-agent workflow for orchestrated software delivery with an orchestrator plus implementation and QA subagents. | 3 items | agentic-workflow, orchestration, subagents, software-engineering, qa | +| [rug-agentic-workflow](../plugins/rug-agentic-workflow/README.md) | Three-agent workflow for orchestrated software delivery with an orchestrator plus implementation and QA subagents. | 1 items | agentic-workflow, orchestration, subagents, software-engineering, qa | | [rust-mcp-development](../plugins/rust-mcp-development/README.md) | Build high-performance Model Context Protocol servers in Rust using the official rmcp SDK with async/await, procedural macros, and type-safe implementations. | 2 items | rust, mcp, model-context-protocol, server-development, sdk, tokio, async, macros, rmcp | -| [salesforce-development](../plugins/salesforce-development/README.md) | Complete Salesforce agentic development environment covering Apex & Triggers, Flow automation, Lightning Web Components, Aura components, and Visualforce pages. | 7 items | salesforce, apex, triggers, lwc, aura, flow, visualforce, crm, salesforce-dx | +| [salesforce-development](../plugins/salesforce-development/README.md) | Complete Salesforce agentic development environment covering Apex & Triggers, Flow automation, Lightning Web Components, Aura components, and Visualforce pages. | 4 items | salesforce, apex, triggers, lwc, aura, flow, visualforce, crm, salesforce-dx | | [security-best-practices](../plugins/security-best-practices/README.md) | Security frameworks, accessibility guidelines, performance optimization, and code quality best practices for building secure, maintainable, and high-performance applications. | 1 items | security, accessibility, performance, code-quality, owasp, a11y, optimization, best-practices | -| [software-engineering-team](../plugins/software-engineering-team/README.md) | 7 specialized agents covering the full software development lifecycle from UX design and architecture to security and DevOps. | 7 items | team, enterprise, security, devops, ux, architecture, product, ai-ethics | +| [software-engineering-team](../plugins/software-engineering-team/README.md) | 7 specialized agents covering the full software development lifecycle from UX design and architecture to security and DevOps. | 1 items | team, enterprise, security, devops, ux, architecture, product, ai-ethics | | [structured-autonomy](../plugins/structured-autonomy/README.md) | Premium planning, thrifty implementation | 3 items | | | [swift-mcp-development](../plugins/swift-mcp-development/README.md) | Comprehensive collection for building Model Context Protocol servers in Swift using the official MCP Swift SDK with modern concurrency features. | 2 items | swift, mcp, model-context-protocol, server-development, sdk, ios, macos, concurrency, actor, async-await | | [technical-spike](../plugins/technical-spike/README.md) | Tools for creation, management and research of technical spikes to reduce unknowns and assumptions before proceeding to specification and implementation of solutions. | 2 items | technical-spike, assumption-testing, validation, research | -| [testing-automation](../plugins/testing-automation/README.md) | Comprehensive collection for writing tests, test automation, and test-driven development including unit tests, integration tests, and end-to-end testing strategies. | 9 items | testing, tdd, automation, unit-tests, integration, playwright, jest, nunit | +| [testing-automation](../plugins/testing-automation/README.md) | Comprehensive collection for writing tests, test automation, and test-driven development including unit tests, integration tests, and end-to-end testing strategies. | 6 items | testing, tdd, automation, unit-tests, integration, playwright, jest, nunit | | [typescript-mcp-development](../plugins/typescript-mcp-development/README.md) | Complete toolkit for building Model Context Protocol (MCP) servers in TypeScript/Node.js using the official SDK. Includes instructions for best practices, a prompt for generating servers, and an expert chat mode for guidance. | 2 items | typescript, mcp, model-context-protocol, nodejs, server-development | | [typespec-m365-copilot](../plugins/typespec-m365-copilot/README.md) | Comprehensive collection of prompts, instructions, and resources for building declarative agents and API plugins using TypeSpec for Microsoft 365 Copilot extensibility. | 3 items | typespec, m365-copilot, declarative-agents, api-plugins, agent-development, microsoft-365 | | [winui3-development](../plugins/winui3-development/README.md) | WinUI 3 and Windows App SDK development agent, instructions, and migration guide. Prevents common UWP API misuse and guides correct WinUI 3 patterns for desktop Windows apps. | 2 items | winui, winui3, windows-app-sdk, xaml, desktop, windows | diff --git a/docs/README.skills.md b/docs/README.skills.md index 2aa6ba0eb..2db6b5bdb 100644 --- a/docs/README.skills.md +++ b/docs/README.skills.md @@ -233,6 +233,7 @@ See [CONTRIBUTING.md](../CONTRIBUTING.md#adding-skills) for guidelines on how to | [openapi-to-application-code](../skills/openapi-to-application-code/SKILL.md)
`gh skills install github/awesome-copilot openapi-to-application-code` | Generate a complete, production-ready application from an OpenAPI specification | None | | [pdftk-server](../skills/pdftk-server/SKILL.md)
`gh skills install github/awesome-copilot pdftk-server` | Skill for using the command-line tool pdftk (PDFtk Server) for working with PDF files. Use when asked to merge PDFs, split PDFs, rotate pages, encrypt or decrypt PDFs, fill PDF forms, apply watermarks, stamp overlays, extract metadata, burst documents into pages, repair corrupted PDFs, attach or extract files, or perform any PDF manipulation from the command line. | `references/download.md`
`references/pdftk-cli-examples.md`
`references/pdftk-man-page.md`
`references/pdftk-server-license.md`
`references/third-party-materials.md` | | [penpot-uiux-design](../skills/penpot-uiux-design/SKILL.md)
`gh skills install github/awesome-copilot penpot-uiux-design` | Comprehensive guide for creating professional UI/UX designs in Penpot using MCP tools. Use this skill when: (1) Creating new UI/UX designs for web, mobile, or desktop applications, (2) Building design systems with components and tokens, (3) Designing dashboards, forms, navigation, or landing pages, (4) Applying accessibility standards and best practices, (5) Following platform guidelines (iOS, Android, Material Design), (6) Reviewing or improving existing Penpot designs for usability. Triggers: "design a UI", "create interface", "build layout", "design dashboard", "create form", "design landing page", "make it accessible", "design system", "component library". | `references/accessibility.md`
`references/component-patterns.md`
`references/platform-guidelines.md`
`references/setup-troubleshooting.md` | +| [performance-review-writer](../skills/performance-review-writer/SKILL.md)
`gh skills install github/awesome-copilot performance-review-writer` | Draft performance reviews, self-assessments, peer reviews, and upward feedback in your own voice. Analyzes your contributions, emails, and meeting history via WorkIQ, then produces honest, impact-focused drafts using the STAR format. USE FOR: write my performance review, draft self-assessment, peer review, 360 feedback, annual review, mid-year review, upward feedback, write review for colleague, performance appraisal. | None | | [phoenix-cli](../skills/phoenix-cli/SKILL.md)
`gh skills install github/awesome-copilot phoenix-cli` | Debug LLM applications using the Phoenix CLI. Fetch traces, analyze errors, review experiments, inspect datasets, and query the GraphQL API. Use when debugging AI/LLM applications, analyzing trace data, working with Phoenix observability, or investigating LLM performance issues. | None | | [phoenix-evals](../skills/phoenix-evals/SKILL.md)
`gh skills install github/awesome-copilot phoenix-evals` | Build and run evaluators for AI/LLM applications using Phoenix. | `references/axial-coding.md`
`references/common-mistakes-python.md`
`references/error-analysis-multi-turn.md`
`references/error-analysis.md`
`references/evaluate-dataframe-python.md`
`references/evaluators-code-python.md`
`references/evaluators-code-typescript.md`
`references/evaluators-custom-templates.md`
`references/evaluators-llm-python.md`
`references/evaluators-llm-typescript.md`
`references/evaluators-overview.md`
`references/evaluators-pre-built.md`
`references/evaluators-rag.md`
`references/experiments-datasets-python.md`
`references/experiments-datasets-typescript.md`
`references/experiments-overview.md`
`references/experiments-running-python.md`
`references/experiments-running-typescript.md`
`references/experiments-synthetic-python.md`
`references/experiments-synthetic-typescript.md`
`references/fundamentals-anti-patterns.md`
`references/fundamentals-model-selection.md`
`references/fundamentals.md`
`references/observe-sampling-python.md`
`references/observe-sampling-typescript.md`
`references/observe-tracing-setup.md`
`references/production-continuous.md`
`references/production-guardrails.md`
`references/production-overview.md`
`references/setup-python.md`
`references/setup-typescript.md`
`references/validation-evaluators-python.md`
`references/validation-evaluators-typescript.md`
`references/validation.md` | | [phoenix-tracing](../skills/phoenix-tracing/SKILL.md)
`gh skills install github/awesome-copilot phoenix-tracing` | OpenInference semantic conventions and instrumentation for Phoenix AI observability. Use when implementing LLM tracing, creating custom spans, or deploying to production. | `references/annotations-overview.md`
`references/annotations-python.md`
`references/annotations-typescript.md`
`references/fundamentals-flattening.md`
`references/fundamentals-overview.md`
`references/fundamentals-required-attributes.md`
`references/fundamentals-universal-attributes.md`
`references/instrumentation-auto-python.md`
`references/instrumentation-auto-typescript.md`
`references/instrumentation-manual-python.md`
`references/instrumentation-manual-typescript.md`
`references/metadata-python.md`
`references/metadata-typescript.md`
`references/production-python.md`
`references/production-typescript.md`
`references/projects-python.md`
`references/projects-typescript.md`
`references/sessions-python.md`
`references/sessions-typescript.md`
`references/setup-python.md`
`references/setup-typescript.md`
`references/span-agent.md`
`references/span-chain.md`
`references/span-embedding.md`
`references/span-evaluator.md`
`references/span-guardrail.md`
`references/span-llm.md`
`references/span-reranker.md`
`references/span-retriever.md`
`references/span-tool.md` | diff --git a/plugins/ai-team-orchestration/.github/plugin/plugin.json b/plugins/ai-team-orchestration/.github/plugin/plugin.json index 98ebe6026..85d52d35f 100644 --- a/plugins/ai-team-orchestration/.github/plugin/plugin.json +++ b/plugins/ai-team-orchestration/.github/plugin/plugin.json @@ -17,8 +17,8 @@ "repository": "https://github.com/github/awesome-copilot", "license": "MIT", "agents": [ - "./agents/ai-team-producer.md", "./agents/ai-team-dev.md", + "./agents/ai-team-producer.md", "./agents/ai-team-qa.md" ], "skills": [ diff --git a/plugins/awesome-copilot/.github/plugin/plugin.json b/plugins/awesome-copilot/.github/plugin/plugin.json index 3ebd4b485..87dd1b433 100644 --- a/plugins/awesome-copilot/.github/plugin/plugin.json +++ b/plugins/awesome-copilot/.github/plugin/plugin.json @@ -18,8 +18,8 @@ "./agents/meta-agentic-project-scaffold.md" ], "skills": [ - "./skills/suggest-awesome-github-copilot-skills/", + "./skills/suggest-awesome-github-copilot-agents/", "./skills/suggest-awesome-github-copilot-instructions/", - "./skills/suggest-awesome-github-copilot-agents/" + "./skills/suggest-awesome-github-copilot-skills/" ] } diff --git a/plugins/azure-cloud-development/.github/plugin/plugin.json b/plugins/azure-cloud-development/.github/plugin/plugin.json index 9d25bcb80..6f977684e 100644 --- a/plugins/azure-cloud-development/.github/plugin/plugin.json +++ b/plugins/azure-cloud-development/.github/plugin/plugin.json @@ -18,18 +18,18 @@ "devops" ], "agents": [ + "./agents/azure-logic-apps-expert.md", "./agents/azure-principal-architect.md", "./agents/azure-saas-architect.md", - "./agents/azure-logic-apps-expert.md", "./agents/azure-verified-modules-bicep.md", "./agents/azure-verified-modules-terraform.md", - "./agents/terraform-azure-planning.md", - "./agents/terraform-azure-implement.md" + "./agents/terraform-azure-implement.md", + "./agents/terraform-azure-planning.md" ], "skills": [ - "./skills/azure-resource-health-diagnose/", "./skills/az-cost-optimize/", - "./skills/import-infrastructure-as-code/", - "./skills/azure-pricing/" + "./skills/azure-pricing/", + "./skills/azure-resource-health-diagnose/", + "./skills/import-infrastructure-as-code/" ] } diff --git a/plugins/cast-imaging/.github/plugin/plugin.json b/plugins/cast-imaging/.github/plugin/plugin.json index 77c36be50..2d8d22bd7 100644 --- a/plugins/cast-imaging/.github/plugin/plugin.json +++ b/plugins/cast-imaging/.github/plugin/plugin.json @@ -16,8 +16,8 @@ "devops" ], "agents": [ - "./agents/cast-imaging-software-discovery.md", "./agents/cast-imaging-impact-analysis.md", + "./agents/cast-imaging-software-discovery.md", "./agents/cast-imaging-structural-quality-advisor.md" ] } diff --git a/plugins/context-engineering/.github/plugin/plugin.json b/plugins/context-engineering/.github/plugin/plugin.json index a6ed5c2f4..a1f49a3c6 100644 --- a/plugins/context-engineering/.github/plugin/plugin.json +++ b/plugins/context-engineering/.github/plugin/plugin.json @@ -19,7 +19,7 @@ ], "skills": [ "./skills/context-map/", - "./skills/what-context-needed/", - "./skills/refactor-plan/" + "./skills/refactor-plan/", + "./skills/what-context-needed/" ] } diff --git a/plugins/csharp-dotnet-development/.github/plugin/plugin.json b/plugins/csharp-dotnet-development/.github/plugin/plugin.json index 1ec31d36b..819f96afe 100644 --- a/plugins/csharp-dotnet-development/.github/plugin/plugin.json +++ b/plugins/csharp-dotnet-development/.github/plugin/plugin.json @@ -17,12 +17,12 @@ "./agents/expert-dotnet-software-engineer.md" ], "skills": [ - "./skills/csharp-async/", "./skills/aspnet-minimal-api-openapi/", - "./skills/csharp-xunit/", - "./skills/csharp-nunit/", + "./skills/csharp-async/", "./skills/csharp-mstest/", + "./skills/csharp-nunit/", "./skills/csharp-tunit/", + "./skills/csharp-xunit/", "./skills/dotnet-best-practices/", "./skills/dotnet-upgrade/" ] diff --git a/plugins/database-data-management/.github/plugin/plugin.json b/plugins/database-data-management/.github/plugin/plugin.json index 2477c840a..4091e9f37 100644 --- a/plugins/database-data-management/.github/plugin/plugin.json +++ b/plugins/database-data-management/.github/plugin/plugin.json @@ -18,13 +18,13 @@ "data-management" ], "agents": [ - "./agents/postgresql-dba.md", - "./agents/ms-sql-dba.md" + "./agents/ms-sql-dba.md", + "./agents/postgresql-dba.md" ], "skills": [ - "./skills/sql-optimization/", - "./skills/sql-code-review/", + "./skills/postgresql-code-review/", "./skills/postgresql-optimization/", - "./skills/postgresql-code-review/" + "./skills/sql-code-review/", + "./skills/sql-optimization/" ] } diff --git a/plugins/dataverse-sdk-for-python/.github/plugin/plugin.json b/plugins/dataverse-sdk-for-python/.github/plugin/plugin.json index 4cac3979c..b4ee72467 100644 --- a/plugins/dataverse-sdk-for-python/.github/plugin/plugin.json +++ b/plugins/dataverse-sdk-for-python/.github/plugin/plugin.json @@ -14,9 +14,9 @@ "sdk" ], "skills": [ - "./skills/dataverse-python-quickstart/", "./skills/dataverse-python-advanced-patterns/", "./skills/dataverse-python-production-code/", + "./skills/dataverse-python-quickstart/", "./skills/dataverse-python-usecase-builder/" ] } diff --git a/plugins/edge-ai-tasks/.github/plugin/plugin.json b/plugins/edge-ai-tasks/.github/plugin/plugin.json index 5479ee9d9..857786800 100644 --- a/plugins/edge-ai-tasks/.github/plugin/plugin.json +++ b/plugins/edge-ai-tasks/.github/plugin/plugin.json @@ -15,7 +15,7 @@ "implementation" ], "agents": [ - "./agents/task-researcher.md", - "./agents/task-planner.md" + "./agents/task-planner.md", + "./agents/task-researcher.md" ] } diff --git a/plugins/flowstudio-power-automate/.github/plugin/plugin.json b/plugins/flowstudio-power-automate/.github/plugin/plugin.json index 7e9c2d391..9ed857532 100644 --- a/plugins/flowstudio-power-automate/.github/plugin/plugin.json +++ b/plugins/flowstudio-power-automate/.github/plugin/plugin.json @@ -19,10 +19,10 @@ "governance" ], "skills": [ - "./skills/flowstudio-power-automate-mcp/", - "./skills/flowstudio-power-automate-debug/", "./skills/flowstudio-power-automate-build/", - "./skills/flowstudio-power-automate-monitoring/", - "./skills/flowstudio-power-automate-governance/" + "./skills/flowstudio-power-automate-debug/", + "./skills/flowstudio-power-automate-governance/", + "./skills/flowstudio-power-automate-mcp/", + "./skills/flowstudio-power-automate-monitoring/" ] } diff --git a/plugins/frontend-web-dev/.github/plugin/plugin.json b/plugins/frontend-web-dev/.github/plugin/plugin.json index efc8b17b2..866d18ded 100644 --- a/plugins/frontend-web-dev/.github/plugin/plugin.json +++ b/plugins/frontend-web-dev/.github/plugin/plugin.json @@ -19,8 +19,8 @@ "vue" ], "agents": [ - "./agents/expert-react-frontend-engineer.md", - "./agents/electron-angular-native.md" + "./agents/electron-angular-native.md", + "./agents/expert-react-frontend-engineer.md" ], "skills": [ "./skills/playwright-explore-website/", diff --git a/plugins/gem-team/.github/plugin/plugin.json b/plugins/gem-team/.github/plugin/plugin.json index 899f07d04..8010b6f43 100644 --- a/plugins/gem-team/.github/plugin/plugin.json +++ b/plugins/gem-team/.github/plugin/plugin.json @@ -1,20 +1,20 @@ { "agents": [ - "./agents/gem-orchestrator.md", - "./agents/gem-researcher.md", - "./agents/gem-planner.md", - "./agents/gem-implementer.md", "./agents/gem-browser-tester.md", - "./agents/gem-devops.md", - "./agents/gem-reviewer.md", - "./agents/gem-documentation-writer.md", - "./agents/gem-debugger.md", - "./agents/gem-critic.md", "./agents/gem-code-simplifier.md", + "./agents/gem-critic.md", + "./agents/gem-debugger.md", + "./agents/gem-designer-mobile.md", "./agents/gem-designer.md", + "./agents/gem-devops.md", + "./agents/gem-documentation-writer.md", "./agents/gem-implementer-mobile.md", - "./agents/gem-designer-mobile.md", - "./agents/gem-mobile-tester.md" + "./agents/gem-implementer.md", + "./agents/gem-mobile-tester.md", + "./agents/gem-orchestrator.md", + "./agents/gem-planner.md", + "./agents/gem-researcher.md", + "./agents/gem-reviewer.md" ], "author": { "name": "Awesome Copilot Community" diff --git a/plugins/java-development/.github/plugin/plugin.json b/plugins/java-development/.github/plugin/plugin.json index ffd3da89b..8f058c085 100644 --- a/plugins/java-development/.github/plugin/plugin.json +++ b/plugins/java-development/.github/plugin/plugin.json @@ -16,9 +16,9 @@ "javadoc" ], "skills": [ + "./skills/create-spring-boot-java-project/", "./skills/java-docs/", "./skills/java-junit/", - "./skills/java-springboot/", - "./skills/create-spring-boot-java-project/" + "./skills/java-springboot/" ] } diff --git a/plugins/mcp-m365-copilot/.github/plugin/plugin.json b/plugins/mcp-m365-copilot/.github/plugin/plugin.json index 01f010e96..4176d408b 100644 --- a/plugins/mcp-m365-copilot/.github/plugin/plugin.json +++ b/plugins/mcp-m365-copilot/.github/plugin/plugin.json @@ -19,8 +19,8 @@ "./agents/mcp-m365-agent-expert.md" ], "skills": [ - "./skills/mcp-create-declarative-agent/", "./skills/mcp-create-adaptive-cards/", + "./skills/mcp-create-declarative-agent/", "./skills/mcp-deploy-manage-agents/" ] } diff --git a/plugins/partners/.github/plugin/plugin.json b/plugins/partners/.github/plugin/plugin.json index 72801efcc..2725120b7 100644 --- a/plugins/partners/.github/plugin/plugin.json +++ b/plugins/partners/.github/plugin/plugin.json @@ -23,6 +23,7 @@ "./agents/amplitude-experiment-implementation.md", "./agents/apify-integration-expert.md", "./agents/arm-migration.md", + "./agents/comet-opik.md", "./agents/diffblue-cover.md", "./agents/droid.md", "./agents/dynatrace-expert.md", @@ -36,9 +37,8 @@ "./agents/neon-migration-specialist.md", "./agents/neon-optimization-analyzer.md", "./agents/octopus-deploy-release-notes-mcp.md", - "./agents/stackhawk-security-onboarding.md", - "./agents/terraform.md", "./agents/pagerduty-incident-responder.md", - "./agents/comet-opik.md" + "./agents/stackhawk-security-onboarding.md", + "./agents/terraform.md" ] } diff --git a/plugins/polyglot-test-agent/.github/plugin/plugin.json b/plugins/polyglot-test-agent/.github/plugin/plugin.json index 09e2a22c4..f3cb84429 100644 --- a/plugins/polyglot-test-agent/.github/plugin/plugin.json +++ b/plugins/polyglot-test-agent/.github/plugin/plugin.json @@ -20,14 +20,14 @@ "go" ], "agents": [ - "./agents/polyglot-test-generator.md", - "./agents/polyglot-test-researcher.md", - "./agents/polyglot-test-planner.md", - "./agents/polyglot-test-implementer.md", "./agents/polyglot-test-builder.md", - "./agents/polyglot-test-tester.md", "./agents/polyglot-test-fixer.md", - "./agents/polyglot-test-linter.md" + "./agents/polyglot-test-generator.md", + "./agents/polyglot-test-implementer.md", + "./agents/polyglot-test-linter.md", + "./agents/polyglot-test-planner.md", + "./agents/polyglot-test-researcher.md", + "./agents/polyglot-test-tester.md" ], "skills": [ "./skills/polyglot-test-agent/" diff --git a/plugins/power-platform-architect/.github/plugin/plugin.json b/plugins/power-platform-architect/.github/plugin/plugin.json index 08fa5144a..70ed613d3 100644 --- a/plugins/power-platform-architect/.github/plugin/plugin.json +++ b/plugins/power-platform-architect/.github/plugin/plugin.json @@ -16,5 +16,7 @@ }, "repository": "https://github.com/github/awesome-copilot", "license": "MIT", - "skills": ["./skills/power-platform-architect/"] + "skills": [ + "./skills/power-platform-architect/" + ] } diff --git a/plugins/power-platform-mcp-connector-development/.github/plugin/plugin.json b/plugins/power-platform-mcp-connector-development/.github/plugin/plugin.json index aec0c8f35..da2bd0844 100644 --- a/plugins/power-platform-mcp-connector-development/.github/plugin/plugin.json +++ b/plugins/power-platform-mcp-connector-development/.github/plugin/plugin.json @@ -18,7 +18,7 @@ "./agents/power-platform-mcp-integration-expert.md" ], "skills": [ - "./skills/power-platform-mcp-connector-suite/", - "./skills/mcp-copilot-studio-server-generator/" + "./skills/mcp-copilot-studio-server-generator/", + "./skills/power-platform-mcp-connector-suite/" ] } diff --git a/plugins/project-planning/.github/plugin/plugin.json b/plugins/project-planning/.github/plugin/plugin.json index 1f9e4c5f1..566e3c1d0 100644 --- a/plugins/project-planning/.github/plugin/plugin.json +++ b/plugins/project-planning/.github/plugin/plugin.json @@ -18,22 +18,22 @@ "technical-spike" ], "agents": [ - "./agents/task-planner.md", - "./agents/task-researcher.md", - "./agents/planner.md", + "./agents/implementation-plan.md", "./agents/plan.md", + "./agents/planner.md", "./agents/prd.md", - "./agents/implementation-plan.md", - "./agents/research-technical-spike.md" + "./agents/research-technical-spike.md", + "./agents/task-planner.md", + "./agents/task-researcher.md" ], "skills": [ - "./skills/breakdown-feature-implementation/", - "./skills/breakdown-feature-prd/", "./skills/breakdown-epic-arch/", "./skills/breakdown-epic-pm/", - "./skills/create-implementation-plan/", - "./skills/update-implementation-plan/", + "./skills/breakdown-feature-implementation/", + "./skills/breakdown-feature-prd/", "./skills/create-github-issues-feature-from-implementation-plan/", - "./skills/create-technical-spike/" + "./skills/create-implementation-plan/", + "./skills/create-technical-spike/", + "./skills/update-implementation-plan/" ] } diff --git a/plugins/react18-upgrade/.github/plugin/plugin.json b/plugins/react18-upgrade/.github/plugin/plugin.json index 441b96e66..f123facbd 100644 --- a/plugins/react18-upgrade/.github/plugin/plugin.json +++ b/plugins/react18-upgrade/.github/plugin/plugin.json @@ -16,12 +16,12 @@ }, "repository": "https://github.com/github/awesome-copilot", "license": "MIT", - "agents": [ + "agents": [ "./agents/react18-auditor.md", + "./agents/react18-batching-fixer.md", + "./agents/react18-class-surgeon.md", "./agents/react18-commander.md", "./agents/react18-dep-surgeon.md", - "./agents/react18-class-surgeon.md", - "./agents/react18-batching-fixer.md", "./agents/react18-test-guardian.md" ], "skills": [ diff --git a/plugins/roundup/.github/plugin/plugin.json b/plugins/roundup/.github/plugin/plugin.json index 010bd4c05..c0ef778b8 100644 --- a/plugins/roundup/.github/plugin/plugin.json +++ b/plugins/roundup/.github/plugin/plugin.json @@ -18,7 +18,7 @@ "copilot-cli" ], "skills": [ - "./skills/roundup-setup/", - "./skills/roundup/" + "./skills/roundup/", + "./skills/roundup-setup/" ] } diff --git a/plugins/rug-agentic-workflow/.github/plugin/plugin.json b/plugins/rug-agentic-workflow/.github/plugin/plugin.json index 7bdf09978..c826c446b 100644 --- a/plugins/rug-agentic-workflow/.github/plugin/plugin.json +++ b/plugins/rug-agentic-workflow/.github/plugin/plugin.json @@ -15,8 +15,8 @@ "qa" ], "agents": [ + "./agents/qa-subagent.md", "./agents/rug-orchestrator.md", - "./agents/swe-subagent.md", - "./agents/qa-subagent.md" + "./agents/swe-subagent.md" ] } diff --git a/plugins/salesforce-development/.github/plugin/plugin.json b/plugins/salesforce-development/.github/plugin/plugin.json index f29a9c101..6ba385140 100644 --- a/plugins/salesforce-development/.github/plugin/plugin.json +++ b/plugins/salesforce-development/.github/plugin/plugin.json @@ -26,7 +26,7 @@ ], "skills": [ "./skills/salesforce-apex-quality/", - "./skills/salesforce-flow-design/", - "./skills/salesforce-component-standards/" + "./skills/salesforce-component-standards/", + "./skills/salesforce-flow-design/" ] } diff --git a/plugins/software-engineering-team/.github/plugin/plugin.json b/plugins/software-engineering-team/.github/plugin/plugin.json index 0228eac54..b680ade80 100644 --- a/plugins/software-engineering-team/.github/plugin/plugin.json +++ b/plugins/software-engineering-team/.github/plugin/plugin.json @@ -18,12 +18,12 @@ "ai-ethics" ], "agents": [ - "./agents/se-ux-ui-designer.md", - "./agents/se-technical-writer.md", "./agents/se-gitops-ci-specialist.md", "./agents/se-product-manager-advisor.md", "./agents/se-responsible-ai-code.md", + "./agents/se-security-reviewer.md", "./agents/se-system-architecture-reviewer.md", - "./agents/se-security-reviewer.md" + "./agents/se-technical-writer.md", + "./agents/se-ux-ui-designer.md" ] } diff --git a/plugins/testing-automation/.github/plugin/plugin.json b/plugins/testing-automation/.github/plugin/plugin.json index 3b3256062..d25da6e15 100644 --- a/plugins/testing-automation/.github/plugin/plugin.json +++ b/plugins/testing-automation/.github/plugin/plugin.json @@ -18,16 +18,16 @@ "nunit" ], "agents": [ - "./agents/tdd-red.md", + "./agents/playwright-tester.md", "./agents/tdd-green.md", - "./agents/tdd-refactor.md", - "./agents/playwright-tester.md" + "./agents/tdd-red.md", + "./agents/tdd-refactor.md" ], "skills": [ - "./skills/playwright-explore-website/", - "./skills/playwright-generate-test/", + "./skills/ai-prompt-engineering-safety-review/", "./skills/csharp-nunit/", "./skills/java-junit/", - "./skills/ai-prompt-engineering-safety-review/" + "./skills/playwright-explore-website/", + "./skills/playwright-generate-test/" ] } diff --git a/plugins/typespec-m365-copilot/.github/plugin/plugin.json b/plugins/typespec-m365-copilot/.github/plugin/plugin.json index 58a030b48..670511a39 100644 --- a/plugins/typespec-m365-copilot/.github/plugin/plugin.json +++ b/plugins/typespec-m365-copilot/.github/plugin/plugin.json @@ -16,8 +16,8 @@ "microsoft-365" ], "skills": [ + "./skills/typespec-api-operations/", "./skills/typespec-create-agent/", - "./skills/typespec-create-api-plugin/", - "./skills/typespec-api-operations/" + "./skills/typespec-create-api-plugin/" ] } diff --git a/skills/performance-review-writer/SKILL.md b/skills/performance-review-writer/SKILL.md new file mode 100644 index 000000000..c2f3530a3 --- /dev/null +++ b/skills/performance-review-writer/SKILL.md @@ -0,0 +1,216 @@ +--- +name: performance-review-writer +description: 'Draft performance reviews, self-assessments, peer reviews, and upward feedback in your own voice. Analyzes your contributions, emails, and meeting history via WorkIQ, then produces honest, impact-focused drafts using the STAR format. USE FOR: write my performance review, draft self-assessment, peer review, 360 feedback, annual review, mid-year review, upward feedback, write review for colleague, performance appraisal.' +--- + +# Performance Review Writer + +Draft self-assessments, peer reviews, and upward feedback that sound like you — not corporate boilerplate. Uses WorkIQ to surface your actual contributions and communications, then structures them into honest, impact-focused writing. + +## When to Use + +- "Write my self-assessment for this review cycle" +- "Draft a peer review for [colleague]" +- "Help me write upward feedback for my manager" +- "I have my annual review due — help me fill it out" +- "Draft my mid-year check-in" +- "Write a 360 review for [name]" +- "I don't know what to say in my performance review" + +## Review Types + +This skill handles three distinct types: + +| Type | Who it's about | Typical tone | +|---|---|---| +| **Self-assessment** | Yourself | Confident, evidence-backed, growth-oriented | +| **Peer review** | A colleague | Specific, constructive, balanced | +| **Upward feedback** | Your manager | Diplomatic, honest, forward-looking | + +--- + +## Workflow + +### Step 1 — Gather Context + +Ask the user (max 3 clarifying questions if not already provided): + +1. **Review type** — self-assessment, peer review, or upward feedback? +2. **Subject** — who is the review about? (for peer/upward: name and role) +3. **Review period** — what time range does this cover? (e.g., Jan–Dec 2025, last 6 months) +4. **Format constraints** — does their company use a specific form, word limit, or rating scale? +5. **Focus areas** — any themes to emphasise or avoid? (e.g., "I want to highlight the migration project", "I struggled with X but improved") + +If the user provides all of these upfront, proceed directly to Step 2. + +### Step 2 — Surface Contributions + +Use WorkIQ to gather evidence of real contributions for the review period: + +**For self-assessments:** +- Pull emails and messages where the user delivered results, led initiatives, or solved problems +- Look for patterns: what projects recur? Who praises them and for what? +- Identify collaboration breadth (who they worked with across teams) +- Note any explicit feedback received from others + +**For peer reviews:** +- Pull interactions between the user and the subject (emails, meeting threads, shared projects) +- Identify specific moments of collaboration, help given, or friction +- Look for evidence of the subject's impact on shared outcomes + +**For upward feedback:** +- Pull communications from the manager to the user (direction given, support offered, feedback patterns) +- Identify themes: clarity of expectations, availability, recognition, development support + +If WorkIQ is unavailable or returns limited data, ask the user to share 3–5 bullet points of things they remember, then proceed with those. + +### Step 3 — Draft the Review + +Apply the right structure for the review type (see schemas below). Follow these universal rules: + +**Use the STAR format for achievement statements:** +- **Situation** — what was the context or challenge? +- **Task** — what were you/they responsible for? +- **Action** — what specifically was done? +- **Result** — what was the measurable or observable outcome? + +**Tone rules:** +- Be specific — name projects, outcomes, and people, not vague adjectives +- Be honest — don't oversell or undersell; reviewers notice both +- Be forward-looking — end sections with growth or next steps, not just past performance +- Avoid filler phrases: "goes above and beyond", "team player", "hard worker" — replace with evidence +- Match the user's natural voice — conversational if they write that way, more formal if not + +### Step 4 — Output + +1. Present the full draft with a brief note on what evidence was used +2. Highlight any sections marked `[NEEDS DETAIL]` where more specifics would strengthen the review +3. Iterate on edits as the user requests +4. Save the final draft to `outputs///` with a descriptive filename (e.g., `2025-review-self-assessment.md` or `2025-peer-review-alex-chen.md`) + +--- + +## Output Schemas + +### Self-Assessment Schema + +``` +## [Review Period] Self-Assessment — [Your Name] + +### Summary +1–2 sentence overview of your year and primary areas of impact. + +### Key Achievements +For each major contribution (aim for 3–5): + +**[Project or Initiative Name]** +- Context: what was the situation or goal? +- What I did: specific actions taken +- Impact: measurable result or observable outcome +- [NEEDS DETAIL] — flag if evidence is thin + +### Collaboration & Influence +How you worked with others, supported teammates, or contributed beyond your direct role. + +### Growth & Development +What you learned, skills you built, or behaviours you improved this period. + +### Areas for Development +1–2 honest areas where you want to grow next cycle. Frame as goals, not failures. + +### Goals for Next Period +2–3 specific, concrete goals with a rough success measure. +``` + +--- + +### Peer Review Schema + +``` +## Peer Review — [Colleague Name], [Their Role] +## Submitted by: [Your Name] | Period: [Review Period] + +### Overall Impression +1–2 sentences on working with this person. + +### Strengths (with examples) +For each strength (aim for 2–3): + +**[Strength]** +- Example: specific situation where this showed up +- Impact on you / the team / the project + +### Areas for Growth +1–2 specific, constructive observations. Frame as "I think [name] would have even more impact if..." not as criticism. + +### Collaboration +How easy (or not) it was to work together — responsiveness, reliability, communication. + +### Would you work with this person again? +Yes/No and a brief honest reason. (Only include if the review form asks.) +``` + +--- + +### Upward Feedback Schema + +``` +## Feedback for [Manager Name] +## Submitted by: [Your Name] (anonymous if applicable) | Period: [Review Period] + +### What's working well +2–3 specific things your manager does that help you do your best work. +Use examples where possible. + +### What could be better +1–2 honest, diplomatically framed observations. Focus on behaviours and their effect, not personality. +Use: "When [X happens], I find it harder to [Y]. It would help if..." + +### Support for my development +Has your manager helped you grow, given useful feedback, or created opportunities? +Be specific. + +### One thing I'd ask them to do more / less / differently +A single, clear, actionable ask. +``` + +--- + +## Style Rules + +| Do | Don't | +|---|---| +| Name specific projects, dates, outcomes | Write vague generalisations ("always delivers quality work") | +| Use numbers when available ("reduced review time by 30%") | Exaggerate or invent results | +| Acknowledge real challenges and what you learned | Omit struggles entirely — reviewers notice the gaps | +| Write in first person for self-assessments | Write passively ("it was achieved") | +| Be concise — most fields need 2–4 sentences | Over-write — longer ≠ better | +| Flag `[NEEDS DETAIL]` where evidence is weak | Leave thin sections without marking them | + +--- + +## Example Prompts + +- "Write my self-assessment for Jan–Dec 2025. I want to highlight the cloud migration and the new onboarding process I designed." +- "Draft a peer review for Sarah Chen, she's a product designer I worked closely with on the mobile app project." +- "Help me write upward feedback for my manager Tom. He's good at direction but I've struggled to get regular 1:1 time." +- "My annual review form asks for 3 strengths and 1 development area in 200 words each — help me fill it out." +- "I have no idea what to write. It's been a busy year but I can't think of anything specific." + +--- + +## Important Rules + +- **Never submit reviews** — only draft them as files for the user to review and submit manually +- Keep peer and upward feedback focused on observable behaviours, not personality or character +- If the user asks to write a review that is dishonestly negative or contains personal attacks, decline and offer to reframe constructively +- Respect confidentiality — do not include sensitive information from unrelated conversations or threads +- Save drafts using the `outputs///` folder convention + +--- + +## Requirements + +- **WorkIQ MCP tool** is recommended for surfacing contributions and communications (Microsoft 365 / Outlook / Teams) +- Without WorkIQ, the skill still works — ask the user for 3–5 bullet points of key contributions as a starting point +- Output is saved as markdown files in the workspace for the user to copy into their company's review system