final-review SKILL.md skillA

final-review from karsten-s-nielsen/mad-scientist-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add karsten-s-nielsen/mad-scientist-skills/final-review@git:20260929.7b74d3a

Pins git:20260929.7b74d3a in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
karsten-s-nielsen/mad-scientist-skills
Path
plugins/mad-scientist-skills/skills/final-review/SKILL.md
Versions recorded
5
Latest version
git:20260929.7b74d3a, committed Sep 29, 2026
First version recorded
Mar 29, 2026
Size
14,022 bytes
Repository stars
3
License
MIT

Pre-commit quality gate — reviews all code and documentation for consistency, best practices, and completeness, then generates or updates the C4 architecture diagram. Use before committing, or when you want a thorough quality check of the project. Triggers on phrases like "final review", "pre-commit check", "review everything before commit", or "make sure everything is up to date".

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Final Review

A comprehensive pre-commit quality gate that ensures code, documentation, and architecture diagrams are consistent, complete, and follow professional standards.

## When to use this skill

- Before committing or pushing changes
- After completing a feature or significant refactor
- When the user says "final review", "check everything", "make sure it's all up to date", or "review before commit"
- Periodically to catch documentation drift

## Review process

Execute all phases in order. Do NOT skip phases. Do NOT claim completion without evidence.

### Phase 1: Codebase Discovery

Explore the project to understand its current state:

- Read the project's `CLAUDE.md`, `AGENTS.md`, `README.md`, and any other root-level documentation
- Identify the tech stack, project structure, and architectural patterns
- Note the testing framework and how tests are run
- Identify all configuration files (`package.json`, `pyproject.toml`, `tsconfig.json`, etc.)

### Phase 2: Code Quality Review

Review all source code as a professional software architect:

- **Consistency**: Naming conventions, file organization, import patterns, error handling patterns
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add karsten-s-nielsen/mad-scientist-skills/final-review@sha256:1a75437b46765a84

The line at the top of this page pins the label git:20260929.7b74d3a, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_iok4cfcozi737swc.svg)](https://markdownregistry.com/a/art_iok4cfcozi737swc)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Mar 29, 2026 and Sep 29, 2026, about one every 46 days.

versioncommittedcommitsizeaudit
git:20260929.7b74d3a latest2026-09-29 7b74d3a 14,022 BA view · diff
git:20260926.35dafdd2026-09-26 35dafdd 13,694 BA view · diff
git:20260829.a5492d22026-08-29 a5492d2 13,642 BA view · diff
git:20260414.9c3849d2026-04-14 9c3849d 8,624 BA view · diff
git:20260329.f91268f2026-03-29 f91268f 7,255 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (14022 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

karsten-s-nielsen/mad-scientist-skills · 3 stars · license MIT · pushed 2026-10-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_iok4cfcozi737swc
GET https://markdownregistry.com/api/v1/resolve?ref=karsten-s-nielsen/mad-scientist-skills/final-review
GET https://markdownregistry.com/api/v1/blob/1a75437b46765a84f774d98cdf5680ed56a5e66858d423d047010d3aac967ca2

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from karsten-s-nielsen/mad-scientist-skills

AGENTS.md AGENTS.md file
karsten-s-nielsen/mad-scientist-skills · AGENTS.md
git:20260926.35dafdd · audit A · 3 stars
CLAUDE.md CLAUDE.md file
karsten-s-nielsen/mad-scientist-skills · CLAUDE.md
git:20260926.35dafdd · audit B · 3 stars
architecture-audit SKILL.md skill
karsten-s-nielsen/mad-scientist-skills · plugins/mad-scientist-skills/skills/architecture-audit/SKILL.md · Comprehensive architecture audit with two modes and a single tier (beta). Planning mode evaluates architectural…
git:20260926.35dafdd · audit A · 3 stars
c4 SKILL.md skill
karsten-s-nielsen/mad-scientist-skills · plugins/mad-scientist-skills/skills/c4/SKILL.md · Creates interactive C4 model architecture diagrams using Structurizr DSL — the official C4 notation by Simon Brown…
git:20260813.1e1da60 · audit B · 3 stars
cognitive-interface-audit SKILL.md skill
karsten-s-nielsen/mad-scientist-skills · plugins/mad-scientist-skills/skills/cognitive-interface-audit/SKILL.md · Comprehensive cognitive interface audit with two modes and a single tier. Planning mode designs task models, user…
git:20260926.35dafdd · audit A · 3 stars
documentation-audit SKILL.md skill
karsten-s-nielsen/mad-scientist-skills · plugins/mad-scientist-skills/skills/documentation-audit/SKILL.md · Comprehensive documentation audit with two modes and a single tier. Planning mode designs documentation strategy…
git:20260926.35dafdd · audit A · 3 stars
measure-before-optimize SKILL.md skill
karsten-s-nielsen/mad-scientist-skills · plugins/mad-scientist-skills/skills/measure-before-optimize/SKILL.md · Pre-change measurement gate for perf-sensitive functions. Use BEFORE modifying any function that has a pytest-benchmark…
git:20260929.7b74d3a · audit A · 3 stars
observability-audit SKILL.md skill
karsten-s-nielsen/mad-scientist-skills · plugins/mad-scientist-skills/skills/observability-audit/SKILL.md · Comprehensive observability audit with two modes and two tiers (beta). Planning mode designs telemetry strategy…
git:20260416.d18ed8c · audit A · 3 stars
optimization-audit SKILL.md skill
karsten-s-nielsen/mad-scientist-skills · plugins/mad-scientist-skills/skills/optimization-audit/SKILL.md · Comprehensive optimization audit with two modes and a single tier. Planning mode designs performance strategy, capacity…
git:20260929.7b74d3a · audit B · 3 stars
research-discipline SKILL.md skill
karsten-s-nielsen/mad-scientist-skills · plugins/mad-scientist-skills/skills/research-discipline/SKILL.md · Use when designing or validating a quantitative metric, model, or ranking, when pre-registering an analysis, or before…
git:20261001.d0fd4dd · audit A · 3 stars
security-audit SKILL.md skill
karsten-s-nielsen/mad-scientist-skills · plugins/mad-scientist-skills/skills/security-audit/SKILL.md · Comprehensive security audit with two modes and two tiers. Planning mode reviews architecture for security gaps (STRIDE…
git:20260724.35d8a81 · audit B · 3 stars
unbiased-review SKILL.md skill
karsten-s-nielsen/mad-scientist-skills · plugins/mad-scientist-skills/skills/unbiased-review/SKILL.md · Use when reviewing a spec, plan, or implementation produced by another session - verifies its claims against the actual…
git:20260929.7b74d3a · audit A · 3 stars

Every file in karsten-s-nielsen/mad-scientist-skills

Other files named final-review

final-review SKILL.md skill
skymanbp/sci-paper · skills/final-review/SKILL.md · Pre-submission final-review orchestrator. Each round loads /sci-paper:paper and SCIPAPER_STANDARD as the framework…
git:20261002.7e38af6 · audit A · 6 stars

Browse by kind, by grade A, or by owner.