Назад към всички

ap-style-writing

// AP style compliance, grammar checking, and PR writing assistance

$ git log --oneline --stat
stars:384
forks:73
updated:March 4, 2026
SKILL.mdreadonly
SKILL.md Frontmatter
nameap-style-writing
descriptionAP style compliance, grammar checking, and PR writing assistance
allowed-toolsRead,Write,Glob,Grep,Bash,WebFetch
metadata[object Object]

AP Style and Writing Skill

Overview

The AP Style and Writing skill provides AP style compliance, grammar checking, and PR writing assistance capabilities. This skill enables professional-grade PR content creation that meets journalism standards and maintains brand consistency.

Capabilities

Style Compliance

  • AP Stylebook integration
  • Real-time style checking
  • Industry-specific style rules
  • Company style guide integration
  • Style exception management

Grammar and Quality

  • Grammar and readability analysis
  • Sentence structure optimization
  • Passive voice detection
  • Jargon and complexity flagging
  • Tone consistency checking

Press Release Writing

  • Press release template library
  • Headline optimization
  • Lead paragraph structure
  • Quote formatting validation
  • Boilerplate management

Brand Consistency

  • Brand voice consistency checking
  • Key message integration
  • Approved terminology enforcement
  • Competitor name handling
  • Product name consistency

Compliance and Risk

  • Legal/compliance flag detection
  • Disclaimer requirement checking
  • SEC disclosure compliance
  • Trademark and copyright handling
  • Fact-checking reminders

Usage

Style Check Configuration

const styleCheckConfig = {
  baseStyle: 'AP-Stylebook-2026',
  customRules: {
    companyName: {
      correct: 'Company X',
      incorrect: ['CompanyX', 'Company-X', 'company x']
    },
    productNames: {
      'ProductOne': { trademark: true, firstUseTM: true },
      'ProductTwo': { trademark: false }
    },
    executiveTitles: {
      pattern: 'lowercase-after-name',
      examples: 'Jane Doe, chief executive officer'
    },
    numbers: 'spell-out-under-10',
    dates: 'month-day-year'
  },
  voiceGuidelines: {
    tone: 'professional-but-accessible',
    perspective: 'third-person',
    passiveVoiceLimit: 10,
    jargonLevel: 'minimize'
  },
  complianceRules: {
    forwardLooking: { required: true, template: 'standard-disclaimer' },
    financialDisclosure: { secCompliant: true },
    legalReview: { triggers: ['lawsuit', 'litigation', 'settlement'] }
  }
};

Content Review

const contentReview = {
  document: 'press-release-draft.md',
  results: {
    styleIssues: [
      { line: 5, issue: 'Numbers: "8" should be "eight"', severity: 'style' },
      { line: 12, issue: 'Date format: Use "Feb. 15, 2026"', severity: 'style' },
      { line: 18, issue: 'Company name: Use "Company X" not "Company-X"', severity: 'brand' }
    ],
    grammarIssues: [
      { line: 8, issue: 'Passive voice: Consider active construction', severity: 'suggestion' },
      { line: 22, issue: 'Run-on sentence: Consider splitting', severity: 'warning' }
    ],
    readability: {
      fleschKincaid: 10.2,
      target: 8.0,
      recommendation: 'Simplify for broader audience'
    },
    compliance: [
      { issue: 'Forward-looking statement detected', action: 'Add safe harbor disclaimer' }
    ],
    brandConsistency: {
      keyMessages: { present: 2, expected: 3 },
      toneScore: 85,
      voiceConsistency: 'good'
    }
  },
  summary: {
    totalIssues: 7,
    critical: 0,
    warnings: 3,
    suggestions: 4,
    overallScore: 82
  }
};

Process Integration

This skill integrates with the following PR processes:

ProcessIntegration Points
press-release-development.jsWriting and editing
corporate-messaging-architecture.jsMessage consistency
csr-communications.jsReport writing
internal-communications-strategy.jsInternal content

Best Practices

  1. Style First: Apply AP style consistently throughout
  2. Headline Power: Spend extra time on headline optimization
  3. Lead Strong: Front-load key information in first paragraph
  4. Quote Quality: Ensure quotes add value and sound natural
  5. Readability Focus: Write for your audience's level
  6. Review Process: Always use multiple review passes

Metrics and KPIs

MetricDescriptionTarget
Style ComplianceAP style adherence>95%
Readability ScoreFlesch-Kincaid gradeAudience-appropriate
Brand ConsistencyMessage and voice alignment>90%
Error RateErrors per document<1 per page
Review EfficiencyTime to publication-readyImproving

Related Skills

  • SK-003: Media Database (journalist preferences)
  • SK-004: Press Release Distribution (publication)
  • SK-007: Internal Comms Platform (internal content)