Docs Applying Content Quality

Applying Content Quality Standards

Quality-Gate Lifecycle Handoff

Checker/fixer invocations may receive delegated-gate-ids and lifecycle-evidence from Lifecycle Validation Ownership. Suppress only predicates matched by an exact gate ID or declared verifies relationship; an empty set suppresses nothing. Checkers return the evidence unchanged. After edits, fixers intersect changed files with delegated gate scopes and return updated-lifecycle-evidence, invalidating only affected entries. Omitted handoff preserves standalone full behaviour.

Purpose

This Skill provides comprehensive guidance for applying universal content quality standards to all markdown content in the repository. It ensures consistent writing quality, accessibility compliance, and professional presentation across documentation, web sites, planning documents, and root files.

When to use this Skill:

• Creating or editing markdown content in docs/
• Writing content for ayokoding-web (Next.js) or ose-web (Next.js)
• Creating planning documents in plans/
• Writing repository root files (README.md, CONTRIBUTING.md, etc.)
• Ensuring accessibility compliance (WCAG AA)
• Reviewing content for quality standards

Core Quality Principles

See Writing Style, Heading Hierarchy, and Accessibility for active-voice/tone rules, heading nesting requirements, and WCAG AA accessibility standards (alt text, contrast, semantic formatting, screen reader support).

See Formatting Conventions and Common Mistakes for code-block/paragraph/list formatting, the No Time Estimates rule, the pre-publish quality checklist, and five common mistakes with wrong/right examples.

References

Primary Convention: Content Quality Principles

Related Conventions:

• Accessibility First Principle - Foundational accessibility principle
• No Time Estimates Principle - Rationale for avoiding time framing
• README Quality Convention - README-specific quality standards
• Color Accessibility Convention - WCAG color contrast requirements

Related Skills:

• docs-creating-accessible-diagrams - Accessible Mermaid diagrams with WCAG colors
• readme-writing-readme-files - README-specific quality standards
• docs-applying-diataxis-framework - Documentation organization framework

This Skill packages universal content quality standards for consistent, accessible, professional markdown content across the repository. For comprehensive details, consult the primary convention document.