comms-cascade

Updates framework communications docs, commits to GitHub, and deploys to Cloudflare Pages.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/scoots31/engineering-playbook --skill comms-cascade-scoots31
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: comms-cascade
Source: https://github.com/scoots31/engineering-playbook/tree/main/skills/comms-cascade
Command: npx skills add https://github.com/scoots31/engineering-playbook --skill comms-cascade-scoots31

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a new framework version ships, every communications document — changelog, blog, skill reference cards, and guide pages — must be updated consistently, committed, and deployed. Doing this by hand is slow and error-prone, and entries often drift in style or get skipped entirely. ## Core Features & Use Cases - Coordinated doc updates: Reviews a full inventory of communications files (CHANGELOG.md, blog.html, skills-reference.html, guide pages) and updates only what is relevant to the shipped version. - Style-matched entries: Reads recent blog and changelog entries first, then writes new entries that match existing HTML structure, badge classes, and tone exactly. - One-pass execution: Commits changes to GitHub, pushes, and deploys the docs site to Cloudflare Pages via wrangler in a single run, then reports results back to the invoking curator. - Use Case: After shipping framework version v2.4.0, the curator invokes this sub-agent with a structured brief; it adds the changelog entry, publishes a blog post, updates affected skill cards, commits, pushes, and deploys without further input. ## Quick Start Invoke this sub-agent with a version brief containing the version number, date, summary, affected skills, and watch-for items so it updates all communications docs and deploys them.

Frequently Asked Questions about comms-cascade

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

FAQPage Schema
How do I update release communications docs after shipping a version?

Provide a structured brief with the version number, date, summary, affected skills, and watch-for items. The sub-agent reviews the full doc inventory, updates only relevant files, commits, pushes to GitHub, and deploys to Cloudflare Pages in one pass.

What files get updated when a new framework version ships?

CHANGELOG.md and blog.html are always updated. The skills-reference.html cards update when skills are affected, guide pages update when watch-for items exist, and process-map.html updates when the process flow changes.

How do I deploy a static docs site to Cloudflare Pages with wrangler?

Set the CLOUDFLARE_API_TOKEN environment variable, then run wrangler pages deploy from the docs directory with the project name. The token is read from a local reference file before deployment.

Can this sub-agent be invoked directly by an end user?

No. It is a sub-agent invoked only by the framework curator or Ren through the Agent tool with a structured brief. It executes updates autonomously and never asks the user for approval.

Why must blog entries avoid intro paragraphs?

Intro paragraphs render full-white with no CSS styling and break visual consistency. All content must live inside the change-desc element, going directly from entry-divider to change-list.