Agent skill

Self Review

Generate a comprehensive work self-review by pulling data from GitHub PRs, Jira tickets, and Confluence pages.

MITAuto-check passedDevelopment

Install Self Review

skills CLI

$ npx skills add meain/dotfiles --skill self-review -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install meain/dotfiles self-review --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/meain/dotfiles.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agents/.agents/skills/self-review .claude/skills/self-review && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "self-review" agent skill from https://github.com/meain/dotfiles/tree/master/agents/.agents/skills/self-review into .claude/skills/self-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-review", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/meain/dotfiles/tree/master/agents/.agents/skills/self-review

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add meain/dotfiles --skill self-review -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install meain/dotfiles self-review --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/meain/dotfiles.git skills-src && mkdir -p .agents/skills && cp -r skills-src/agents/.agents/skills/self-review .agents/skills/self-review && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "self-review" agent skill from https://github.com/meain/dotfiles/tree/master/agents/.agents/skills/self-review into .agents/skills/self-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-review", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add meain/dotfiles --skill self-review -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install meain/dotfiles self-review --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/meain/dotfiles.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/agents/.agents/skills/self-review .cursor/skills/self-review && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "self-review" agent skill from https://github.com/meain/dotfiles/tree/master/agents/.agents/skills/self-review into .cursor/skills/self-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-review", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/meain/dotfiles.git --path agents/.agents/skills/self-review

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add meain/dotfiles --skill self-review -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install meain/dotfiles self-review --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/meain/dotfiles.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/agents/.agents/skills/self-review .gemini/skills/self-review && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "self-review" agent skill from https://github.com/meain/dotfiles/tree/master/agents/.agents/skills/self-review into .gemini/skills/self-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-review", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install meain/dotfiles self-review

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add meain/dotfiles --skill self-review -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/meain/dotfiles.git skills-src && mkdir -p .github/skills && cp -r skills-src/agents/.agents/skills/self-review .github/skills/self-review && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "self-review" agent skill from https://github.com/meain/dotfiles/tree/master/agents/.agents/skills/self-review into .github/skills/self-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-review", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add meain/dotfiles --skill self-review -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install meain/dotfiles self-review --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/meain/dotfiles.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/agents/.agents/skills/self-review .opencode/skills/self-review && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "self-review" agent skill from https://github.com/meain/dotfiles/tree/master/agents/.agents/skills/self-review into .opencode/skills/self-review/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "self-review", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: self-review
GitHub stars: 285
Token cost: ~877 tokens
SKILL.md length: 206 words
Files: 1
Skills in repo: 35
Repo updated: Oct 8, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Generate a comprehensive work self-review by pulling data from GitHub PRs, Jira tickets, and Confluence pages.

Works in 8 steps: Setup → Gather GitHub PRs Authored (parallel… → Gather GitHub PRs Reviewed → …
Development work in your project
SKILL.md covers Arguments and Workflow
Calls gh

What it does

Self Review is an agent skill from meain/dotfiles. Generate a comprehensive work self-review by pulling data from GitHub PRs, Jira tickets, and Confluence pages. Covers accomplishments, patterns, areas for improvement, and current focus. Accepts an optional time range argument (e.g., "last quarter", "Q1 2026", "last 6 months") defaulting to last quarter. Triggers: /self-review, "generate self review", "introspect my work", "quarterly review"

Its SKILL.md is about 880 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. It works with Jira, GitHub and Confluence. The repository describes itself as: If there is a shell, there is a way! The licence is MIT.

When your agent uses it

Development work in your project

Example prompts

“last quarter”
“Q1 2026”
“last 6 months”
“/self-review”

Workflow steps

8 steps, taken from the step headings in SKILL.md.

Setup
Gather GitHub PRs Authored (parallel across repos)
Gather GitHub PRs Reviewed
Gather Jira Tickets (parallel)
Gather Confluence Context (parallel)
Analyze & Categorize
Goals vs. Delivery
Generate Report

What it can do on your machine

Read from SKILL.md and the folder at commit 3e336e2. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- gh
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use gh, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Self Review loads about 877 tokens when it runs. Until then it costs about 102 tokens; SKILL.md has 206 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~102
When it runs · the whole SKILL.md, loaded when a task matches: ~877

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from meain/dotfiles at commit 3e336e2, republished under its MIT licence (© meain). 206 words, ~877 tokens.

Download SKILL.mdSave it as .claude/skills/self-review/SKILL.md (or your agent's skills folder).

name: self-review
description: Generate a comprehensive work self-review by pulling data from GitHub PRs, Jira tickets, and Confluence pages. Covers accomplishments, patterns, areas for improvement, and current focus. Accepts an optional time range argument (e.g., "last quarter", "Q1 2026", "last 6 months") defaulting to last quarter. Triggers: /self-review, "generate self review", "introspect my work", "quarterly review"
user_invocable: true

Work Self-Review Generator

Generate a comprehensive self-review by aggregating GitHub PRs, Jira tickets, and Confluence data.

Arguments

$ARGUMENTS — optional time range (e.g. "last quarter", "Q1 2026", "last 6 months"). Defaults to last quarter.

Workflow

1. Setup

bash

gh api user --jq '.login'
cat ~/.dotfiles-private/datafiles/.config/datafiles/prs-repos

2. Gather GitHub PRs Authored (parallel across repos)

bash

gh pr list --repo <REPO> --author <USERNAME> --state all --limit 100 \
  --json number,title,state,createdAt,mergedAt,url

Filter to createdAt within time range.

3. Gather GitHub PRs Reviewed

bash

gh search prs --reviewed-by=<USERNAME> --owner=Veeam-VDC --merged \
  --json title,number,repository,updatedAt --limit 100

Filter to time range.

4. Gather Jira Tickets (parallel)

bash

jira issue list --assignee="$(jira me)" --order-by "updated" --reverse --paginate 100 --raw
jira issue list --reporter="$(jira me)" --order-by "updated" --reverse --paginate 100 --raw

Both return JSON arrays. Merge by ticket key, filter to time range. Parse with jq to extract needed fields.

5. Gather Confluence Context (parallel)

bash

confluence search 'creator = currentUser() order by lastmodified desc' --cql --limit 20
confluence search 'contributor = currentUser() order by lastmodified desc' --cql --limit 20
confluence search 'space = "~71202041711d825b9c4649b13c777b34245dc2" AND title ~ "Abin" AND title ~ "goals" order by lastmodified desc' --cql --limit 10

Merge by page ID. Read relevant pages: quarterly goals (under parent ID 294783303), design docs, runbooks.

5b. On-Call Data

bash

confluence search 'title ~ "Weekly Report" AND text ~ "<full name>" order by created desc' --cql --limit 20

Also cross-reference Jira bugs/tasks mentioning "on-call", "investigate", or "prod".

6. Analyze & Categorize

Group into themes: major features, bug fixes, ops improvements, tooling, testing, code reviews, on-call, design/docs. For each: summary, key PRs (repo#number), key Jira tickets.

7. Goals vs. Delivery

If quarterly goals found, produce a comparison table:

Goal	Status	Evidence
...	DONE / PARTIAL / NOT STARTED / DROPPED	PRs, tickets

8-10. Strengths, Areas for Improvement, Current Focus

Identify 3-5 each. For gaps: look for stale tickets, missing docs, knowledge concentration, PR size patterns.

11. Generate Report

Write to /tmp/self-review-<period>.md:

markdown

# Work Self-Review: <Period>
**Author, Date, Team**

## Summary

## Key Accomplishments (per theme)
### 1. <Theme> — description, key PRs, key Jira

## Goals vs. Delivery (if applicable)

## On-Call & Incident Response

## What's Working Well

## Areas for Improvement

## Current Focus

## By the Numbers
| Metric | Count |
|--------|-------|
| PRs authored | N |
| PRs reviewed | N |
| Jira tickets completed | N |
| ... | ... |

Do not include report content in chat — just confirm it was opened.

Files

Just SKILL.md in agents/.agents/skills/self-review of meain/dotfiles.

Open the folder on GitHubat commit 3e336e2

Compare with similar skills

Self Review next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Self Review compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Self Review this skillmeain/dotfiles	285	—	~877	Automated safety check: Pass	MIT	2 days ago
Create Epic RecapDataDog/datadog-agent	3.8k	—	~5k	Automated safety check: Notes	Apache-2.0	today
Tool ConnectorZhixiangLuo/10xProductivity	479	—	~925	Automated safety check: Pass	MIT	2 mo ago
Akb Ingestdnotitia/akb	162	—	~2k	Automated safety check: Pass	Custom licence	yesterday
sfdx-hardis Architecture Guidehardisgroupcom/sfdx-hardis	403	—	~2.1k	Automated safety check: Pass	AGPL-3.0	today
AirweaveCraftOS-dev/CraftBot	392	—	~1.1k	Automated safety check: Pass	MIT	today

Similar skills

Create Epic Recap
DataDog/datadog-agent
Official
A skill your agent uses when an engineer or manager asks to recap, summarize, or post an update on a Jira Epic — a progress update for an in-progress Epic (how far along it is, what's shipped so…
3.8k GitHub stars~5k tokensUpdated today
DevelopmentAuto-check: notes
Tool Connector
ZhixiangLuo/10xProductivity
Connect any tool you use at work to your agent — including internal company tools, custom-built systems, deployment portals, incident trackers, internal knowledge bases, HR systems, and commercial…
479 GitHub stars~925 tokensUpdated 2 mo ago
DevOps & CloudAuto-check passed
Akb Ingest
dnotitia/akb
Ingest whatever you point at into an AKB vault — a local file, a web URL, a GitHub PR/release/commit, a Confluence page, or a Jira issue.
162 GitHub stars~2k tokensUpdated yesterday
Agent WorkflowsAuto-check passed
sfdx-hardis Architecture Guide
hardisgroupcom/sfdx-hardis
Explains how the sfdx-hardis Salesforce CLI plugin is built: its TypeScript and Oclif stack, command layout, agent-mode flag and provider classes for git, notifications and AI.
403 GitHub stars~2.1k tokensUpdated today
DevelopmentAuto-check passed
Airweave
CraftOS-dev/CraftBot
Context retrieval layer for AI agents across users' applications.
392 GitHub stars~1.1k tokensUpdated today
Sales & SupportAuto-check passed
Design Doc Mermaid
SpillwaveSolutions/design-doc-mermaid
Create Mermaid diagrams (flowchart, sequence, class, ER, state, C4, architecture) from text or source code.
176 GitHub starsUsed in 1 repo~5.6k tokens
DevelopmentAuto-check passed

Questions about Self Review

What does Self Review do?

Generate a comprehensive work self-review by pulling data from GitHub PRs, Jira tickets, and Confluence pages. Self Review is an agent skill from meain/dotfiles. Generate a comprehensive work self-review by pulling data from GitHub PRs, Jira tickets, and Confluence pages.

When should I use Self Review?

Self Review fits situations like: development work in your project.

How do I install Self Review in Claude Code?

Run `npx skills add meain/dotfiles --skill self-review -a claude-code`. Or copy the skill folder (agents/.agents/skills/self-review in meain/dotfiles) into .claude/skills/self-review in your project. Claude Code loads it when a task matches its description.

How do I install Self Review in Codex?

Run `npx skills add meain/dotfiles --skill self-review -a codex`. Or copy the skill folder (agents/.agents/skills/self-review in meain/dotfiles) into .agents/skills/self-review in your project. Codex loads it when a task matches its description.

Can I use Self Review in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add meain/dotfiles --skill self-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/self-review, .gemini/skills/self-review, .github/skills/self-review and .opencode/skills/self-review in your project.

What does Self Review need to run?

Going by SKILL.md and its folder, Self Review needs the command-line tools its instructions call (gh).

Does Self Review access the network?

SKILL.md contains no URLs. Its commands use gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Self Review safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Self Review use?

Self Review is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Self Review use?

About 877 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Self Review?

Skills that share tags, products or a category with Self Review: Create Epic Recap (DataDog/datadog-agent, 3.8k stars), Tool Connector (ZhixiangLuo/10xProductivity, 479 stars), Akb Ingest (dnotitia/akb, 162 stars) and sfdx-hardis Architecture Guide (hardisgroupcom/sfdx-hardis, 403 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Self Review?

meain (a GitHub user) maintains it in meain/dotfiles, which has 285 GitHub stars. The repository holds 35 skills in this directory. The repository was last updated on October 8, 2026.

Source: meain/dotfiles on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Self Review

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Work Self-Review Generator

Arguments

Workflow

1. Setup

2. Gather GitHub PRs Authored (parallel across repos)

3. Gather GitHub PRs Reviewed

4. Gather Jira Tickets (parallel)

5. Gather Confluence Context (parallel)

5b. On-Call Data

6. Analyze & Categorize

7. Goals vs. Delivery

8-10. Strengths, Areas for Improvement, Current Focus

11. Generate Report

Files

Compare with similar skills

Similar skills

More from meain/dotfiles

Related

Questions about Self Review