fizzy-workflow

Automates Fizzy card workflows for starting, completing, and delegating work via the Fizzy CLI.

1|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/akhy/agent-skills --skill fizzy-workflow-akhy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fizzy-workflow
Source: https://github.com/akhy/agent-skills/tree/main/fizzy-workflow
Command: npx skills add https://github.com/akhy/agent-skills --skill fizzy-workflow-akhy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Managing work items in Fizzy requires many manual CLI steps — moving cards between columns, assigning users, posting progress comments, and closing cards after commits. This Skill turns those scattered operations into structured, repeatable workflows so nothing gets skipped. ## Core Features & Use Cases - Structured Card Workflows: Start cards (move to Doing, self-assign, create feature branch), update progress with step completion and concise comments, and complete cards with conventional commits, merge to main, and closure. - Batch Card Planning: Create multiple cards with tags and steps from a single JSON plan file, with dry-run validation and partial-failure reporting. - Human Delegation: Assign cards to human users with explanatory comments when tasks need manual decisions or approvals. - Use Case: You are asked to work on Fizzy card #15. The Skill reads the card and comments, creates a feature branch, moves the card to Doing, tracks step completion, commits with conventional format, posts the commit link, and closes the card. ## Quick Start Ask the agent to start working on Fizzy card number 15 and follow the full workflow through completion.

Frequently Asked Questions about fizzy-workflow

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

FAQPage Schema
How do I start working on a Fizzy card from the CLI?▼

Read the card with fizzy card show and its comments, create a feature branch from main, find the Doing column ID via fizzy column list, move the card with fizzy card column, and self-assign with fizzy card self-assign.

How to create multiple Fizzy cards at once from a plan?▼

Write a JSON plan file listing board_id and cards with titles, tags, and steps, then run the fizzy-plan-create.py script. Use --dry-run first to validate; the script outputs JSON with created card numbers or partial progress on failure.

Does the fizzy-workflow skill require jq to be installed?▼

jq is optional. Examples use fizzy's built-in --jq flag, and the helper shell scripts automatically fall back to external jq if that flag is unavailable. Only the fizzy binary itself is strictly required in PATH.

When should a Fizzy card be closed after finishing work?▼

Close a card only after changes land in the main branch, either via a merged PR/MR or a direct no-fast-forward merge. Post a completion comment with the commit link first, then run fizzy card close.

Can I delegate a Fizzy card to a human instead of completing it?▼

Yes. Find the person's user ID with fizzy user list, assign with fizzy card assign, and post a comment explaining why human input is needed, such as deployment decisions or security reviews.