Skip to content

feat: port the latest product guidance and add a phone numbers skill - #9

Merged
Bradenream merged 4 commits into
voiceflow:mainfrom
z4o4z:evgeny/sync-creator-skills
Oct 29, 2026
Merged

Bradenream merged 4 commits into
voiceflow:mainfrom
z4o4z:evgeny/sync-creator-skills

Conversation

@z4o4z

@z4o4z z4o4z commented Oct 28, 2026 •

Copy link
Copy Markdown
Member

Depends on #8. This branch includes #8's commit, because GitHub cannot stack PRs from a fork. Review #8 first; the diff here gets smaller once it merges.

Problem and resulting behavior

The public skills were adapted from the Creator skill library at revision 811c78c on Oct 16. The library has improved since then, so the public skills are behind. This PR adapts every change from 811c78c to da3aa8b for agents that only have the Voiceflow MCP, the vf CLI and the docs MCP. Only behavior that holds for any MCP or CLI client was carried over.

It is the first run of a scheduled sync. docs/creator-sync.json records the synced revision and date, so the next run applies only what changed after it, and does nothing when nothing did.

Skill Change
Build Adds the Initialization workflow read and set, launch values in last_event, one place for the greeting, the four ways a workflow runs, and a link to the working-environment rule.
Debug Adds targeted log queries for transcripts and test runs, turn numbering, and links to two new references.
Environments Adds where to make a change (propose a working environment for a live project, clone only after the user agrees), publish then merge, and what to do when Main moved.
Evaluations Adds the scripted conversation run, rules for writing tests, bounded run reads, cancelling runs, and the tool-call audit before reporting.
Functions Adds checking a function on boundary cases with expected outputs, only for self-contained code, and links to two new references.
Integrations Integration tools are now added over the MCP before they are attached. Credentials go to the shared CLI handoffs, OAuth to the UI.
Knowledge Adds managed sitemap import and how to replace a text document's content.
Messages Adds the project text search, finding every owner of a message or prompt, and safe deletion.
Phone numbers New skill: which side a number uses, adding a number through the CLI handoff or the UI, and assigning, moving, renaming and deleting numbers over the MCP.
Prompting Unchanged: the only change was about loading another skill in the app.
Transcripts Adds targeted log queries and turn numbering.
Voice Adds the pronunciation dictionary and its patch, that the voice reads screen symbols aloud, and a link to Phone numbers.
Wiring Adds merge-by-key attachment updates, removing phantom inputs, progress counters, a full wiring check, and links to two new references.
Workflows Adds the raw read, End step rules, batch block and link writes, action replace, arranging, duplicating, and global workflow tools.
Shared New CLI handoffs: when the MCP refuses an action, such as setting a secret value, the agent gives the user a vf command to run in their own terminal, with the value read from a hidden prompt. The operation contract now proposes a working environment for live projects. The index routes to Phone numbers.
References Ported in full: Debug bulk-analysis.md and failure-patterns.md, Functions sensitive-inputs.md and custom-traces.md, Wiring patterns.md and anti-patterns.md.

Not ported:

  • Coach: it runs only inside a scheduled in-app review routine.
  • In-app cards, approval modes, question pickers, display widgets and plan tools. Public agents ask in plain text and use host approvals.
  • Results produced by the in-app merge approval, such as a refused merge after the approval was shown. The product facts behind them were kept.
  • Transcript read views and their size estimates from the in-app read tool, because the public transcript read takes different arguments.
  • Exact batch limits for running evaluations, which could not be confirmed.
  • The in-app statement that the Initialization workflow cannot be read or chosen, because the MCP now has operations for both.
  • A CLI fallback for the project text search: CLI 0.287.0 has no command for it.

Verification

  • validate.py, the unit tests, build.py and verify_cli.py against the pinned CLI 0.287.0 pass. So do the sync's own checks: a leak scan for in-app names, a check that every source reference has a public counterpart, and a check that every changed skill is listed here.
  • Product facts were checked against the operations' schemas, in the Voiceflow UI source, and against Connect a phone number. They are saved text, not runtime-verified.
  • New acceptance cases: working-environment-live, publish-then-merge, integration-tool-add, secret-value-handoff, function-boundary-check, init-workflow-greeting, debug-log-turn, test-run-write-audit, message-delete-owners, knowledge-site-import, pronunciation-fix, wiring-attempt-counter, phone-number-texts, phone-number-buy. None has been run with a model yet.
  • Not run: scan_secrets.py locally (CI runs it), live MCP or CLI acceptance, model evaluations.

Needs a product check:

  • Pull from Main: the skill says "if the workspace has it", because it is not in every workspace.
  • CLI-only paths named in the UI: adding an integration tool from the agent's Tools, and the Initialization and Voice output sections in the agent's Behaviour settings.
  • Phone numbers: the skills send users to Phone numbers in the agent sidebar, under Deploy, called SMS for a chat agent. The MCP's refusal text still names Workspace settings.
  • Build says a user can attach a workflow to a playbook in the editor, while Workflows says the MCP never attaches a workflow tool to one playbook.

Compatibility and release notes

🤖 Generated with Claude Code

Adapts the Creator skill library changes since 811c78c, up to da3aa8b, into
the public skills, for agents that only have the Voiceflow MCP, the vf CLI
and the docs MCP. It ports six reference files in full and adds a phone
numbers skill. Actions the MCP refuses, such as setting a secret value, go to
the user as vf commands in a new shared handoff reference. Each new behavior
has an acceptance case. docs/creator-sync.json records the synced revision
for the scheduled sync.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@z4o4z
z4o4z requested a review from Bradenream as a code owner October 28, 2026 22:34
z4o4z and others added 2 commits October 29, 2026 13:29
Gitleaks' generic-api-key rule read the package manifest entry
"…/references/secrets.md": "<sha256>" as a credential. The file is now
references/sensitive-inputs.md; its two links and the inventory follow.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
A set-value with an environment or the draft variant writes an environment
override, which voiceflow_secret.list does not show; the handoff now confirms
it with voiceflow_secret.list_overrides. An MCP server read redacts header
values and an update replaces the whole list, so a server that already has
headers goes to the Voiceflow UI or has every header re-entered. The sync
state also records the snapshot's hash.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Bradenream
Bradenream merged commit bd99ab5 into voiceflow:main Oct 29, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants