x-writing

Transform markdown notes and macOS Notes into tweet-ready X posts.

69|11|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/richtabor/agent-skills --skill x-writing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: x-writing
Source: https://github.com/richtabor/agent-skills/tree/main/skills/x-writing
Command: npx skills add https://github.com/richtabor/agent-skills --skill x-writing

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Transforms notes, updates, and ideas into engaging X (Twitter) posts by analyzing source material to extract shareable insights and craft authentic messages that match your voice and style.

Core Features & Use Cases

  • Analyze notes and ideas to identify shareable insights and craft tweet-ready content
  • Draft authentic X posts that match your voice and style, with engagement-focused endings
  • Supports two sources: a markdown file defined by X_SOURCE_FILE and macOS Notes defined by X_NOTES_APP_SOURCE

Quick Start

Tell me which notes or ideas you want to turn into X posts and I will draft tweet-ready content.

Frequently Asked Questions about x-writing

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

FAQPage Schema
How do I turn markdown notes into ready-to-post X content?

To turn markdown notes into X content, define your file path using X_SOURCE_FILE. The skill analyzes the markdown material, applies the x-strategy and writing style guide, and drafts authentic, tweet-ready posts matching your voice.

Can I use macOS Notes to generate Twitter posts automatically?

Yes, you can generate Twitter posts from macOS Notes by setting the X_NOTES_APP_SOURCE variable. The skill extracts shareable insights from your local notes and crafts them into engaging, authentic X posts.

How does the writing process avoid generic social media patterns?

The writing process avoids generic social media patterns by applying built-in anti-patterns during drafting. It cross-references your WRITING_STYLE_GUIDE_PATH to ensure authentic voice, proper formatting, and engagement-focused endings.

What is the best way to draft authentic X posts from raw ideas?

The best way to draft authentic X posts from raw ideas is to source them via a markdown file or macOS Notes. The skill evaluates the text to identify shareable insights and structures them into tweet-ready content.

Do I need a writing style guide to automate social media content?

You need a writing style guide defined by WRITING_STYLE_GUIDE_PATH to automate social media content effectively. It ensures the generated X posts match your specific voice, maintain formatting standards, and apply the correct engagement strategy.

Are there limitations when sourcing ideas from a markdown file for X?

When sourcing ideas from a markdown file for X, the limitation is that content extraction depends entirely on the text within the defined X_SOURCE_FILE. The skill cannot pull external context beyond the provided markdown or macOS Notes sources.