Skip to content
Skills Library
Programming · Testing

verify-changes

/verify-changes

Use this skill whenever the user wants to verify refactored code, run a verification checklist, check that refactoring didn't break anything, validate changes before deployment, or assess the quality of a completed refactoring. Triggers include: "verify the refactoring", "check if everything works", "run the verification", "is the refactor safe to deploy", "validate the changes", "compare before and after", "check performance", or any request to ensure refactored code is correct and deployable. Do NOT use for writing refactored code — use refactor-code for that.

Licence
MIT
Last repository change
12.06.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 12.06.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Use this skill whenever the user wants to verify refactored code, run a verification checklist, check that refactoring didn't break anything, validate changes before deployment, or assess the quality of a completed refactoring. Triggers include: "verify the refactoring", "check if everything works", "run the verification", "is the refactor safe to deploy", "validate the changes", "compare before and after", "check performance", or any request to ensure refactored code is correct and deployable. Do NOT use for writing refactored code — use refactor-code for that.

Triggers from the description

verify the refactoringcheck if everything worksrun the verificationis the refactor safe to deployvalidate the changescompare before and aftercheck performance
Original author description

Use this skill whenever the user wants to verify refactored code, run a verification checklist, check that refactoring didn't break anything, validate changes before deployment, or assess the quality of a completed refactoring. Triggers include: "verify the refactoring", "check if everything works", "run the verification", "is the refactor safe to deploy", "validate the changes", "compare before and after", "check performance", or any request to ensure refactored code is correct and deployable. Do NOT use for writing refactored code — use refactor-code for that.

How it works

  1. Quick Decision Tree
  2. Workflow
  3. Output
  4. Important Notes
Original SKILL.md headings · 102 lines, 527 words
SKILL.md preview
---
name: verify-changes
description: >
  Use this skill whenever the user wants to verify refactored code, run a verification
  checklist, check that refactoring didn't break anything, validate changes before deployment,
  or assess the quality of a completed refactoring. Triggers include: "verify the refactoring",
  "check if everything works", "run the verification", "is the refactor safe to deploy",
  "validate the changes", "compare before and after", "check performance", or any request
  to ensure refactored code is correct and deployable.
  Do NOT use for writing refactored code — use refactor-code for that.
---

# Verify Changes Skill

You are performing Phase 4 (Verify & Deploy) of the Refactor Pilot Framework. Your job is
to ensure that refactored code is correct, performant, and safe to deploy.

## Quick Decision Tree

```
Do baselines exist (refactor-notes/baselines.md)?
├── NO → Run capture-baselines.sh first for comparison data
└── YES → Compare against baselines

Are all tests passing?
├── NO → Identify: is the test wrong or the code wrong?
│   ├── Test was testing implementation details → Update test
│   └── Code has a regression → Fix the code
└── YES → Continue to benchmarking

Is the refactored code deployed behind a feature flag?
├── YES → Recommend canary deployment with monitoring
└── NO → Recommend adding feature flag for gradual rollout
    └── Low-risk change? → Standard deployment may be fine
```

## Workflow

### Step 1: Run Full Test Suite

Execute all tests:
- Unit tests
- Integration tests
- Type checking (`tsc --noEmit`, `mypy`, `cargo check`, etc.)
- Linting (`eslint`, `ruff`, `clippy`, etc.)

Report results clearly:
- Total tests: X passed, Y failed, Z skipped
- Type errors: count and description
- Lint warnings: count and severity

If any tests fail:
1. Identify whether the test or the code is wrong
2. If the code is wrong, propose a fix
3. If the test was testing implementation details that correctly changed, note it for update

### Step 2: Benchmark Comparison

Compare refactored code against baselines from `refactor-notes/baselines.md`:

| Metric | Before | After | Difference | Status |
|--------|--------|-------|------------|--------|
| Bundle size | | | | |
| Build time | | | | |
| Test suite time | | | | |
| Line count | | | | |
| TODO/FIXME count | | | | |
| TypeScript `any` count | | | | |

Flag any metric that regressed by more than 10%.

### Step 3: Generate Verification Checklist

Based on the specific changes made, generate a tailored checklist covering:

- **Functional verification** — specific behaviors to test for each changed file
- **Integration checks** — consumer compatibility, API payloads, shared state
- **Visual regression** — UI appearance, responsiveness, accessibility
- **Deployment readiness** — feature flags, rollback plan, monitoring

Mark each item with priority:
- 🔴 Must pass before deployment
- 🟡 Should pass, monitor if not
- 🟢 Nice to verify, low risk

### Step 4: Deployment Recommendations

Based on the verification results, recommend a deployment strategy:

- **Green light** — All checks pass, safe for standard deployment
- **Cautious** — Minor concerns, recommend feature flag or canary deployment
- **Hold** — Issues found, needs fixes before deployment

See `references/deployment-strategies.md` for detailed deployment playbooks.

## Output

Present a verification report with:
1. Test results summary
2. Performance comparison table (against baselines)
3. Verification checklist with status
4. Deployment recommendation
5. Any remaining action items

Save as `refactor-notes/07-verification-report.md`.

## Important Notes

- Be thorough. Missing a subtle regression is worse than being overly cautious.
- If benchmarking tools aren't available, provide instructions for manual benchmarking.
- The verification report is a valuable artifact — encourage saving it with the PR.
- Recommend 72-hour monitoring period after deployment.
Files in this package (2)
  • SKILL.md 4 KB
  • references/deployment-strategies.md 2 KB

Versions

RepositoryScoreLicence
This page · guilhermevozniak/refactor-pilot-framework100MIT
ben-ralston/reading-list100MIT
ben-ralston/apple-notes-graph100MIT
ben-ralston/tmux-agent-hq100MIT
k0siara/skills100MIT

Database snapshot: 13.11.2026 · package version 7e5524a9e4bc (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100analyze-codebase
    Use this skill whenever the user wants to understand, analyze, or audit a codebase before refactoring. Triggers include: "analyze this project", "what does this codebase do", "give me an overview of the code", "audit dependencies", "map the file structure", "what are the code…
  • 100verification-loop
    This skill should be used when the user asks to "verify code", "run verification", "check quality", "validate changes", or before creating a PR. Provides comprehensive verification including build, type check, lint, tests, security scan, and diff review.
  • 86refactoring
    Use when the user asks to refactor code.
  • 100comprehensive-review
    Use this skill when the user wants to review code changes, verify implementation quality, or check readiness before a PR or deployment. Trigger on phrases like "review my changes", "run comprehensive review", "check all my code", "am I ready for PR", "before I create a PR",…
  • 100visual-diff
    Visual Regression Testing — screenshot comparison before and after changes. Use when user wants to check for visual regressions, compare UI changes, or verify CSS/layout changes didn't break anything.
  • 100refactor
    Multi-target refactoring orchestrator. Use when: cleaning up messy code/docs, simplifying code, restructuring documents, batch cleanup. Not for: new features (use feature-dev), bug fixes (use bug-fix), code understanding (use code-explore). Output: refactored code/docs + review gate.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.