MR
Mayur Rathi
@github
⭐ 34.1k GitHub stars

Performance-Review-Writer

Performance-Review-Writer是一款code方向的AI技能,核心价值是Draft performance reviews, self-assessments, peer reviews, and upward feedback in your own voice,可用于解决开发者在code领域的实际问题,帮助用户提升效率、自动化重复任务或优化工作流。

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-focu

Last verified on: 2026-05-30
mkdir -p ./skills/performance-review-writer && curl -sfL https://raw.githubusercontent.com/github/awesome-copilot/main/skills/performance-review-writer/SKILL.md -o ./skills/performance-review-writer/SKILL.md

Run in terminal / PowerShell. Requires curl (Unix) or PowerShell 5+ (Windows).

Skill Content

# 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


text
## [Review Period] Self-Assessment — [Your Name]

### Summary
1–2 sentence overview of you

🎯 Best For

  • Engineering teams doing code reviews
  • Open source maintainers
  • Data analysts
  • Business intelligence teams
  • Claude users

💡 Use Cases

  • Reviewing pull requests for security vulnerabilities
  • Checking code style consistency
  • Finding patterns in customer data
  • Creating automated dashboards

📖 How to Use This Skill

  1. 1

    Install the Skill

    Copy the install command from the Terminal tab and run it. The SKILL.md file downloads to your local skills directory.

  2. 2

    Load into Your AI Assistant

    Open Claude or GitHub Copilot and reference the skill. Paste the SKILL.md content or use the system prompt tab.

  3. 3

    Apply Performance-Review-Writer to Your Work

    Open your project in the AI assistant and ask it to apply the skill. Start with a small module to verify the output quality.

  4. 4

    Review and Refine

    Review AI suggestions before committing. Run tests, check for regressions, and iterate on the skill output.

❓ Frequently Asked Questions

Does this skill check for OWASP Top 10?

Security-focused review skills often include OWASP checks. Check the skill content for specific vulnerability categories covered.

Can this connect to my database directly?

Most data skills accept CSV or JSON input. Database connectors are listed in the Works With section.

Is Performance-Review-Writer compatible with Cursor and VS Code?

Yes — this skill works with any AI coding assistant including Cursor, VS Code with Copilot, and JetBrains IDEs.

Do I need specific dependencies for Performance-Review-Writer?

Check the install command and Works With section. Most code skills only require the AI assistant and your codebase.

How do I install Performance-Review-Writer?

Copy the install command from the Terminal tab and run it. The skill downloads to ./skills/performance-review-writer/SKILL.md, ready to use.

⚠️ Common Mistakes to Avoid

Blindly accepting AI suggestions

Always verify AI-generated review comments. Some suggestions may not apply to your specific codebase conventions.

Not validating data quality

AI analysis is only as good as your input data. Profile and clean data before analysis.

Skipping validation

Always test AI-generated code changes, even for simple refactors.

Missing dependency updates

Check if the skill requires updated dependencies or new packages.

🔗 Related Skills