audit-remediation

Executes approved audit remediation plans with validation, rollback, checkpoints, and handoff updates.

Updated Aug 1, 2026
One-click install
npx skills add https://github.com/QuyDu/Skills-Orchestrator --skill audit-remediation-quydu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audit-remediation
Source: https://github.com/QuyDu/Skills-Orchestrator/tree/main/.github/skills/audit-remediation
Command: npx skills add https://github.com/QuyDu/Skills-Orchestrator --skill audit-remediation-quydu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After a security or code audit produces a remediation plan, teams still face the risky work of actually applying fixes in the right order, with approvals, validation, and rollback safety. This Skill executes an approved audit remediation plan deterministically, preserving finding traceability, dependency order, and durable progress state so partial work is never marked complete. ## Core Features & Use Cases - Scoped execution modes: Run all eligible items, a single phase (milestone), a single finding (AUD-id), or resume from the last valid checkpoint. - Governed execution: Policy evaluation before every gated item, phase-level approval gates, and separate point-of-action approval for destructive, external, or privileged actions. - Validation and rollback: Each item runs the narrowest falsifying validation, follows plan rollback guidance on failure, and blocks dependent items until prerequisites pass. - Event-sourced progress: Appends outcomes to an immutable execution log, creates content-addressed checkpoints, and updates project handoff artifacts after every phase. - Use Case: After audit-plan-remediation produces reports/audit-remediation-plan.json, run /audit-remediation -Phase containment to execute the containment milestone and its prerequisites with approvals, validation, and checkpointed handoff. ## Quick Start Ask the agent to run /audit-remediation -All to execute every eligible item from the approved remediation plan in dependency order with phase approvals.

Frequently Asked Questions about audit-remediation

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

FAQPage Schema
How do I execute an audit remediation plan?

Run the skill with exactly one selection mode: -All for every eligible item, -Phase <milestone-id> for one milestone, -Finding <AUD-id> for one finding, or -Resume to continue from the last checkpoint. The plan must first be produced and validated by audit-plan-remediation.

How do I resume an interrupted remediation run?

Use the -Resume mode, which verifies event and checkpoint integrity, plan digest, repository identity, and working-tree compatibility before continuing. Stale, ambiguous, or drifted state is refused and routed to workflow-recovery instead of being silently continued.

Can audit-remediation run without an approved remediation plan?

No. The skill rejects raw findings or unreviewed audits and requires a validated plan in reports/audit-remediation-plan.json that matches the current repository and revision. Use audit-plan-remediation first to produce that plan.

What approvals does audit remediation require before making changes?

Each remediation phase requires explicit approval before mutation begins. Destructive, external, privileged, credential, deployment, commit, push, publication, or risk-acceptance actions always require separate point-of-action approval, and selection modes never grant approval themselves.

What happens when a remediation item fails validation?

The item stops, diagnostics are preserved, and the plan's rollback guidance is followed when rollback is safe and approved. Dependent items are blocked, the failure is recorded in the event log, and partial work is never marked complete.

When should I not use audit-remediation?

Do not use it to discover, review, or prioritize findings; those belong to audit-code and audit-plan-remediation. It also refuses to run when the plan is stale, the repository has drifted, or required approvals are missing.