skills.rest
tldraw
tldrawOFFICIAL
Explore all skills by this author →
Website𝕏@tldrawGitHub

dotcom-release-marketing

Posts plain-language summaries of weekly tldraw.com release changes to a Discord marketing channel.

50.1k|3.5k|Updated May 9, 2021
Search Tags:#release notes#commit analysis#announcement#gitHub api#discord webhook#ChangeLog#marketing summary
One-click install
npx skills add https://github.com/tldraw/tldraw --skill dotcom-release-marketing
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: dotcom-release-marketing
Source: https://github.com/tldraw/tldraw/tree/main/skills/dotcom-release-marketing
Command: npx skills add https://github.com/tldraw/tldraw --skill dotcom-release-marketing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Marketing teams need to know what is shipping in each weekly tldraw.com release, but raw commit logs and conventional-commit messages are written for engineers, not for people planning announcements, social posts, and changelog copy.

Core Features & Use Cases

  • Commit Range Analysis: Fetches every commit on main not yet on production via the GitHub API, capturing author and subject for the full release range.
  • User-Facing Filtering and Translation: Selects only changes users would notice (features, visible fixes, performance) and rewrites conventional-commit subjects into plain-language benefit statements grouped into New, Improved, and Fixed buckets.
  • Discord Publishing: Posts a formatted summary under Discord's 2000-character limit to the marketing channel via webhook, with all mentions disabled so no one gets pinged.
  • Use Case: During the weekly dotcom release, run this Skill to automatically produce a marketing-ready summary like "You can now flip shapes horizontally and vertically" from feat(tldraw): flip geo shapes with flipX/flipY, and post it to the marketing Discord channel.

Quick Start

Summarize what is shipping in this week's tldraw.com release for the marketing team and post it to their Discord channel.

Frequently Asked Questions about dotcom-release-marketing

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

FAQPage Schema
How do I summarize GitHub commits for a non-technical audience?▼

Fetch the commit range with the GitHub compare API, filter to user-facing changes like features and visible fixes, then rewrite conventional-commit subjects into plain sentences describing user benefits. This Skill automates that flow for the tldraw production...main range.

How do I post a release announcement to a Discord channel?▼

Send a POST request to a Discord webhook URL with a JSON body containing the message as the content field. Build the JSON with jq to escape newlines and quotes safely, and set allowed_mentions.parse to an empty array to prevent pings.

What environment variables does this release summary workflow need?▼

It requires DISCORD_MARKETING_WEBHOOK_URL for the marketing channel webhook and GH_TOKEN for GitHub CLI authentication. If the webhook variable is unset, the workflow stops and asks you to set it rather than hardcoding a URL.

Which commits are excluded from the marketing release summary?▼

Docs, tests, chores, style, CI, build changes, dependency bumps, and internal refactors are excluded, along with fixes users could never observe. Only features, visible bug fixes, and noticeable performance improvements make the cut.

What happens if there are no new commits in the release range?▼

If the production...main comparison returns zero commits, the workflow posts a brief note that nothing new is shipping this week and stops. If commits exist but none are user-facing, it notes a quiet week and still includes the diff link.

Related Skills

Explore More Marketing & Sales Skills→
duanegoodnerduanegoodner

land

Merges a GitHub pull request via squash and removes the feature branch.

Community
Intermediate
GeargrindadminGeargrindadmin

bmad-os-changelog-social

Generate Discord, Twitter, and LinkedIn posts from changelog entries and git history.

Community
Intermediate
maggitmaggit

release-plan

Generate structured Markdown release plans for software deployments.

Community
Intermediate
NITRR-OfficialNITRR-Official
4

release-notes-generation

Generate GitHub release notes from conventional commit messages and Markdown files.

Official
Intermediate