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.