scholar-mcp: Skill for Claude Code

.agents/skills/self-reviewing/SKILL.md

self-reviewing is a skill for Claude Code, Codex from pvliesdonk/scholar-mcp. It costs 69 tokens per session (3,254 once invoked), scanned A, a copy of self-reviewing, MIT.

A pre-pull-request review process for checking a branch's cumulative code changes against the project's written rules and commitments. A pull request is a request for others to review and merge a branch; this process reports findings but does not approve or block the merge.

In plain words
What is it for?
Use it before opening or updating a pull request, marking one ready for review, or reviewing a named branch, pull request, or range of commits.
Why use it?
It catches inconsistencies, rule violations, and overlooked issues before a reviewer or automated service sees the changes. It keeps the final merge decision with deterministic checks and the project's maintainers.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: mentions subagents; installed under .agents/ (shared by several agents); mentions AGENTS.md.

This is pvliesdonk/scholar-mcp's own configuration. It tells Claude Code and Codex how to work on scholar-mcp itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything scholar-mcp configures →

Reuse

Borrowing it

Nothing to install: this file belongs to pvliesdonk/scholar-mcp. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/pvliesdonk/scholar-mcp/main/.agents/skills/self-reviewing/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/pvliesdonk/scholar-mcp

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for self-reviewing

README.md
[![agentmods](https://agentmods.dev/badge/skills/pvliesdonk/scholar-mcp/self-reviewing/github.svg)](https://agentmods.dev/skills/pvliesdonk/scholar-mcp/self-reviewing)
Your own site
<a href="https://agentmods.dev/skills/pvliesdonk/scholar-mcp/self-reviewing"><img src="https://agentmods.dev/badge/skills/pvliesdonk/scholar-mcp/self-reviewing/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for self-reviewing

Your own site · 80×15
<a href="https://agentmods.dev/skills/pvliesdonk/scholar-mcp/self-reviewing"><img src="https://agentmods.dev/badge/skills/pvliesdonk/scholar-mcp/self-reviewing.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 69 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,254 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin 94% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00069 $0.03254
Opus 5.5 $0.00028 $0.01302
Sonnet 5.5 $0.00014 $0.00651
Haiku 4.5 $0.00007 $0.00325

Measured 23d ago against content hash 1a80b12b6bb8, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

self-reviewing scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 23d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

94% identical to self-reviewing — 35 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

.agents/skills/self-reviewing/SKILL.md · 274 lines

How it starts

The opening of the file, as written. The whole thing — 274 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Self-review

This skill is the local self-review a change gets before its diff becomes someone else's problem: before a reviewer reads it, before a hosted bot spends the maintainer's tokens on it, before a fix costs a public push. It produces a findings report — it is not a gate. It never grants or withholds permission to push, and no ruleset requires it; deterministic CI remains the only merge gate. What it asks instead is honest convergence: every finding you report gets fixed or explicitly justified, in writing, before the push.

The review confirms preparation; it rarely discovers. Every criterion below is derived from files already open to you — the rules files, the diff, the code's own comments, the git history — so a clean first pass over a diff you wrote carefully is the normal outcome, not a lucky one.

When to run

  • Before gh pr create (or your agent's equivalent) on a fresh branch.
  • Before flipping a draft PR to ready.
  • Before any push that updates a branch with an open PR.
  • On request, against any named PR, branch, or range.

Small diffs are cheap to review; "docs-only" and "obvious" diffs are where contradicted comments and rule violations hide. Run it anyway.

Select the range

Review the cumulative diff — the same one every post-push reviewer sees — never "since my last push".

  1. Resolve the base ref, in this order of authority:
    • the base the invoker explicitly named — an explicit instruction beats recorded metadata (a stacked PR may need a comparison GitHub's recorded base does not give);
    • otherwise the PR's actual base branch, when a PR exists (gh pr view --json baseRefName);
    • only as fallback, derive it: the nearest of origin/<default>, origin/release/* and origin/integration/* by ancestry (the same derivation scripts/structural_gate.sh uses). Never assume main: a PR targeting release/X.Y or a stacked PR reviewed against the default branch sweeps in the base branch's whole divergence or misses the backport's scope. An integration/<epic> → main PR is the one exception to reviewing the whole range as new: every child was reviewed on its way into the integration branch. Review what those reviews could not see — the conflict resolutions in each merge of main (git log --remerge-diff --merges "origin/$BASE_REF..HEAD", git 2.36+), semantic conflicts with main, whether the children fit together and the docs describe the finished result, and the release impact (breaking markers, the Closes lines). docs/deployment/integration-branches.md covers the rebased case.
  2. Compute and check the endpoints before reviewing:

Read the full file on GitHub · 274 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 23d ago First seen · 274 lines · 69 tokens per session scan A 1a80b12b6bb8

Subscribe to this mod's changes

self-reviewing is a skill published in the GitHub repository pvliesdonk/scholar-mcp (2 stars, last pushed yesterday), licensed MIT. It adds 69 tokens to every session and 3,254 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. It is 94% identical to self-reviewing, differing in 35 lines, and is treated as a copy.