ibm-sg-audience-and-medium

Review documentation for IBM Style Guide audience and medium issues.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/redhat-documentation/redhat-docs-agent-tools --skill ibm-sg-audience-and-medium
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ibm-sg-audience-and-medium
Source: https://github.com/redhat-documentation/redhat-docs-agent-tools/tree/main/plugins/docs-tools/skills/ibm-sg-audience-and-medium
Command: npx skills add https://github.com/redhat-documentation/redhat-docs-agent-tools --skill ibm-sg-audience-and-medium

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps ensure documentation adheres to the IBM Style Guide's standards for audience appropriateness, accessibility, and medium-specific content, preventing common pitfalls in technical writing.

Core Features & Use Cases

  • Accessibility Checks: Verifies image alt text, color usage, link descriptions, and heading structure.
  • Global Audience Readiness: Identifies and flags idioms, complex sentence structures, and culture-specific references.
  • Tone and Style: Enforces active voice, direct address, and avoids marketing jargon or overly casual language.
  • Use Case: Before publishing a new feature guide, use this skill to catch any accessibility issues or phrases that might not translate well for an international audience.

Quick Start

Review the attached document for IBM Style Guide audience and medium issues.

Frequently Asked Questions about ibm-sg-audience-and-medium

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

FAQPage Schema
How do I check documentation for IBM Style Guide compliance?

To check documentation for IBM Style Guide compliance, review the text against standards for audience appropriateness, accessibility, tone, and medium-specific content suitability. This process catches common technical writing pitfalls before publication.

What is global audience readiness in technical writing?

Global audience readiness in technical writing is the process of identifying and flagging idioms, complex sentence structures, and culture-specific references to ensure content translates effectively for international users.

How do I review technical docs for accessibility issues?

Review technical docs for accessibility issues by verifying image alt text, color usage, link descriptions, and heading structure. This ensures documentation is inclusive and adheres to established style guidelines.

How do I enforce active voice and tone in technical documentation?

Enforce active voice and tone in technical documentation by applying style guidelines that mandate direct address, avoiding marketing jargon, and eliminating overly casual language for clear communication.

Does this style guide review check mobile and video content suitability?

Yes, style guide review checks mobile and video content suitability. It encompasses medium-specific checks to ensure documentation meets the required standards for clarity and inclusivity across different content formats.

What are the limitations of automated documentation style checks?

Automated documentation style checks require strict adherence to specific style guidelines to function properly. They focus on structural and grammatical compliance, meaning complex semantic nuances or highly specialized tone shifts may need manual review.