Guide · Agent skill
How to use the Performance Review Writer agent skill
Updated · written with AI from the project's own documentation and checked against our catalogue data
The Performance Review Writer is an agent skill that turns a period's goals and results into a quantified, evidence-based self-assessment or manager review, delivered as a Word document. It is aimed at employees preparing annual or quarterly self-assessments, managers writing consistent reviews for direct reports, and anyone running a goal retrospective at the end of a project. After this guide you will know what an agent skill is, how to install this one, how to ask for a review in plain language, and what material to prepare so the output is useful.
Performance Review Writergenspark-ai/genoffice · Apache-2.0 Download the skill Quick start
- 1Download and unzip. Download the skill ZIP from this page and unzip it into ~/.claude/skills/ or the project's .claude/skills/ folder.
- 2Or upload in the Claude apps. In the Claude apps, open Settings, go to Capabilities, and upload the skill under Skills.
- 3Gather goals and results. Collect the period's goals, results, evidence and your company's competency or rating model.
- 4Make the request. Ask in plain language, for example to write your annual self-assessment from these results, and attach the material.
- 5Answer the agent's questions. Provide the review period, framework, reviewee details if needed, and any word limit when asked.
- 6Check the Word document. Verify each number against its source and review the weakest-evidence points the agent flags.
What is an agent skill and what does this one make the agent do?
An agent skill is a folder of instructions that an AI agent loads when a request matches it. This skill is defined by a single file, SKILL.md, which tells the agent to act as a performance-review specialist.
Once installed, the agent maps each result you provide to a goal, checks whether there is supporting evidence, and writes a structured Word document. The document contains an overall summary, a goal attainment table, three detailed achievements, competency examples and next-period goals. The agent also flags which points have the weakest evidence and asks you for missing material.
- Confirms the review period, your company's performance framework and the goals set at the start of the period
- Marks each result as exceeded, met, not met or contribution beyond goals
- Lists results that lack evidence and asks you to supply it instead of filling gaps with adjectives
- After delivery, points out the one or two weakest-evidence items and suggests what would strengthen them
Install the performance-review skill
Download the ZIP file from this page and unzip it. To make the skill available to every project, unzip it into ~/.claude/skills/. To make it available to one project only, unzip it into that project's .claude/skills/ folder.
If you use the Claude apps instead, open Settings, go to Capabilities, and upload the skill under Skills.
- Personal install: ~/.claude/skills/
- Project install: .claude/skills/ inside your project folder
- Claude apps: Settings → Capabilities → Skills, then upload
Prepare your material before you ask
The skill works from what you give it. Gather your goals for the period, your results and the evidence behind them. Material can be weekly reports, project records or data screenshots. You also need your company's competency or rating model, because the output is written against it. Without that model the wording may not match your company's rating definitions.
For a review of someone else, have the reviewee's role and the rating you expect ready. The skill will ask for these if they are missing.
- Goals set at the start of the period, with their definitions and time window
- Results and the source of each number (system report, project record, customer feedback)
- Your company's performance framework, such as OKR, KPI or a competency model
- Any word limit or form constraints
Trigger the skill with a natural request
You do not need special syntax. Describe what you want in plain language and attach or paste your material. The skill's own quick prompts give a good starting pattern.
The agent will ask for anything missing before it writes the document, so a short first message is enough.
- Write my annual performance self-assessment from these results
- Write a quarterly performance review for a team member
Review the output and fill the gaps
The agent produces a Word document titled with your name and the period, either as a self-assessment or a performance review. Self-assessments are written in the first person. Reviews are written in the third person and use the person's name.
Check the weakest-evidence points the agent lists. Add the missing data or delete the claim. Numbers in the tables should carry their definition and source, so confirm those match your records before you submit anything.
- Self-assessments: 2 to 3 strengths and 1 to 2 areas to develop
- Reviews of others also include specific improvement suggestions and support
- Goals not met should show the reason and the remediation already taken
Safety notes: scripts and network
This skill runs no scripts and uses no network access, according to its listing. It relies on the document tools in your agent environment to produce the .docx file. You must have those document tools available, or the skill cannot produce a Word file.
The skill also removes or asks you to remove sensitive personal or medical details about an employee from reviews. Do not rely on it to make rating, pay or promotion decisions. Those stay with your company's process.
- Runs scripts: no
- Uses network: no
- Requires document tools in the agent environment to create Word (.docx) files
What people use it for
- An employee drafting an annual self-assessment from weekly reports and project records
- A manager writing quarterly reviews for direct reports with consistent, evidence-based wording
- A team lead running a goal retrospective at the end of a project
- Mapping a long list of work results to goals to spot where evidence is thin
Frequently asked questions
How do I install the performance-review agent skill?
Download the ZIP from this page and unzip it into ~/.claude/skills/ for all projects, or into a project's .claude/skills/ folder for one project. In the Claude apps, you can instead go to Settings → Capabilities → Skills and upload it.
What do I need to use the performance-review skill?
You need document tools in the agent environment that can produce a Word (.docx) file, plus your own period goals, results and company competency or rating model. The skill does not supply your performance framework.
Is the performance-review skill free?
The listing states the licence as Apache-2.0. Check the repository's licence file for the exact terms. This guide does not state any price.
Does this skill make rating or promotion decisions?
No. The skill explicitly leaves ratings, pay changes and promotions to your company's process and does not pre-empt them.
Does the skill run scripts or access the internet?
According to its listing, it runs no scripts and uses no network access. It works from the material you provide and the document tools in your environment.
What should I do if the Word file is not created?
The skill depends on document tools in the agent environment. Confirm those tools are available in your setup, since the skill cannot produce a .docx file without them.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Use this skill if you need a structured, evidence-based self-assessment or manager review and can supply your goals, results and company competency model. Pick something else if you need to make rating, pay or promotion decisions, or if your company has no defined performance framework, since the output may not match your rating definitions.
Download the skill