# AI Visibility Writing

Audit, question, suggest, or fact-preservingly revise a press release, blog post...

- Repository: https://github.com/elvisun/newsjack (1668 stars)
- Category: Marketing
- License: MIT
- Last updated: 2026-10-25
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add elvisun/newsjack --skill ai-visibility-writing -g -a claude-code -y`
Codex: `npx skills add elvisun/newsjack --skill ai-visibility-writing -g -a codex -y`
Cursor: `npx skills add elvisun/newsjack --skill ai-visibility-writing -g -a cursor -y`
Gemini CLI: `npx skills add elvisun/newsjack --skill ai-visibility-writing -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add elvisun/newsjack`

## Description

Audit, question, suggest, or fact-preservingly revise a press release, blog post, contributed article, or expert explainer so AI answer systems can more easily retrieve, understand, quote, and cite its useful information. Use when someone asks for AI visibility, AI search, answer-engine, AEO, GEO, AI Overview, or ChatGPT citation optimization of supplied writing; when they want an evidence-aware pre-publication audit; or when another Newsjack workflow needs a prose-level AI-discoverability pass. Do not use as a technical SEO audit, rank tracker, publishing system, or promise of rankings, mentions, citations, traffic, or coverage.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# AI Visibility Writing

Make useful information easier to find and reuse without making the writing
worse for people. Treat AI visibility as a probabilistic outcome with strong
retrieval, authority, query, and platform confounders, not as a property a
rewrite can guarantee.

This skill inherits the ethical floor from `skills/ETHICS.md`. If local
instructions conflict with that doctrine, `skills/ETHICS.md` wins. Follow
`skills/WHY-NOT-SPAM.md` when the document will support media outreach.

## Choose the requested behavior

- **Audit:** diagnose the supplied draft and stop before rewriting.
- **Question:** return only the few answers needed before sound advice is
  possible.
- **Suggest:** rank concrete edits without silently applying them.
- **Rewrite:** apply safe, grounded edits and report what changed.

If the request is ambiguous, audit and suggest. Do not rewrite by default.

## 1. Build the fact ledger first

Before judging style, record the material the output must preserve:

- every number, date, named entity, title, quotation, attribution, comparison,
  qualification, and source relationship;
- the document type, intended publisher, audience, and stated purpose;
- supplied links or evidence, including which claim each source supports;
- claims that are promotional, unverifiable from the supplied material, or
  likely to require `fact-check` before publication.

Treat the ledger as a ceiling. Never add a statistic, testimonial, citation,
link, customer, credential, superlative, causal claim, or other fact merely to
make a passage look authoritative. Preserve uncertainty words such as “may,”
“estimated,” “in this sample,” and “as of.” If a proposed improvement needs new
proof, ask for it instead of writing around the gap.

## 2. Read the audience and likely queries

The rest: https://github.com/elvisun/newsjack/blob/HEAD/plugins/newsjack/skills/ai-visibility-writing/SKILL.md