{
  "markdown": "<p align=\"center\"><img src=\"logo.png\" width=\"120\" alt=\"logo\" /></p>\n\n# fizzy-skill\n\nA Claude Code / Codex CLI **skill** for operating a self-hosted [Fizzy](https://github.com/tobiasbischoff/fizzy-cli) kanban board — onboarding, daily card/comment CRUD, and end-to-end Jira-to-Fizzy migration.\n\n**Landing page:** https://cskwork.github.io/fizzy-skill/\n\n## Why this exists\n\nFizzy is a Basecamp-style kanban tool. Its CLI works well, but the server's renderer has subtle quirks that bite every first-time integrator:\n\n- **Fizzy is NOT a markdown renderer.** `**bold**` stays as literal asterisks. The server accepts HTML but silently strips `<h*>`, `<strong>`, `<hr>`, `<a href>`, `<img>`, `<pre>`, `<table>`.\n- **`--json` is a global flag** — it must come *before* the subcommand, or it is silently ignored.\n- **`comment list` paginates silently** — page 1 returns roughly 3 items; the rest are invisible unless you loop.\n- **Single-account auto-default is NOT done by the CLI** — `fizzy-cli account set <SLUG>` is required even when only one account exists.\n- **`auth login --email --code` in non-TTY** re-issues a code on every call, invalidating the one already in the user's inbox.\n\nThis skill bakes those traps into one decision-tree document so an agent can hit the ground running.\n\n## What's in the box\n\n| Path | Purpose |\n|---|---|\n| `SKILL.md` | The skill itself — onboarding, daily ops, Jira migration, Fizzy HTML quirks |\n| `scripts/adf_to_fizzy.py` | ADF → Fizzy-optimal hybrid HTML (recommended for cards/comments) |\n| `scripts/adf_to_md.py` | ADF → markdown (for non-Fizzy targets) |\n| `scripts/adf_to_plain.py` | ADF → pure plain text |\n| `scripts/jira_to_fizzy.py` | End-to-end Jira issue → Fizzy card(s) migrator with retry + pagination-safe wipe |\n| `scripts/atlassian_attachments.py` | PAT-based attachment downloader (acli OAuth scope can't fetch attachment content) |\n| `references/magic-link-curl-two-step.md` | Non-TTY magic-link workaround |\n| `references/operations.md` | Extended fizzy-cli command reference |\n\n## Install\n\nThe repo is a single SKILL.md plus a `scripts/` folder. Drop it into your skills directory:\n\n```bash\n# Claude Code\ngit clone https://github.com/cskwork/fizzy-skill.git ~/.claude/skills/fizzy\n\n# Codex CLI (same SKILL.md format)\ngit clone https://github.com/cskwork/fizzy-skill.git ~/.codex/skills/fizzy\n```\n\nBoth ecosystems read the YAML front matter and Markdown body identically, so a single clone serves either CLI.\n\n## Quick start\n\n```bash\nexport FIZZY_HOST=\"https://fizzy.example.com\"\nexport FIZZY_TOKEN=\"...\"          # PAT from your Fizzy account settings\n\nfizzy-cli config set --base-url \"$FIZZY_HOST\"\nfizzy-cli auth   login --token \"$FIZZY_TOKEN\"\nfizzy-cli account set <SLUG>      # required even with one account\nfizzy-cli board list\n```\n\nFor migration:\n\n```bash\npython3 scripts/jira_to_fizzy.py \\\n  --from-json /tmp/PROJ-123.json \\\n  --board <fizzy-board-id> \\\n  --site your-site.atlassian.net \\\n  --split-numbered\n```\n\nSee [`SKILL.md`](./SKILL.md) for the full guide and the [landing page](https://cskwork.github.io/fizzy-skill/) for a quick visual overview.\n\n## License\n\n[MIT](./LICENSE) — use freely, including in commercial projects. No warranty.\n\n## Acknowledgements\n\n- [`tobiasbischoff/fizzy-cli`](https://github.com/tobiasbischoff/fizzy-cli) — the upstream CLI this skill operates.\n- Atlassian Document Format spec — the source of truth for the ADF → HTML/plain converters.\n",
  "bytes": 3438,
  "sha": "a8bf1f64aa94bd27d21b7b5bbe58b61f0bd66b2172b8a25cebda378dcf2afd86",
  "repo_slug": "cskwork/fizzy-skill",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_cskwork_fizzy_skill_1876a941/readme"
}