content-strategy

Restructure technical documentation with ordering, active prose, and SEO linting checks.

8|1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/drewid74/ai_skills --skill content-strategy-drewid74
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: content-strategy
Source: https://github.com/drewid74/ai_skills/tree/main/content-strategy
Command: npx skills add https://github.com/drewid74/ai_skills --skill content-strategy-drewid74

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The content-strategy skill helps you rewrite and structure technical writing so it becomes clear, actionable, and useful for developers and end users.

Core Features & Use Cases

  • Document structuring for clarity: Selects an appropriate format and ordering for READMEs, API references, runbooks, ADRs, changelogs, and tutorials.
  • Developer-focused precision: Enforces an identity that prioritizes tested, reader-next-step structure and removes filler.
  • Quality and consistency checks: Applies editing passes for active voice, sentence length, SEO elements, and documentation linting expectations.
  • Error-proofing and usability: Prevents common anti-patterns like vague headlines, commit-hash changelogs, and placeholder-only environment variable docs.

Quick Start

Ask an AI assistant to rewrite your README or technical page using this skill’s decision framework, applying anti-pattern fixes, and validating the quality gates for structure, SEO, and concise active voice.

Frequently Asked Questions about content-strategy

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

FAQPage Schema
How do I rewrite messy technical writing into clear developer documentation?

To rewrite messy technical writing into clear developer documentation, apply a structured decision framework that enforces active concise prose, selects appropriate document ordering, and removes filler content for tested readability.

What is the best way to format API documentation and release notes for developers?

The best way to format API documentation and release notes is to apply structural quality gates that prevent anti-patterns like vague headlines and commit-hash changelogs, ensuring actionable next steps for readers.

Can I use this approach to refactor existing READMEs and runbooks?

Yes, you can refactor existing READMEs and runbooks by applying editing passes that check sentence length, SEO elements, and CI prose linting expectations to improve overall documentation quality and usability.

How does documentation linting improve technical content quality?

Documentation linting improves technical content quality by enforcing active voice and sentence length rules, validating structural format choices, and identifying common anti-patterns during automated editing passes.

What common documentation anti-patterns should I avoid in developer docs?

You should avoid common developer documentation anti-patterns including vague headlines, commit-hash only changelogs, placeholder-only environment variable docs, and passive filler text that lacks actionable reader next steps.

Does this content strategy work for SEO-driven page updates and ADRs?

Yes, this content strategy works for SEO-driven page updates and ADRs by applying specific quality gates that validate SEO elements alongside structural formatting and concise active prose rules for technical accuracy.