task-invalidate

Invalidates a task by updating its frontmatter fields with reason and supersession.

6|1|Updated Jan 5, 2026
One-click install
npx skills add https://github.com/JordanGunn/skills --skill task-invalidate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: task-invalidate
Source: https://github.com/JordanGunn/skills/tree/main/skills/task/invalidate
Command: npx skills add https://github.com/JordanGunn/skills --skill task-invalidate

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Invalidation of tasks preserves history while removing outdated or incorrect tasks from active workflows, ensuring plans stay current and decisions are not repeated.

Core Features & Use Cases

  • Invalidate a task by setting epistemic_state to invalidated and recording invalidated_by and invalidated_reason.
  • Optionally specify superseded_by to point to a replacement task and update lifecycle_state accordingly.
  • Maintain an auditable trail with mandatory invalidation reasons and who performed the action.

Quick Start

Invalidate a task by providing who, why, and which task to invalidate, then review the updated task frontmatter.

Frequently Asked Questions about task-invalidate

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

FAQPage Schema
How do I invalidate a task while preserving its workflow history?

To invalidate a task, you provide who is invalidating it, the reason, and the target task. The process updates the task frontmatter fields epistemic_state and invalidated_by while preserving the original history for auditability.

What task frontmatter fields are updated when invalidating a workflow task?

Task invalidation updates frontmatter fields including epistemic_state, invalidated_by, invalidated_reason, and optionally superseded_by and lifecycle_state to reflect the formal removal from active workflows.

When should I invalidate a task instead of deleting it?

Task invalidation is necessary when you need to remove outdated or incorrect tasks from active workflows while preserving their history, ensuring plans stay current and past decisions are not repeated.

Can I point an invalidated task to a replacement task?

Yes, you can optionally specify superseded_by to point to a replacement task. This updates the lifecycle_state accordingly, maintaining a clear auditable trail of task supersession in the workflow.

Do I need a documented reason to invalidate a task in production agent workflows?

Yes, task invalidation requires a mandatory documented reason and records who performed the action. This maintains an auditable trail of formal invalidation in production agent workflows.