Workflow Schema Tuning

Tunes the workflow-schema.json descriptions that bias AI workflow generation.

Tested · Works

Test report

Verdict
Tested · Works
Score
8.0/10
Tested
Jul 12, 2026
Environment
Claude Code 2.x (agent harness)
Upstream re-checked
Aug 10, 2026 · c34122e

Tested the full loop: verbatim clone+copy install (clean, YAML frontmatter valid, all referenced schema/build files present) plus an A/B on a real node-type-bias diagnosis task (AI over-picks subAgent over prompt for trivial steps). Both arms correctly identified the asymmetric aiGenerationGuidance/examples as the bias source, but the skill arm added contrastive description rewrites (its 'align direction, don't prescribe rules' principle) and the essential TOON-regeneration/verify step the base arm omitted — base's raw-JSON patch would silently not take effect since the MCP serves TOON. Note: the install's referenced files (workflow-schema.json, .toon, ai-editing-skill-template.md, generate-toon-schema.ts) only resolve with cwd=packages/core, and the repo is pnpm-managed despite the SKILL's 'npm run generate:toon' wording.

Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works

  • Installs cleanly 5/5
  • Triggers reliably 4/5
  • Output vs. baseline 7/10
  • Docs & honesty 4/5

What Workflow Schema Tuning does

Use when modifying `resources/workflow-schema.json` in cc-wf-studio to influence how AI agents generate workflows via the cc-workflow-ai-editor skill. Triggers include "AIが特定のノードタイプを選んでくれない", "ワークフロー生成のバイアスを調整したい", "スキーマの description を変えたい", "新しいノードタイプを追加したい", "嘘の制約がスキーマに混じっていないか確認したい". Covers what the schema actually does (instructions to AI, not runtime constraints), the design philosophy…

How to install Workflow Schema Tuning

git clone https://github.com/breaking-brake/cc-wf-studio
cd cc-wf-studio
mkdir -p ~/.claude/skills
cp -r .claude/skills/workflow-schema-tuning ~/.claude/skills/workflow-schema-tuning

Skills live in ~/.claude/skills/ (global) or .claude/skills/ (per-project). Restart Claude Code after installing.

Commands — how to trigger Workflow Schema Tuning

  • /workflow-schema-tuning Tunes the workflow-schema.json descriptions that bias AI workflow generation.

It also activates on plain-language prompts like these:

  • Adjust the schema so AI picks the right node type
  • Change this schema description to reduce generation bias
  • Add a new node type to the workflow schema

Frequently asked questions

Is the Workflow Schema Tuning skill free?
Yes. The skill itself is free from breaking-brake/cc-wf-studio. SkillProof publishes the install command and an independent test verdict at no cost.
Does Workflow Schema Tuning work with Claude Code?
We tested it with Claude Code 2.x (agent harness) on Jul 12, 2026. Verdict: Tested · Works. Tested the full loop: verbatim clone+copy install (clean, YAML frontmatter valid, all referenced schema/build files present) plus an A/B on a real node-type-bias diagnosis task (AI over-picks subAgent over prompt for trivial steps). Both arms correctly identified the asymmetric aiGenerationGuidance/examples as the bias source, but the skill arm added contrastive description rewrites (its 'align direction, don't prescribe rules' principle) and the essential TOON-regeneration/verify step the base arm omitted — base's raw-JSON patch would silently not take effect since the MCP serves TOON. Note: the install's referenced files (workflow-schema.json, .toon, ai-editing-skill-template.md, generate-toon-schema.ts) only resolve with cwd=packages/core, and the repo is pnpm-managed despite the SKILL's 'npm run generate:toon' wording.
What is the Workflow Schema Tuning SkillProof Score?
8.0/10 — installs cleanly 5/5, triggers reliably 4/5, output vs. baseline 7/10, docs & honesty 4/5.
How do I install Workflow Schema Tuning?
Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
Can I use Workflow Schema Tuning with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.