# Storybloq

Open the current local project's Storybloq board, read its context and handovers, or...

- Repository: https://github.com/Storybloq/storybloq (787 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-10-19
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add Storybloq/storybloq --skill storybloq -g -a claude-code -y`
Codex: `npx skills add Storybloq/storybloq --skill storybloq -g -a codex -y`
Cursor: `npx skills add Storybloq/storybloq --skill storybloq -g -a cursor -y`
Gemini CLI: `npx skills add Storybloq/storybloq --skill storybloq -g -a gemini-cli -y`

## Description

Open the current local project's Storybloq board, read its context and handovers, or offer local project setup.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Storybloq local project

Use the current task's working directory. Each task has its own board MCP process; do not select a project from an earlier chat, a demo path or an inherited project-root variable. Storybloq's `.story/` files remain canonical. No API key, tunnel, cloud account or Mac app is required.

## Open Storybloq

Call this plugin's `storybloq_board` tool. Discover the exact tool by name if necessary, checking that it belongs to the Storybloq plugin. Its local server discovers the nearest ledger within the current Git worktree, or only the task directory when there is no Git repository. It refuses incomplete or unreadable ledgers.

If the result says `ready: true`, call `storybloq_board` again: the previous call activated tools after setup. Use its project summary to explain current progress and blockers. The returned UI resource contains the board, phases, ticket and issue editors, notes, timeline, sessions and federation views. Use the host's supported app display action when available. A resource retrieval alone does not prove the host rendered it. Never say the board opened unless there is evidence it is visible. Do not promise automatic opening from hook support.

If native app rendering is unavailable and the board response supplies `structuredContent.localBrowser.url`, provide its **Open Storybloq** link. Use the host’s supported browser action to open that exact link when requested. It is a local page owned by this task’s running plugin process, with no tunnel. It expires when the task connection stops; reopen from the current task after restart. Keep the capability link in this task and never forward it to another project or external service. A link returned by the tool does not itself prove a visible board.

The rest: https://github.com/Storybloq/storybloq/blob/HEAD/skills/storybloq/SKILL.md