An agent skill for generating rich, visual plans
as markdown you can store, version, and comment on locally.
Plans are written as markdown with a small set of directives — callouts, cards, labels, mermaid diagrams, and file trees — rendered with a consistent design language by the Fiberplane desktop app.
npx skills add fiberplane/bs --skill bsClone the repo and copy the skill into Claude Code's skills directory:
git clone https://github.com/fiberplane/bs.git /tmp/fiberplane-bs
mkdir -p ~/.claude/skills
cp -R /tmp/fiberplane-bs/skills/bs ~/.claude/skills/bsClone the repo and copy the skill into your .agents skills directory:
git clone https://github.com/fiberplane/bs.git /tmp/fiberplane-bs
mkdir -p ~/.agents/skills
cp -R /tmp/fiberplane-bs/skills/bs ~/.agents/skills/bsOnce installed, ask the agent to brainstorm or create a visual plan:
> brainstorm an auth system migration plan
> bs: architecture overview for the new API gateway
> create a visual plan for the database refactor
The agent writes markdown with directives and saves it to your project via the fp CLI.
The agent produces a markdown file — directives for callouts, cards, labels, mermaid diagrams, and file trees — then stores it locally with fp brainstorm create. Brainstorms live alongside your code, versioned on every update, and can be read from the terminal (fp bs show <id>) or opened in the Fiberplane desktop app for a fully rendered view with inline comments.
The skill only produces content — all styling, theming, and layout live in the renderer, so plans stay concise and consistent across light and dark modes.
- Markdown-first plans — portable, diff-able, versioned on every update
- Rich directives — callouts, cards, labels, file trees
- Mermaid diagrams — flowcharts, sequence, state, class, ER, gantt, and timeline
- Light/dark theme support — rendered consistently by the desktop app
- Inline comments — leave feedback anchored to specific blocks via
fp bs comments
MIT