Skip to content

docs(skills): improve webflow-cloud-command SKILL.md with new commands and standard format#15

Open
jallegretti-webflow wants to merge 6 commits intomainfrom
CLD-1175-update-cloud-skills
Open

docs(skills): improve webflow-cloud-command SKILL.md with new commands and standard format#15
jallegretti-webflow wants to merge 6 commits intomainfrom
CLD-1175-update-cloud-skills

Conversation

@jallegretti-webflow
Copy link
Copy Markdown

Summary

  • Adds full documentation for cloud init standalone mode (--new), site-attached mode,
    and all associated flags — previously undocumented or incomplete
  • Adds documentation for cloud list, cloud create (legacy), deploy versioning,
    Cloudflare bindings (D1/KV/R2), build-time file management, and telemetry opt-out
  • Clarifies --mount is always required with --no-input and is never auto-read from
    webflow.json — prevents common ENVIRONMENT_MOUNT_MISMATCH errors
  • Clarifies cloud init is local-only and must never run in CI
  • Adds WEBFLOW_SITE_API_TOKEN vs WEBFLOW_API_TOKEN distinction for GitHub Secrets
  • Adds cloud.framework three-state resolution logic and framework support matrix
  • Documents package manager behavior (npm only — pnpm/yarn lock files are ignored)

Test plan

  • Confirm frontmatter name: and description: are present and valid
  • Verify all three sections exist: ## Instructions, ## Examples, ## Guidelines
  • Confirm cloud init standalone (--new) and site-attached modes are both documented
  • Confirm --mount always-required rule is present under both deploy flags and guidelines
  • Confirm CI structural validation passes (frontmatter check in .github/workflows/ci.yml)

- Renamed sections for better readability, changing "Tool usage" to "Instructions" and "Global flags" to "Authentication".
- Consolidated notes regarding `WEBFLOW_SITE_API_TOKEN` and `.env` file handling.
- Enhanced the description of `cloud.framework` resolution logic and command usage.
- Clarified flags and their requirements for `cloud init` and `cloud deploy` commands.
- Removed redundant information and streamlined the document for easier navigation.
@jallegretti-webflow jallegretti-webflow marked this pull request as ready for review April 6, 2026 14:21
- Clarified descriptions of environment variables and command flags to enhance understanding.
- Improved instructions for project initialization and deployment processes.
- Streamlined examples to reflect the new terminology and recommended deployment practices.
- Removed references to `nextjs-minimal` and `astro-minimal` from the framework options to streamline the documentation.
- Adjusted scaffold descriptions for clarity and consistency with current offerings.
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.

2 participants