skills.rest
breaking-brake
breaking-brakeCOMMUNITY
Explore all skills by this author →
GitHub

ccwf-cli

Render, validate, preview, export, and run cc-wf-studio workflow JSON files from the terminal.

5.4k|571|Updated Nov 1, 2025
Search Tags:#CLI#Mermaid#validate#Automation#Workflow#Claude code#Export
One-click install
npx skills add https://github.com/breaking-brake/cc-wf-studio --skill ccwf-cli
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ccwf-cli
Source: https://github.com/breaking-brake/cc-wf-studio/tree/main/packages/cli/skills/ccwf-cli
Command: npx skills add https://github.com/breaking-brake/cc-wf-studio --skill ccwf-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @cc-wf-studio/cli.

What problem does it solve?

Working with cc-wf-studio workflow JSON files outside VSCode requires manual inspection and guesswork. This Skill teaches the AI how to use the ccwf CLI to validate, visualize, convert, and execute those workflows directly from the terminal.

Core Features & Use Cases

  • Validate and render workflows: Schema-check workflow JSON with ccwf validate and render Mermaid diagrams plus per-node Markdown with ccwf render.
  • Preview and edit in a browser: Open a read-only Mermaid viewer with ccwf preview or the full editable canvas with ccwf canvas, no VSCode required.
  • Export and run as Agent Skills: Convert workflows into Skill files for Claude Code, Cursor, Codex, Gemini, Copilot, and more via ccwf export, or execute them with ccwf run --launch.
  • Use Case: A user receives a hand-edited workflow file and asks "is this OK, then run it" — the Skill validates the schema, previews the flow, exports it as a Claude Code Skill, and launches claude.

Quick Start

Ask the AI to preview the workflow file at .vscode/workflows/my-workflow.json using the ccwf CLI.

Frequently Asked Questions about ccwf-cli

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

FAQPage Schema
How do I preview a cc-wf-studio workflow file without VSCode?▼

Run `ccwf preview <file>` to open a read-only browser viewer showing a Mermaid flowchart and per-node Markdown. The server binds to localhost, auto-reloads on file changes, and shuts down 30 seconds after the last tab closes.

How do I convert a workflow JSON into a Claude Code Skill?▼

Run `ccwf export <file>` which defaults to the claude-code agent and writes .claude/skills/<workflow>/SKILL.md plus any inline SubAgent files. Use --agent cursor, codex, gemini, copilot, or roo-code to target other agents.

What agents does ccwf export support?▼

ccwf export supports claude-code, cursor, codex, gemini, copilot, antigravity, and roo-code via the --agent flag. Each agent writes Skill files to its own convention directory such as .claude/skills/, .cursor/skills/, or .codex/skills/.

Why does ccwf run --launch not start Claude Code?▼

ccwf run --launch requires the `claude` binary on PATH. If it is missing, the command warns and exits cleanly after writing the Skill files, which is not an error condition. Launching is also only wired for the claude-code agent.

How do I validate a workflow JSON file before running it?▼

Run `ccwf validate <file>` which exits 0 for valid files and 1 with human-readable errors on stderr. Add --json to get a machine-readable { valid, errors[] } result, useful in CI or pre-commit hooks.

What are the limitations of ccwf canvas compared to the VSCode extension?▼

ccwf canvas is experimental and lacks Slack sharing, Claude API upload, MCP server management, and agent-specific export buttons, which return a CANVAS_UNSUPPORTED error. For those features, use the cc-wf-studio VSCode extension instead.

Related Skills

Explore More Software Engineering Skills→
TheFVGTheFVG

update-cursor-settings

Modify VSCode user settings by editing the settings.json file.

Official
Intermediate
BEKO2210BEKO2210

workgraph

Start and backfill WorkGraph sessions from Codex via CLI commands.

Community
Intermediate
zystem-iozystem-io
5

configure-zymtrace-mcp

Configure MCP client connections to the zymtrace backend for flamegraph queries.

Official
Intermediate
CorellisOrgCorellisOrg
27

slack-canvas

Read and write Slack Canvas content via API for documentation automation.

Community
Advanced