faircopy

A copy linter for landing pages. Catches writing-quality bugs in the prose that ships inside your codebase: em-dashes, weasel words, and rhetorical scaffolding patterns.

error[no-em-dash]: use a sentence break instead of an em-dash
  ┌─ src/pages/index.astro:12:38
  │
12 │   <p>Omni Aura builds the memory layer — the part that matters.</p>
  │                                          ^
  │
  = help: Split the sentence. Use a period, a semicolon, or a new sentence.

Install

npm i -D faircopy @faircopy/astro

Configure

// faircopy.config.ts
import { defineConfig } from '@faircopy/config'
import { astro } from '@faircopy/astro'

export default defineConfig({
  files: ['src/**/*.astro'],
  ignore: ['src/content/blog/**'],
  adapters: [astro()],
  rules: {
    'no-em-dash': 'error',
    'no-weasel-words': 'error',
    'no-rhetorical-scaffolding': 'error',
  },
})

Run

npx faircopy lint

CI

- uses: actions/checkout@v4
- run: npm ci
- run: npx faircopy lint --format github

--format github emits ::error workflow commands so diagnostics appear as inline PR annotations.

Claude Code plugin

Install the plugin to get a stop hook (blocks the turn if lint errors are found) and a skill (Claude runs faircopy automatically when editing marketing copy):

/plugin marketplace add github.com/omniaura/faircopy
/plugin install faircopy

Rules

Rule	Default	Description
`no-em-dash`	`error`	Ban `—` in marketing copy
`no-weasel-words`	`error`	Ban `actually`, `truly`, `really`, `literally`
`no-rhetorical-scaffolding`	`error`	Ban `X is Y, not Z` and `Without X / With X` patterns

Optional NLP rules live in @faircopy/rules-nlp. Load the ruleset once to configure its rules with bare IDs:

export default defineConfig({
  rulesets: ['@faircopy/rules-nlp'],
  rules: {
    'no-expletive-openers': 'warn',
    'no-filter-words': 'warn',
    'no-future-promises': 'warn',
    'no-hedge-words': 'warn',
    'no-jargon': 'warn',
    'no-passive-voice': 'warn',
    'no-weak-modals': 'warn',
    'no-stacked-adjectives': 'warn',
    'no-nominalized-phrases': 'warn',
    'no-pronoun-led-claims': 'warn',
    'no-buzzword-stacks': 'warn',
    'no-vague-quantifiers': 'warn',
    'no-meaningless-modifiers': 'warn',
    'no-superlative-claims': 'warn',
  },
})

Use a package-qualified ID if two loaded rulesets expose the same bare rule name.

Rule	Description
`@faircopy/rules-nlp/no-expletive-openers`	Flag sentence openings like `There are`
`@faircopy/rules-nlp/no-filter-words`	Ban filter phrases like `I think` and `it seems`
`@faircopy/rules-nlp/no-future-promises`	Flag future-tense promises like `will help you`
`@faircopy/rules-nlp/no-hedge-words`	Flag hedge words like `kind of` and `somewhat`
`@faircopy/rules-nlp/no-jargon`	Flag business jargon like `leverage` and `circle back`
`@faircopy/rules-nlp/no-passive-voice`	Flag likely passive-voice constructions
`@faircopy/rules-nlp/no-weak-modals`	Flag hedged modal claims like `can help` and `might improve`
`@faircopy/rules-nlp/no-stacked-adjectives`	Flag noun phrases with multiple adjectives before the noun
`@faircopy/rules-nlp/no-nominalized-phrases`	Flag nominalized `X of Y` phrases like `optimization of onboarding`
`@faircopy/rules-nlp/no-pronoun-led-claims`	Flag vague sentence openers like `This helps` and `It enables`
`@faircopy/rules-nlp/no-buzzword-stacks`	Flag sentences overloaded with abstract benefit nouns
`@faircopy/rules-nlp/no-vague-quantifiers`	Flag bare quantifiers without numeric anchors
`@faircopy/rules-nlp/no-meaningless-modifiers`	Flag intensifiers like `very` and `obviously` that add no information
`@faircopy/rules-nlp/no-superlative-claims`	Flag unproven superlatives like `best` and `world-class`

Packages

Package	Purpose
`faircopy`	Meta-package — install this
`@faircopy/cli`	`faircopy` binary
`@faircopy/core`	Engine: types, config loader, file resolver, rule runner
`@faircopy/astro`	Astro adapter
`@faircopy/rules-default`	Default ruleset
`@faircopy/rules-nlp`	Optional NLP-powered ruleset
`@faircopy/config`	`defineConfig()` helper
`@faircopy/plugin`	Claude Code plugin

License

MIT

@faircopy/plugin