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
Ready-to-paste message
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-writerOr download just the file:
curl -L https://raw.githubusercontent.com/github/awesome-copilot/main/skills/performance-review-writer/SKILL.md -o SKILL.mdTechnical 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):
- Review type — self-assessment, peer review, or upward feedback?
- Subject — who is the review about? (for peer/upward: name and role)
- 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
- 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
- Highlight any sections marked
[NEEDS DETAIL]where more specifics would strengthen the review - Iterate on edits as the user requests
- Save the final draft to
outputs/<year>/<month>/with a descriptive filename (e.g.,2025-review-self-assessment.mdor2025-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
Comments
- …
More skills from this repository
acquire-codebase-knowledge
Helps your agent understand and document an existing code project. It's useful for onboarding new people or getting an overview of the architecture.
github/awesome-copilot
acreadiness-assess
Enables your agent to assess a project's readiness for AI and generate a report. It's useful for understanding how well a project is prepared to use AI tools.
github/awesome-copilot
acreadiness-generate-instructions
Helps your agent create instructions for AI tools based on an assessment. It's useful for improving how AI interacts with code and closing identified gaps.
github/awesome-copilot
acreadiness-policy
Enables your agent to help define or apply policies for AI project assessment. It's useful for standardizing how projects are evaluated and ensuring compliance.
github/awesome-copilot
Similar skills
intent-driven-development
Helps your agent turn ideas into clear, testable plans. Defines criteria to ensure changes are made correctly and safely.
affaan-m/ECC
product-capability
Guides your agent in turning product ideas into clear plans. It defines what needs to be done, the limits, and decisions before development.
affaan-m/ECC
article-writing
Writes long-form content like articles, guides, and blog posts with a unique style. It's useful when you need well-written texts with a consistent voice and credibility.
affaan-m/ECC