Skip to content
Skillpedia
Writing40k · #5260

performance-review-writer

Makes your agent draft performance reviews and feedback. It analyzes your contributions and emails to create impact-focused drafts using the STAR format.

What it does

This assistant helps write performance reviews, like self-assessments, peer reviews, and upward feedback. It uses your work information to create honest, results-focused text.

When to use it

  • ✓When you need to write your self-assessment.
  • ✓To give feedback on a colleague's work.
  • ✓When writing feedback for your manager.

Example of what to ask your AI

“Write my self-assessment for this review cycle.”

Want more? Open the sections below.

How to use

The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.

Skill link

https://github.com/github/awesome-copilot/blob/main/skills/performance-review-writer/SKILL.md

Ready-to-paste message

Use this skill to help me: https://github.com/github/awesome-copilot/blob/main/skills/performance-review-writer/SKILL.md Read the SKILL.md file at that link and follow its instructions for my task.
How it works

It analyzes your emails and meeting history to find examples of your work. Then, it organizes this information in the STAR format (Situation, Task, Action, Result) to create clear, impactful writing.

Installation

Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.

In the terminal (Claude Code, Codex, Cursor), in your project folder:

npx skills add github/awesome-copilot --skill performance-review-writer

Or download just the file:

curl -L https://raw.githubusercontent.com/github/awesome-copilot/main/skills/performance-review-writer/SKILL.md -o SKILL.md
Technical content (original SKILL.md)

Original text by the author, straight from 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:

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)

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

…
FAQ

What is the STAR format?

It's a way to tell a story about your work: it describes the Situation, the Task you had, the Action you took, and the Result you achieved.

Does the assistant use my personal information?

It uses your work-related information, like emails and meetings, to find examples of your contributions. It does not use personal information outside of a professional context.

Can I edit the generated text?

Yes, the assistant generates a draft that you can review and edit to ensure it sounds exactly like you.

Details

Original description by the author

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, p

repo: github/awesome-copilot

Popularity

GitHub stars
40k
Ranking position
#5260
License
MIT
Updated
10/15/2026

Is this skill useful?

0

Sign in to vote.

Comments

  • …

More skills from this repository

Similar skills