kselfreview

Reviews uncommitted or unpushed work through four adversarial interrogations before external review rounds.

2|1|Updated Feb 5, 2026
One-click install
npx skills add https://github.com/kpiteira/devops-ai --skill kselfreview-kpiteira
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kselfreview
Source: https://github.com/kpiteira/devops-ai/tree/main/skills/kselfreview
Command: npx skills add https://github.com/kpiteira/devops-ai --skill kselfreview-kpiteira

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Self-authored checks inherit the author's blind spots, so defects in checks, stale documentation claims, non-idempotent procedures, and regressions from earlier fixes survive until expensive external review rounds. This Skill catches those defect classes in one pass over your own uncommitted or unpushed work before requesting Copilot or human review. ## Core Features & Use Cases - Falsify every check: Constructs the failure each alert, assertion, guard, or test exists to catch and confirms it actually trips, including ambiguous-negative and pagination traps. - Source every factual claim: Audits documentation for stale, duplicated, or contradicted statements about live systems, requiring re-derivation commands or timestamps. - Run every procedure twice: Walks deploy, rollback, and migration procedures for second-run, resumed-run, and partial-rollback failure modes. - Re-examine closed findings: Revisits prior fixes and dismissals after each round, since a finding's severity is a function of the whole system. - Shape check: Collapses findings sharing a root cause into one systemic finding instead of a list of sibling sites. - Use Case: Before pushing a PR with new Prometheus alert rules and a runbook, run the pass to discover an alert that can never fire, a documented IP marked "free" that DNS still resolves, and a backup step that overwrites the good copy on rerun. ## Quick Start Ask the AI to run kselfreview on your current working tree and unpushed commits to interrogate checks, factual claims, and procedures before requesting external review.

Frequently Asked Questions about kselfreview

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review my own code before requesting a PR review?

Run the pass over your working tree and unpushed commits using git diff against the merge base. It interrogates every check, factual claim, and procedure you introduced, then reports ranked findings with file and line references.

How to test whether an alert or assertion can actually fail?

Construct the failure input the check exists to catch and run it in a scratch script, confirming it trips. If you cannot make it go red, the check is decorative and should be fixed or deleted.

Can this review unpushed commits and uncommitted changes together?

Yes. With no arguments it diffs the merge base against the working tree, covering committed, staged, and unstaged changes in one pass. Untracked files are read in full since no diff exists for them.

Does the self-review pass modify production infrastructure?

No. It is read-only on infrastructure and falsifies checks by simulation in scratch scripts, never in production. Claims that can only be settled live are flagged for the human to decide.

When should I run self-review versus requesting Copilot review?

Run it before any external review round, including Copilot requests. External rounds cost time and money, while this pass catches the roughly one-third of findings that diff-reading reviewers structurally cannot see.