flow-skip

Skip a specified task in the Beads system and log details to skipped.md.

15|4|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/cofin/flow --skill flow-skip
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: flow-skip
Source: https://github.com/cofin/flow/tree/main/templates/codex/skills/flow-skip
Command: npx skills add https://github.com/cofin/flow --skill flow-skip

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires br, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill allows users to skip a current task with a documented reason, ensuring that task progress is managed and justified.

Core Features & Use Cases

  • Task Skipping: Mark tasks as skipped when they are no longer needed, out of scope, or blocked.
  • Justification Logging: Records the reason for skipping a task for auditability.
  • Beads Integration: Updates the Beads task management system to reflect the skipped status.
  • Use Case: If a planned task becomes irrelevant due to a change in project requirements, use this Skill to formally skip it and document why.

Quick Start

Use the flow-skip skill to skip task with ID '123' because it is out of scope.

Frequently Asked Questions about flow-skip

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

FAQPage Schema
How do I skip a task in the Beads workflow system and record the reason?▼

To skip a task in the Beads workflow system, you close the specified task by providing a justification reason. The system then logs the skipped task details, including its description and your reason, directly into a skipped.md audit file within the project's specification directory.

What is the best way to document task abandonment in a project specification?▼

Documenting task abandonment is best handled by logging the task description and a justification reason into a skipped.md file. This creates a clear audit trail within the project specification directory, ensuring task progress is managed and justified for future review.

When should I formally skip a task instead of deleting it from my workflow?▼

You should formally skip a task when it becomes irrelevant, out of scope, or blocked due to changing project requirements. Skipping preserves an audit trail of the task description and reason in a skipped.md file, whereas deleting removes it entirely from the workflow history.

Does the Beads task management system support logging skipped tasks to markdown?▼

Yes, the Beads task management system supports logging skipped tasks to markdown. When you close a task with a provided reason, it automatically generates a skipped.md file in the project's specification directory to maintain a documented audit trail.

How do I close a blocked task in Beads and keep an audit trail?▼

To close a blocked task in Beads while keeping an audit trail, you skip the task by providing a specific justification. This action closes the task in the workflow and appends the task details and reason to a skipped.md file for documentation.