SKILL·1D3D85

preservation-verifier

conorbronsdon
Updated 13 days ago
4 views
4,472
393
4,472
View on GitHub
Documentationai

About

The Preservation Verifier skill deterministically checks whether a rewrite or edit preserved specific protected content like code, links, and data structures. It is triggered when a user provides original and rewritten versions for comparison, often following actions from other skills like `voice-preserving-rewriter`. Its core function is to verify the integrity of key elements and identify any AI-pattern regressions.

Quick Install

Claude Code

Recommended
Primary
npx skills add conorbronsdon/avoid-ai-writing -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/conorbronsdon/avoid-ai-writing
Git CloneAlternative
git clone https://github.com/conorbronsdon/avoid-ai-writing.git ~/.claude/skills/preservation-verifier

Copy and paste this command in Claude Code to install this skill

Documentation

Preservation Verifier

Verify that a rewrite or file edit kept the content the original ../avoid-ai-writing/SKILL.md says to protect.

For cross-Skill work, follow ../avoid-ai-writing-router/references/handoff-contract.md and ../avoid-ai-writing-router/references/skill-graph.json.

Connection contract

Incoming

Accept before/after verification from:

  • avoid-ai-writing-router via ROUTE when the user directly supplies before and after material.
  • voice-preserving-rewriter via VERIFY after returned-text rewriting.
  • file-edit-in-place via VERIFY after an authorized named-file mutation.

Require both original and current versions. If either is unavailable, return control to the router rather than inventing a comparison.

Produce

Update the handoff envelope with:

  • execution_evidence.verifier: executed only if the bundled validator ran, otherwise model_only.
  • verification_summary.status: PASS, REVIEW, or FAIL.
  • blocking errors and warnings.
  • exact repair target when repair is possible.

A FAIL is a blocking workflow result. The rewrite/edit stage is not complete merely because text was produced or a file write succeeded.

Outgoing

  • REPAIR to voice-preserving-rewriter when returned text failed preservation.
  • REPAIR to file-edit-in-place when a named file failed preservation.
  • RECHECK to ai-writing-detector only when convergence or a residual audit was part of the user's request.
  • Stop on PASS unless another user-requested stage remains.
  • Stop and report on a second verification failure. Do not start another repair loop.

Architecture and implementation lenses

Apply both encoded lenses from ../avoid-ai-writing-router/references/agency-role-lenses.md:

  • agency-software-architect: verification is a boundary gate with explicit ownership and bounded repair cycles.
  • agency-senior-developer: execution claims require actual command evidence, errors propagate, and before/after state remains attributable to the correct target.

The verifier does not rewrite content itself.

Preferred deterministic path

The bundled scripts/validate.js is an exact copy of the source repository's preservation validator. When Node execution is available, run:

node scripts/validate.js before.md after.md

For programmatic use:

const { validate } = require("./scripts/validate.js");

The validator checks protected structures and reports blocking errors separately from warnings. Never claim it ran unless the current host executed it.

If execution is unavailable, compare the original and rewrite manually using the same preservation contract and label the result as model_only.

Additional protected constraints

In addition to the canonical validator's structural checks, honor protected semantic constraints carried in the handoff envelope.

When human_representation_sensitive: true, review identity and representation details protected by the agency-inclusive-visuals-specialist lens. A structurally valid rewrite may still require REVIEW or FAIL if it erased or genericized material cultural, geographic, disability, attire, skin-tone/lighting, physical-reality, or anti-stereotype constraints.

Do not claim the deterministic validator checked semantic representation details that it does not implement. Report that portion separately as model-only semantic review.

Result handling

PASS

No blocking preservation error was found. Continue only if another requested stage remains.

REVIEW

Warnings or semantic changes need judgment but are not automatically blocking. Explain the exact uncertainty.

FAIL

Protected content changed or disappeared. Identify the correct repair owner from source kind:

  • returned text -> voice-preserving-rewriter
  • named file -> file-edit-in-place

Pass only the blocking repair scope and existing envelope. Do not ask the repair owner to redo clean parts.

Repair-loop limit

One repair re-entry is allowed. After repair, verify once more. If that second check still fails, stop and report the unresolved errors. Never cycle indefinitely.

Output

Return PASS, FAIL, or REVIEW, verifier execution status, blocking preservation errors, warnings, any separate semantic-guard review, the suggested repair owner, and whether the bounded repair opportunity has already been used.

GitHub Repository

conorbronsdon/avoid-ai-writing
Path: skills/preservation-verifier
0
ai-writingclaudeclaude-codellmprompt-engineeringskill
FAQ

Frequently asked questions

What is the preservation-verifier skill?

preservation-verifier is a Claude Skill by conorbronsdon. Skills package instructions and resources that Claude loads on demand, so Claude can perform preservation-verifier-related tasks without extra prompting.

How do I install preservation-verifier?

Use the install commands on this page: add preservation-verifier to Claude Code as a plugin, or clone its repository into your skills directory, then restart Claude so it picks up the skill.

What category does preservation-verifier belong to?

preservation-verifier is in the Documentation category, tagged ai.

Is preservation-verifier free to use?

Yes. preservation-verifier is listed on AIMCP and free to install.

Related Skills

railway-docs
Documentation

This skill fetches current Railway documentation to answer questions about features, functionality, or specific docs URLs. It ensures developers receive accurate, up-to-date information directly from Railway's official sources. Use it when users ask how Railway works or reference Railway documentation.

View skill
n8n-code-python
Documentation

This Claude Skill provides expert guidance for writing Python code in n8n's Code nodes, specifically for using Python's standard library and working with n8n's special syntax like `_input`, `_json`, and `_node`. It helps developers understand Python's limitations within n8n and recommends using JavaScript for most workflows while offering Python solutions for specific data transformation needs.

View skill
archon
Documentation

The Archon skill provides RAG-powered semantic search and project management through a REST API. Use it for querying documentation, managing hierarchical projects/tasks, and performing knowledge retrieval with document upload capabilities. Always prioritize Archon first when searching external documentation before using other sources.

View skill
n8n-code-javascript
Documentation

This Claude Skill provides expert guidance for writing JavaScript code in n8n's Code nodes. It covers essential n8n-specific syntax like `$input`/`$json` variables, HTTP helpers, and DateTime handling, while troubleshooting common errors. Use it when developing n8n workflows that require custom JavaScript processing in Code nodes.

View skill