New to Claude Skills? Learn how to install them →

github on GitHub

Performance Review Writer

OfficialFree

Draft personalized performance reviews effortlessly.

by github37.7k stars on github/awesome-copilot
1 views
Updated Aug 10, 2026
Get this skill

Free · Opens the source repo

What Performance Review Writer does

The Performance Review Writer skill assists users in crafting self-assessments, peer reviews, and upward feedback that reflect their unique voice and experiences. By leveraging WorkIQ, the skill analyzes contributions, emails, and meeting histories to gather relevant evidence, ensuring that the resulting drafts are honest and focused on impact. This approach allows users to avoid generic corporate language, instead producing reviews that are specific and tailored to their actual performance and interactions.

The skill operates through a structured workflow that begins with gathering context about the review type, the subject, and the review period. Once the necessary information is collected, it uses WorkIQ to surface contributions and communications relevant to the review. For self-assessments, it identifies key achievements and collaboration patterns, while for peer reviews and upward feedback, it focuses on interactions and the impact of the subject's work. This ensures that the drafts are grounded in real experiences and contributions.

The drafting process follows the STAR format, which helps users articulate their achievements clearly by outlining the Situation, Task, Action, and Result. The skill emphasizes the importance of specificity and honesty, guiding users to avoid vague statements and instead provide concrete examples and measurable outcomes. It also encourages a forward-looking perspective, prompting users to consider their growth and future goals.

This skill is particularly useful for professionals preparing for annual or mid-year reviews, as well as those needing to provide constructive feedback to colleagues or managers. By streamlining the writing process and ensuring that reviews are evidence-based, the Performance Review Writer skill helps users communicate their value effectively in performance evaluations.

When to use it

Use this skill when preparing for performance review cycles, drafting self-assessments, or providing feedback to colleagues and managers.

When not to use it

This skill may not be suitable for users who prefer to write their reviews entirely from scratch without assistance or those who do not have access to WorkIQ for contribution analysis.

What you can build with it

Annual Review Preparation

Use the skill to draft a comprehensive self-assessment for your annual performance review, highlighting key achievements and areas for growth.

Peer Review Feedback

Draft a constructive peer review for a colleague, focusing on specific strengths and areas for development based on your collaboration.

Upward Feedback for Management

Generate thoughtful upward feedback for your manager, addressing what works well and suggesting areas for improvement.

How to install Performance Review Writer

View source

1. Install with the skills CLI

npx skills add github/awesome-copilot/performance-review-writer --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by github

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:

TypeWho it's aboutTypical tone
Self-assessmentYourselfConfident, evidence-backed, growth-oriented
Peer reviewA colleagueSpecific, constructive, balanced
Upward feedbackYour managerDiplomatic, 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)

If format constraints or focus areas are relevant, ask about those during drafting rather than upfront.

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. Summarize and redact rather than reproduce verbatim content — no raw excerpts, attendee lists, or sensitive personal details
  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/<year>/<month>/ 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

DoDon't
Name specific projects, dates, outcomesWrite 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 learnedOmit struggles entirely — reviewers notice the gaps
Write in first person for self-assessmentsWrite passively ("it was achieved")
Be concise — most fields need 2–4 sentencesOver-write — longer ≠ better
Flag [NEEDS DETAIL] where evidence is weakLeave 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/<year>/<month>/ 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

Frequently asked questions about Performance Review Writer

Similar skills