fizzy
installsforks
How to install fizzy?
basecamp/fizzy-cli/fizzy
$npx -y skills add basecamp/fizzy-cli --skill fizzyInteract with Fizzy via the Fizzy CLI. Manage boards, cards, columns, comments, steps, reactions, tags, users, notifications, pins, webhooks, and account settings. Use for ANY Fizzy question or action.
SKILL.md
| 1 | # /fizzy - Fizzy Workflow Command |
| 2 | |
| 3 | Full CLI coverage: boards, cards, columns, comments, steps, reactions, tags, users, notifications, pins, webhooks, account settings, search, and board migration. |
| 4 | |
| 5 | ## Agent Invariants |
| 6 | |
| 7 | **MUST follow these rules:** |
| 8 | |
| 9 | 1. **Cards use NUMBER, not ID** — `fizzy card show 42` uses the card number. Other resources use their `id` field. |
| 10 | 2. **Use built-in `--jq` for filtering** to reduce token output — `fizzy card list --jq '[.data[] | {number, title}]'`. Never pipe to external jq — use `--jq` instead. `--jq` implies `--json`, no need to pass both. |
| 11 | 3. **Check breadcrumbs** in responses for available next actions with pre-filled values. |
| 12 | 4. **Check for board context** via `.fizzy.yaml` or `--board` flag before listing cards. |
| 13 | 5. **Use `fizzy doctor` for setup/config/auth issues** before guessing — it is the primary read-only health check and includes remediation hints. |
| 14 | 6. **Rich text fields accept markdown or HTML** — use repeatable `--attach PATH` for simple end-appended inline attachments, or embed `<action-text-attachment>` tags manually when exact placement matters. |
| 15 | 7. **Card description is a string**, but comment body is a nested object — `.description` vs `.body.plain_text`. |
| 16 | 8. **Display the welcome message for new signups** — When `signup complete --name` returns `is_new_user: true`, you MUST immediately display the `welcome_message` field prominently to the user. This is a one-time personal note from the CEO — if you skip it, the user will never see it. |
| 17 | |
| 18 | ## Decision Trees |
| 19 | |
| 20 | ### Finding Content |
| 21 | |
| 22 | ``` |
| 23 | Need to find something? |
| 24 | ├── Know the board? → fizzy card list --board <id> |
| 25 | ├── Full-text search? → fizzy search "query" |
| 26 | ├── Filter by status? → fizzy card list --indexed-by maybe|closed|not_now|golden|stalled |
| 27 | ├── Filter by person? → fizzy card list --assignee <id> |
| 28 | ├── Filter by time? → fizzy card list --created today|thisweek|thismonth |
| 29 | └── Cross-board? → fizzy search "query" (searches all boards) |
| 30 | ``` |
| 31 | |
| 32 | ### Modifying Content |
| 33 | |
| 34 | ``` |
| 35 | Want to change something? |
| 36 | ├── Move to column? → fizzy card column <number> --column <id> |
| 37 | ├── Change status? → fizzy card close|reopen|postpone <number> |
| 38 | ├── Assign? → fizzy card assign <number> --user <id> |
| 39 | ├── Comment? → fizzy comment create --card <number> --body "text" |
| 40 | ├── Add step? → fizzy step create --card <number> --content "text" |
| 41 | └── Move to board? → fizzy card move <number> --to <board_id> |
| 42 | ``` |
| 43 | |
| 44 | ## Quick Reference |
| 45 | |
| 46 | | Resource | List | Show | Create | Update | Delete | Other | |
| 47 | |----------|------|------|--------|--------|--------|-------| |
| 48 | | account | - | `account show` | - | `account settings-update` | - | `account entropy`, `account export-create`, `account export-show EXPORT_ID`, `account join-code-show`, `account join-code-reset`, `account join-code-update` | |
| 49 | | identity | - | `identity show` | - | `identity timezone-update --timezone NAME` | - | - | |
| 50 | | board | `board list` | `board show ID` | `board create` | `board update ID` | `board delete ID` | `board accesses --board ID`, `board publish ID`, `board unpublish ID`, `board entropy ID`, `board closed`, `board postponed`, `board stream`, `board involvement ID`, `migrate board ID` | |
| 51 | | card | `card list` | `card show NUMBER` | `card create` | `card update NUMBER` | `card delete NUMBER` | `card move NUMBER`, `card publish NUMBER`, `card mark-read NUMBER`, `card mark-unread NUMBER` | |
| 52 | | search | `search QUERY` | - | - | - | - | - | |
| 53 | | activity | `activity list` | - | - | - | - | `activity list --board ID`, `activity list --creator ID` | |
| 54 | | column | `column list --board ID` | `column show ID --board ID` | `column create` | `column update ID` | `column delete ID` | `column move-left ID`, `column move-right ID` | |
| 55 | | comment | `comment list --card NUMBER` | `comment show ID --card NUMBER` | `comment create` | `comment update ID` | `comment delete ID` | `comment attachments show --card NUMBER` | |
| 56 | | step | `step list --card NUMBER` | `step show ID --card NUMBER` | `step create` | `step update ID` | `step delete ID` | |
People who liked this also viewed
6 picksType
- lark-openapi-explorer飞书/Lark 原生 OpenAPI 探索：从官方文档库中挖掘未经 CLI 封装的原生 OpenAPI 接口。当用户的需求无法被现有 lark-* skill 或 lark-cli 已注册命令满足，需要查找并调用原生飞书 OpenAPI 时使用。SkillsJul 2026
- lark-skill-maker创建 lark-cli 的自定义 Skill。当用户需要把飞书 API 操作封装成可复用的 Skill（包装原子 API 或编排多步流程）时使用。SkillsJul 2026
- azure-cost-optimizationOfficial agent plugin providing skills and MCP server configurations for Azure scenarios.SkillsJul 2026
- vercel-react-native-skillsVercel's official collection of agent skillsSkillsJul 2026
- mcp-builderGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate externaSkillsJul 2026
- gws-sharedgws CLI: Shared patterns for authentication, global flags, and output formatting.SkillsJul 2026
