Skip to content

chore(skill): add post-forge-feature skill for Twitter/X posts#2616

Merged
tusharmath merged 1 commit intomainfrom
social-media-post
Mar 21, 2026
Merged

chore(skill): add post-forge-feature skill for Twitter/X posts#2616
tusharmath merged 1 commit intomainfrom
social-media-post

Conversation

@tusharmath
Copy link
Collaborator

@tusharmath tusharmath commented Mar 21, 2026

Summary

Add a post-forge-feature skill that generates concise, developer-friendly Twitter/X posts for ForgeCode features, with a consistent style guide enforcing tone, vocabulary, and formatting rules.

Context

Promoting ForgeCode features on social media requires a consistent voice and format. Without a structured skill, posts risk using hype-y language, inconsistent product naming, or poor formatting. This skill codifies the rules once so every generated post is on-brand and ready to publish alongside an attached video.

Changes

  • Added .forge/skills/post-forge-feature/SKILL.md: skill definition with a 3-step workflow (understand the feature, craft the post, present for approval) and key constraints (2-3 sentences, no em dashes, always use "ForgeCode", no video references)
  • Added .forge/skills/post-forge-feature/references/style-guide.md: detailed style guide covering tone, vocabulary rules, approved hashtags, four example posts, and a pre-publish checklist

Key Implementation Details

The skill uses a two-level progressive disclosure design. SKILL.md contains the core workflow and constraints (loaded when the skill triggers). The style guide is a separate reference file loaded only when drafting, keeping context usage minimal. The references/style-guide.md explicitly bans em dashes and "Forge" alone as the product name, with those rules also mirrored in the checklist so nothing slips through.

Use Cases

  • User asks: "Write a tweet for the new ForgeCode shell plugin feature"
  • User asks: "Create a Twitter post about the context compaction update"
  • User asks: "Promote this ForgeCode release on social media"

In each case the skill investigates the feature from source/docs, drafts a 2-3 sentence post using ForgeCode branding and the approved hashtag set, then presents it for approval before finalizing.

Testing

Load the skill in a new session (skills are registered at session start) and prompt:

Write a Twitter post for the ForgeCode multi-file edit feature.

Verify the output:

  • Uses "ForgeCode" (not "Forge")
  • Contains no em dashes
  • Is 2-3 sentences
  • Ends with #ForgeCode and 1-2 relevant hashtags
  • Does not mention the attached video

@github-actions github-actions bot added type: chore Routine tasks like conversions, reorganization, and maintenance work. type: feature Brand new functionality, features, pages, workflows, endpoints, etc. labels Mar 21, 2026
@tusharmath tusharmath changed the title chore(post-forge-feature): add twitter/x post style guide skill feat(skill): add post-forge-feature skill for Twitter/X posts Mar 21, 2026
@augmentcode
Copy link

augmentcode bot commented Mar 21, 2026

🤖 Augment PR Summary

Summary: Adds a new Forge skill for generating concise Twitter/X posts that promote ForgeCode features.

Changes:

  • Introduced the post-forge-feature skill with a short workflow and concrete post constraints (2–3 sentences, benefit-led, no hype)
  • Added a dedicated style guide covering tone, banned vocabulary, required structure, approved hashtags, and sample posts

Technical Notes: The skill centralizes writing rules by pointing authors to references/style-guide.md before drafting.

🤖 Was this summary useful? React with 👍 or 👎

Copy link

@augmentcode augmentcode bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review completed. 3 suggestions posted.

Fix All in Augment

Comment augment review to trigger a new review at any time.

@@ -0,0 +1,33 @@
---
name: post-forge-feature
description: Generate a Twitter/X post highlighting a Forge feature. Use when the user asks to write a tweet, create a Twitter post, or promote a ForgeCode feature on social media. The post always accompanies an attached video demonstrating the feature.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The skill description says “highlighting a Forge feature”, which conflicts with the later constraint to never refer to the product as “Forge” alone; consider aligning the metadata wording to avoid inconsistent outputs.

Severity: low

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.

- No em dashes anywhere in the post.
- Lead with the developer benefit or the problem solved, not the feature name.
- The video is attached. Do not say "watch the video" or describe what is in it.
- End with a relevant hashtag line (see style guide for approved tags).
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This says “relevant hashtag line”, but the referenced style guide requires always ending with #ForgeCode plus 1–2 approved tags; consider restating that here so the constraint can’t drift from the guide.

Severity: low

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.


**Avoid:**
- "Forge" alone as the product name. Always use "ForgeCode".
- Em dashes (--) anywhere in the post. Use commas, colons, or periods instead.
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

“Em dashes (--)” is a bit ambiguous since -- isn’t an em dash character (); consider clarifying which forms are disallowed (e.g., both and --) to prevent misinterpretation.

Severity: low

Fix This in Augment

🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.

@@ -0,0 +1,33 @@
---
name: post-forge-feature
description: Generate a Twitter/X post highlighting a Forge feature. Use when the user asks to write a tweet, create a Twitter post, or promote a ForgeCode feature on social media. The post always accompanies an attached video demonstrating the feature.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Inconsistent product naming violates the stated constraint. The description says "Forge feature" but line 25 explicitly states "Always refer to the product as 'ForgeCode', never 'Forge' alone." This creates conflicting guidance that could cause the skill to generate incorrect posts.

description: Generate a Twitter/X post highlighting a ForgeCode feature. Use when the user asks to write a tweet, create a Twitter post, or promote a ForgeCode feature on social media. The post always accompanies an attached video demonstrating the feature.
Suggested change
description: Generate a Twitter/X post highlighting a Forge feature. Use when the user asks to write a tweet, create a Twitter post, or promote a ForgeCode feature on social media. The post always accompanies an attached video demonstrating the feature.
description: Generate a Twitter/X post highlighting a ForgeCode feature. Use when the user asks to write a tweet, create a Twitter post, or promote a ForgeCode feature on social media. The post always accompanies an attached video demonstrating the feature.

Spotted by Graphite

Fix in Graphite


Is this helpful? React 👍 or 👎 to let us know.

@tusharmath tusharmath merged commit bba73fb into main Mar 21, 2026
10 checks passed
@tusharmath tusharmath deleted the social-media-post branch March 21, 2026 06:52
@tusharmath tusharmath changed the title feat(skill): add post-forge-feature skill for Twitter/X posts chore(skill): add post-forge-feature skill for Twitter/X posts Mar 23, 2026
@tusharmath tusharmath removed the type: feature Brand new functionality, features, pages, workflows, endpoints, etc. label Mar 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

type: chore Routine tasks like conversions, reorganization, and maintenance work.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant