Add dynamo-content-designer Claude Code skill - #87
Merged
Conversation
Adds a content design review skill for Claude Code that specialises in Dynamo documentation — blog posts, tutorials, Primer articles, release notes, and node descriptions. Includes reference assets for each content type (UI copy, release notes, node descriptions, node errors, feature docs, blog posts, tutorials). Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a new Claude Code skill (dynamo-content-designer) with supporting reference assets to guide content design reviews for Dynamo documentation and UI copy.
Changes:
- Introduces the
dynamo-content-designerskill entrypoint with triggers, principles, and a content-type-to-asset mapping. - Adds seven content-type-specific guideline/template assets (UI content, release notes, node descriptions, node errors/warnings, feature docs, blog posts, tutorials/user guides).
Reviewed changes
Copilot reviewed 8 out of 8 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
| .claude/skills/dynamo-content-designer/SKILL.md | Defines the skill, when to use it, and how it selects the right reference asset. |
| .claude/skills/dynamo-content-designer/assets/ui-content.md | Adds UI microcopy principles and accessibility/readability guidance. |
| .claude/skills/dynamo-content-designer/assets/tutorials-user-guides.md | Provides reusable templates for tutorials and user guides. |
| .claude/skills/dynamo-content-designer/assets/release-notes.md | Adds release note guidance (currently mixed with node description guidance). |
| .claude/skills/dynamo-content-designer/assets/node-errors-warnings.md | Defines structure, tone, and patterns for in-graph node warnings/errors. |
| .claude/skills/dynamo-content-designer/assets/node-descriptions.md | Defines standards for short and in-depth node descriptions. |
| .claude/skills/dynamo-content-designer/assets/feature-documentation.md | Sets tone/structure guidance for Primer + Revit help feature documentation. |
| .claude/skills/dynamo-content-designer/assets/blog-posts.md | Provides a blog post structure template and reusable “What is Dynamo…” boilerplate. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Comment on lines
+14
to
+33
| ```markdown | ||
| # [H1 Title: Dynamo Core # Release] | ||
|
|
||
| [Intro paragraph] | ||
|
|
||
| [Relevant greeting such as "Hello, world of Dynamo!" or "Greetings, Dynamites!"] | ||
|
|
||
| [Welcome readers to the blog with a warm statement and brief overview of what the post is about (new release)] | ||
|
|
||
| ## TL;DR | ||
|
|
||
| [A list of the key features and updates in the release that will be mentioned in this post. Do not list everything, only the most important topics.] | ||
|
|
||
| ## What is Dynamo and its flavors? | ||
|
|
||
| [Insert the following content verbatim:] | ||
| ``` | ||
|
|
||
| ### What is Dynamo and its flavors? (Insert Verbatim) | ||
|
|
Comment on lines
+12
to
+16
| --- | ||
|
|
||
| ### Node descriptions | ||
|
|
||
| Node descriptions briefly describe a node’s function and output. In Dynamo, they appear in two places: |
| * if they wish, use it in their graph without running into issues resulting from insufficient information | ||
| * understand any limitations involving the node or its inputs/outputs, as well as any options they have regarding its usage, such as wiring a port vs. leaving it as default | ||
|
|
||
| However, most users have no need for the advanced technical details applicable to using the node in any other uncommon or immediately behind the nodes operational or graph. Unless there's a compelling reason to include information at this expert level, omit it. |
| **Be transparent and show empathy for people's goals and frustrations.** | ||
|
|
||
| **Why it matters** | ||
| Long term trust wins over short-term gain. Transparent communication reduces friction and builds positive relationships with people. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Purpose
Adds the
dynamo-content-designerClaude Code skill to the project so any contributor using Claude Code can invoke/dynamo-content-designerto get a content design review of documentation changes.The skill specialises in Dynamo documentation — Primer articles, blog posts, tutorials, release notes, and node descriptions — and loads content-type-specific reference assets (voice/tone guidelines, structural templates, quality checklists) for each task.
Changes
.claude/skills/dynamo-content-designer/SKILL.md— skill entry point and writing principles.claude/skills/dynamo-content-designer/assets/— seven reference files covering: blog posts, feature documentation, node descriptions, node errors & warnings, release notes, tutorials & user guides, and UI contentUsage
In any Claude Code session within this repo:
Or invoke it on a specific diff:
Test plan
/dynamo-content-designeron a documentation file or PR diff🤖 Generated with Claude Code