x-writing-system-skill

Generate research-backed X post rewrites from drafts using engagement metrics.

52|8|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/ashemag/x-writing-system-skill --skill x-writing-system-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: x-writing-system-skill
Source: https://github.com/ashemag/x-writing-system-skill/tree/main
Command: npx skills add https://github.com/ashemag/x-writing-system-skill --skill x-writing-system-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Producing high-performing X posts from a draft is guesswork; this Skill converts a draft into a research-backed writing brief using real engagement evidence, writing guidelines, and live trend context.

Core Features & Use Cases

  • Guidelines-applied rewrite planning: applies Matt Gray X writing guidelines as baseline constraints to shape the rewrite direction.
  • Personal performance calibration: pulls the user’s last 30 days of posts and ranks them by measurable engagement to mirror what already works.
  • Adaptive topic research: searches X topics with an evidence threshold, then surfaces high-performing samples with metrics.
  • Trend overlap awareness: checks live trends (by WOEID) and ranks them by overlap with the draft + chosen topics.
  • LLM-ready output structure: produces a markdown research brief and requires generation of 5 distinct, model-authored improved post versions.

Quick Start

Use this skill to rewrite a draft by providing your draft text and your X username, then request the full research brief and 5 improved post versions.

Frequently Asked Questions about x-writing-system-skill

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

FAQPage Schema
How do I rewrite X posts using engagement metrics and trend analysis?

This Skill improves X drafts by pulling your last 30 days of posts, ranking them by measurable engagement, and combining that evidence with adaptive topic research to produce a markdown research brief and five improved post versions.

Can I use my X bearer token to generate a research brief for content optimization?

Yes, you can use a valid X bearer token with this Skill to fetch your recent posts and live trends, enabling end-to-end orchestration of research, fetch, and advise commands with caching for safe output formatting.

How does trend overlap awareness work for X content optimization?

Trend overlap awareness checks live trends by WOEID and ranks them by overlap with your draft and chosen topics, ensuring your X content optimization is grounded in current visibility and evidence thresholds.

Do I need a specific workflow file to run LLM-assisted writing for X?

This LLM-assisted writing system requires a valid SKILL.md workflow and an X bearer token to orchestrate fetch, research, and advise commands, producing a research brief and five distinct improved post versions.

What is the best way to calibrate X writing guidelines against personal performance metrics?

The best way to calibrate X writing guidelines against personal performance is by applying Matt Gray baseline constraints to your draft and ranking your last 30 days of posts by measurable engagement to mirror what already works.

What are the limitations of using an LLM-assisted writing system for X post upgrades?

Limitations include dependency on a valid X bearer token for live trend and post access, required evidence thresholds for adaptive topic research, and the need for a valid SKILL.md workflow to orchestrate fetch, research, and advise commands.