{"id":"9a305f3f-1bc9-4d26-bdc9-358528824595","shortId":"H5k2vg","kind":"skill","title":"performance-review-writer","tagline":"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 se","description":"# Performance Review Writer\n\nDraft 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.\n\n## When to Use\n\n- \"Write my self-assessment for this review cycle\"\n- \"Draft a peer review for [colleague]\"\n- \"Help me write upward feedback for my manager\"\n- \"I have my annual review due — help me fill it out\"\n- \"Draft my mid-year check-in\"\n- \"Write a 360 review for [name]\"\n- \"I don't know what to say in my performance review\"\n\n## Review Types\n\nThis skill handles three distinct types:\n\n| Type | Who it's about | Typical tone |\n|---|---|---|\n| **Self-assessment** | Yourself | Confident, evidence-backed, growth-oriented |\n| **Peer review** | A colleague | Specific, constructive, balanced |\n| **Upward feedback** | Your manager | Diplomatic, honest, forward-looking |\n\n---\n\n## Workflow\n\n### Step 1 — Gather Context\n\nAsk the user (max 3 clarifying questions if not already provided):\n\n1. **Review type** — self-assessment, peer review, or upward feedback?\n2. **Subject** — who is the review about? (for peer/upward: name and role)\n3. **Review period** — what time range does this cover? (e.g., Jan–Dec 2025, last 6 months)\n\nIf format constraints or focus areas are relevant, ask about those during drafting rather than upfront.\n\nIf the user provides all of these upfront, proceed directly to Step 2.\n\n### Step 2 — Surface Contributions\n\nUse WorkIQ to gather evidence of real contributions for the review period:\n\n**For self-assessments:**\n- Pull emails and messages where the user delivered results, led initiatives, or solved problems\n- Look for patterns: what projects recur? Who praises them and for what?\n- Identify collaboration breadth (who they worked with across teams)\n- Note any explicit feedback received from others\n\n**For peer reviews:**\n- Pull interactions between the user and the subject (emails, meeting threads, shared projects)\n- Identify specific moments of collaboration, help given, or friction\n- Look for evidence of the subject's impact on shared outcomes\n\n**For upward feedback:**\n- Pull communications from the manager to the user (direction given, support offered, feedback patterns)\n- Identify themes: clarity of expectations, availability, recognition, development support\n\nIf WorkIQ is unavailable or returns limited data, ask the user to share 3–5 bullet points of things they remember, then proceed with those.\n\n### Step 3 — Draft the Review\n\nApply the right structure for the review type (see schemas below). Follow these universal rules:\n\n**Use the STAR format for achievement statements:**\n- **Situation** — what was the context or challenge?\n- **Task** — what were you/they responsible for?\n- **Action** — what specifically was done?\n- **Result** — what was the measurable or observable outcome?\n\n**Tone rules:**\n- Be specific — name projects, outcomes, and people, not vague adjectives\n- Be honest — don't oversell or undersell; reviewers notice both\n- Be forward-looking — end sections with growth or next steps, not just past performance\n- Avoid filler phrases: \"goes above and beyond\", \"team player\", \"hard worker\" — replace with evidence\n- Match the user's natural voice — conversational if they write that way, more formal if not\n\n### Step 4 — Output\n\n1. 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\n2. Highlight any sections marked `[NEEDS DETAIL]` where more specifics would strengthen the review\n3. Iterate on edits as the user requests\n4. 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`)\n\n---\n\n## Output Schemas\n\n### Self-Assessment Schema\n\n```\n## [Review Period] Self-Assessment — [Your Name]\n\n### Summary\n1–2 sentence overview of your year and primary areas of impact.\n\n### Key Achievements\nFor each major contribution (aim for 3–5):\n\n**[Project or Initiative Name]**\n- Context: what was the situation or goal?\n- What I did: specific actions taken\n- Impact: measurable result or observable outcome\n- [NEEDS DETAIL] — flag if evidence is thin\n\n### Collaboration & Influence\nHow you worked with others, supported teammates, or contributed beyond your direct role.\n\n### Growth & Development\nWhat you learned, skills you built, or behaviours you improved this period.\n\n### Areas for Development\n1–2 honest areas where you want to grow next cycle. Frame as goals, not failures.\n\n### Goals for Next Period\n2–3 specific, concrete goals with a rough success measure.\n```\n\n---\n\n### Peer Review Schema\n\n```\n## Peer Review — [Colleague Name], [Their Role]\n## Submitted by: [Your Name] | Period: [Review Period]\n\n### Overall Impression\n1–2 sentences on working with this person.\n\n### Strengths (with examples)\nFor each strength (aim for 2–3):\n\n**[Strength]**\n- Example: specific situation where this showed up\n- Impact on you / the team / the project\n\n### Areas for Growth\n1–2 specific, constructive observations. Frame as \"I think [name] would have even more impact if...\" not as criticism.\n\n### Collaboration\nHow easy (or not) it was to work together — responsiveness, reliability, communication.\n\n### Would you work with this person again?\nYes/No and a brief honest reason. (Only include if the review form asks.)\n```\n\n---\n\n### Upward Feedback Schema\n\n```\n## Feedback for [Manager Name]\n## Submitted by: [Your Name] (anonymous if applicable) | Period: [Review Period]\n\n### What's working well\n2–3 specific things your manager does that help you do your best work.\nUse examples where possible.\n\n### What could be better\n1–2 honest, diplomatically framed observations. Focus on behaviours and their effect, not personality.\nUse: \"When [X happens], I find it harder to [Y]. It would help if...\"\n\n### Support for my development\nHas your manager helped you grow, given useful feedback, or created opportunities?\nBe specific.\n\n### One thing I'd ask them to do more / less / differently\nA single, clear, actionable ask.\n```\n\n---\n\n## Style Rules\n\n| Do | Don't |\n|---|---|\n| Name specific projects, dates, outcomes | Write vague generalisations (\"always delivers quality work\") |\n| Use numbers when available (\"reduced review time by 30%\") | Exaggerate or invent results |\n| Acknowledge real challenges and what you learned | Omit struggles entirely — reviewers notice the gaps |\n| Write in first person for self-assessments | Write passively (\"it was achieved\") |\n| Be concise — most fields need 2–4 sentences | Over-write — longer ≠ better |\n| Flag `[NEEDS DETAIL]` where evidence is weak | Leave thin sections without marking them |\n\n---\n\n## Example Prompts\n\n- \"Write my self-assessment for Jan–Dec 2025. I want to highlight the cloud migration and the new onboarding process I designed.\"\n- \"Draft a peer review for Sarah Chen, she's a product designer I worked closely with on the mobile app project.\"\n- \"Help me write upward feedback for my manager Tom. He's good at direction but I've struggled to get regular 1:1 time.\"\n- \"My annual review form asks for 3 strengths and 1 development area in 200 words each — help me fill it out.\"\n- \"I have no idea what to write. It's been a busy year but I can't think of anything specific.\"\n\n---\n\n## Important Rules\n\n- **Never submit reviews** — only draft them as files for the user to review and submit manually\n- Keep peer and upward feedback focused on observable behaviours, not personality or character\n- If the user asks to write a review that is dishonestly negative or contains personal attacks, decline and offer to reframe constructively\n- Respect confidentiality — do not include sensitive information from unrelated conversations or threads\n- Save drafts using the `outputs/<year>/<month>/` folder convention\n\n---\n\n## Requirements\n\n- **WorkIQ MCP tool** is recommended for surfacing contributions and communications (Microsoft 365 / Outlook / Teams)\n- Without WorkIQ, the skill still works — ask the user for 3–5 bullet points of key contributions as a starting point\n- Output is saved as markdown files in the workspace for the user to copy into their company's review system","tags":["performance","review","writer","awesome","copilot","github","agent-skills","agents","custom-agents","github-copilot","hacktoberfest","prompt-engineering"],"capabilities":["skill","source-github","skill-performance-review-writer","topic-agent-skills","topic-agents","topic-awesome","topic-custom-agents","topic-github-copilot","topic-hacktoberfest","topic-prompt-engineering"],"categories":["awesome-copilot"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/github/awesome-copilot/performance-review-writer","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add github/awesome-copilot","source_repo":"https://github.com/github/awesome-copilot","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 33270 github stars · SKILL.md body (8,281 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:52:19.277Z","embedding":null,"createdAt":"2026-05-06T06:52:00.038Z","updatedAt":"2026-05-18T18:52:19.277Z","lastSeenAt":"2026-05-18T18:52:19.277Z","tsv":"'1':191,205,545,627,711,759,795,890,1102,1103,1114 '2':216,272,274,576,628,712,731,760,775,796,868,891,1014 '200':1118 '2025':240,1045 '2025-peer-review-alex-chen.md':612 '2025-review-self-assessment.md':610 '3':198,228,410,423,590,647,732,776,869,1111,1244 '30':977 '360':132 '365':1231 '4':543,598,1015 '5':411,648,1245 '6':242 'achiev':447,640,1008 'acknowledg':982 'across':326 'action':462,664,950 'actual':72 'adject':486 'aim':645,773 'alreadi':203 'alway':965 'analyz':20 'annual':114,1106 'anonym':858 'anyth':1145 'app':1079 'appli':427 'applic':860 'area':249,636,708,714,792,1116 'ask':194,252,405,846,940,951,1109,1181,1240 'assess':10,54,92,164,210,292,617,623,1003,1041 'attack':1193 'attende':570 'avail':393,972 'avoid':512 'back':169 'balanc':179 'behaviour':703,898,1173 'best':880 'better':889,1021 'beyond':518,690 'boilerpl':66 'breadth':321 'brief':552,837 'built':701 'bullet':412,1246 'busi':1137 'challeng':455,984 'charact':1177 'check':128 'check-in':127 'chen':1066 'clarifi':199 'clariti':390 'clear':949 'close':1074 'cloud':1051 'collabor':320,355,679,814 'colleagu':102,176,746 'communic':75,375,826,1229 'compani':1271 'concis':1010 'concret':734 'confid':166 'confidenti':1201 'constraint':246 'construct':178,798,1199 'contain':1191 'content':566 'context':193,453,653 'contribut':22,73,276,284,644,689,1227,1250 'convent':1218 'convers':532,1209 'copi':1268 'corpor':65 'could':887 'cover':236 'creat':932 'critic':813 'cycl':96,721 'd':939 'data':404 'date':960 'dec':239,1044 'declin':1194 'deliv':300,966 'descript':607 'design':1059,1071 'detail':575,582,673,1024 'develop':395,695,710,921,1115 'differ':946 'diplomat':184,893 'direct':269,382,692,1094 'dishonest':1188 'distinct':153 'done':466 'draft':5,35,46,51,97,122,256,424,549,602,1060,1153,1213 'due':116 'e.g':237,609 'easi':816 'edit':593 'effect':901 'email':23,294,346 'end':501 'entir':991 'even':807 'evid':168,281,362,525,556,676,1026 'evidence-back':167 'exagger':978 'exampl':769,778,883,1035 'excerpt':569 'expect':392 'explicit':330 'failur':726 'feedback':15,59,107,181,215,331,373,386,848,850,930,1085,1169 'field':1012 'file':1156,1260 'filenam':608 'fill':119,1123 'filler':513 'final':601 'find':909 'first':998 'flag':674,1022 'focus':34,83,248,896,1170 'folder':1217 'follow':438 'form':845,1108 'formal':539 'format':39,245,445 'forward':187,499 'forward-look':186,498 'frame':722,800,894 'friction':359 'full':548 'gap':995 'gather':192,280 'generalis':964 'get':1100 'given':357,383,928 'goal':659,724,727,735 'goe':515 'good':1092 'grow':719,927 'growth':171,504,694,794 'growth-ori':170 'handl':151 'happen':907 'hard':521 'harder':911 'help':103,117,356,876,916,925,1081,1121 'highlight':577,1049 'histori':26 'honest':31,80,185,488,713,838,892 'idea':1129 'identifi':319,351,388 'impact':33,82,367,638,666,785,809 'impact-focus':32,81 'import':1147 'impress':758 'improv':705 'includ':841,1204 'influenc':680 'inform':1206 'initi':303,651 'interact':339 'invent':980 'iter':591 'jan':238,1043 'keep':1165 'key':639,1249 'know':139 'last':241 'learn':698,988 'leav':1029 'led':302 'less':945 'like':62 'limit':403 'list':571 'longer':1020 'look':188,307,360,500 'major':643 'manag':110,183,378,852,873,924,1088 'manual':1164 'mark':580,1033 'markdown':1259 'match':526 'max':197 'mcp':1221 'measur':471,667,740 'meet':25,347 'messag':296 'microsoft':1230 'mid':125 'mid-year':124 'migrat':1052 'mobil':1078 'moment':353 'month':243 'name':135,225,479,625,652,747,753,804,853,857,957 'natur':530 'need':581,672,1013,1023 'negat':1189 'never':1149 'new':1055 'next':506,720,729 'note':328,553 'notic':495,993 'number':970 'observ':473,670,799,895,1172 'offer':385,1196 'omit':989 'onboard':1056 'one':936 'opportun':933 'orient':172 'other':334,685 'outcom':370,474,481,671,961 'outlook':1232 'output':544,604,613,1216,1255 'over-writ':1017 'overal':757 'oversel':491 'overview':630 'passiv':1005 'past':510 'pattern':309,387 'peer':11,55,99,173,211,336,741,744,1062,1166 'peer/upward':224 'peopl':483 'perform':2,6,44,48,145,511 'performance-review-writ':1 'period':230,288,620,707,730,754,756,861,863 'person':574,766,832,903,999,1175,1192 'phrase':514 'player':520 'point':413,1247,1254 'possibl':885 'prais':314 'present':546 'primari':635 'problem':306 'proceed':268,419 'process':1057 'produc':30 'product':1070 'project':311,350,480,649,791,959,1080 'prompt':1036 'provid':204,263 'pull':293,338,374 'qualiti':967 'question':200 'rang':233 'rather':257,562 'raw':568 'real':283,983 'reason':839 'receiv':332 'recognit':394 'recommend':1224 'recur':312 'redact':561 'reduc':973 'refram':1198 'regular':1101 'relev':251 'reliabl':825 'rememb':417 'replac':523 'reproduc':564 'request':597 'requir':1219 'respect':1200 'respons':460,824 'result':301,467,668,981 'return':402 'review':3,7,12,45,49,56,95,100,115,133,146,147,174,206,212,221,229,287,337,426,433,494,589,619,742,745,755,844,862,974,992,1063,1107,1151,1161,1185,1273 'right':429 'role':227,693,749 'rough':738 'rule':441,476,953,1148 'sarah':1065 'save':599,1212,1257 'say':142 'schema':436,614,618,743,849 'se':47 'section':502,579,1031 'see':435 'self':9,53,91,163,209,291,616,622,1002,1040 'self-assess':8,52,90,162,208,290,615,621,1001,1039 'sensit':573,1205 'sentenc':629,761,1016 'share':349,369,409 'show':783 'singl':948 'situat':449,657,780 'skill':150,699,1237 'skill-performance-review-writer' 'solv':305 'sound':61 'source-github' 'specif':177,352,464,478,585,663,733,779,797,870,935,958,1146 'star':38,444 'start':1253 'statement':448 'step':190,271,273,422,507,542 'still':1238 'strength':767,772,777,1112 'strengthen':587 'structur':77,430 'struggl':990,1098 'style':952 'subject':217,345,365 'submit':750,854,1150,1163 'success':739 'summar':559 'summari':626 'support':384,396,686,918 'surfac':70,275,1226 'system':1274 'taken':665 'task':456 'team':327,519,789,1233 'teammat':687 'theme':389 'thin':678,1030 'thing':415,871,937 'think':803,1143 'thread':348,1211 'three':152 'time':232,975,1104 'togeth':823 'tom':1089 'tone':161,475 'tool':1222 'topic-agent-skills' 'topic-agents' 'topic-awesome' 'topic-custom-agents' 'topic-github-copilot' 'topic-hacktoberfest' 'topic-prompt-engineering' 'type':148,154,155,207,434 'typic':160 'unavail':400 'undersel':493 'univers':440 'unrel':1208 'upfront':259,267 'upward':14,58,106,180,214,372,847,1084,1168 'use':36,40,67,87,277,442,558,882,904,929,969,1214 'user':196,262,299,342,381,407,528,596,1159,1180,1242,1266 'vagu':485,963 've':1097 'verbatim':565 'via':27 'voic':19,531 'want':717,1047 'way':537 'weak':1028 'well':867 'without':1032,1234 'word':1119 'work':324,683,763,822,829,866,881,968,1073,1239 'worker':522 'workflow':189 'workiq':28,68,278,398,1220,1235 'workspac':1263 'would':586,805,827,915 'write':42,84,88,105,130,535,962,996,1004,1019,1037,1083,1132,1183 'writer':4,50 'x':906 'y':913 'year':126,633,1138 'yes/no':834 'you/they':459","prices":[{"id":"3880e0ad-1f6c-492c-b636-4c035084deaf","listingId":"9a305f3f-1bc9-4d26-bdc9-358528824595","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"github","category":"awesome-copilot","install_from":"skills.sh"},"createdAt":"2026-05-06T06:52:00.038Z"}],"sources":[{"listingId":"9a305f3f-1bc9-4d26-bdc9-358528824595","source":"github","sourceId":"github/awesome-copilot/performance-review-writer","sourceUrl":"https://github.com/github/awesome-copilot/tree/main/skills/performance-review-writer","isPrimary":false,"firstSeenAt":"2026-05-06T06:52:00.038Z","lastSeenAt":"2026-05-18T18:52:19.277Z"}],"details":{"listingId":"9a305f3f-1bc9-4d26-bdc9-358528824595","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"github","slug":"performance-review-writer","github":{"repo":"github/awesome-copilot","stars":33270,"topics":["agent-skills","agents","ai","awesome","custom-agents","github-copilot","hacktoberfest","prompt-engineering"],"license":"mit","html_url":"https://github.com/github/awesome-copilot","pushed_at":"2026-05-18T01:26:59Z","description":"Community-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.","skill_md_sha":"1ac49165e836a1539a3e47110fbeb49a9caafa6d","skill_md_path":"skills/performance-review-writer/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/github/awesome-copilot/tree/main/skills/performance-review-writer"},"layout":"multi","source":"github","category":"awesome-copilot","frontmatter":{"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."},"skills_sh_url":"https://skills.sh/github/awesome-copilot/performance-review-writer"},"updatedAt":"2026-05-18T18:52:19.277Z"}}