Agent skill

AI Visibility Writing

by elvisun in elvisun/newsjack

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…

MITAuto-check passedMarketing & SEO

Install AI Visibility Writing

skills CLI
$ npx skills add elvisun/newsjack --skill ai-visibility-writing -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install elvisun/newsjack ai-visibility-writing --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/elvisun/newsjack.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/ai-visibility-writing .claude/skills/ai-visibility-writing && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ai-visibility-writing
GitHub stars
1.5k
Token cost
~2.6k tokens
SKILL.md length
1,342 words
Files
1
Skills in repo
30
Repo updated
First seen
Licence
MIT

At a glance

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…

  • Works in 5 steps: Build the fact ledger first → Read the audience and likely queries → Separate eligibility from writing → …
  • Someone asks for AI visibility
  • SKILL.md covers Choose the requested behavior, 1. Build the fact ledger first, 2. Read the audience and… and 3. Separate eligibility from…, plus 11 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

AI Visibility Writing is an agent skill from elvisun/newsjack. 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…

Its SKILL.md is about 2.6k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering AI search optimization. It works with OpenAI. The repository describes itself as: The open-source skills that turn your agent into a full PR team. The licence is MIT.

When your agent uses it

  • Someone asks for AI visibility
  • ChatGPT citation optimization of supplied writing
  • They want an evidence-aware pre-publication audit
  • Another Newsjack workflow needs a prose-level AI-discoverability pass

Example prompts

  • “/ai-visibility-writing”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Build the fact ledger first
  2. Read the audience and likely queries
  3. Separate eligibility from writing
  4. Select only applicable levers
  5. Audit, ask, suggest, or rewrite

What it can do on your machine

Read from SKILL.md and the folder at commit 3b7fb82. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

AI Visibility Writing loads about 2.6k tokens when it runs. Until then it costs about 165 tokens; SKILL.md has 1,342 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~165
When it runs · the whole SKILL.md, loaded when a task matches
~2.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from elvisun/newsjack at commit 3b7fb82, republished under its MIT licence (© elvisun). 1,342 words, ~2,571 tokens.

Download SKILL.mdSave it as .claude/skills/ai-visibility-writing/SKILL.md (or your agent's skills folder).
name
ai-visibility-writing
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.
metadata.category
AI visibility

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

State the primary human audience and two to four plausible information needs the piece can honestly answer. Prefer the user's target queries when supplied. Otherwise infer cautiously from the document and label the inference.

Distinguish:

  • the reader's question;
  • the answer this document can support;
  • the answer the organization wishes it could support but cannot yet prove.

Ask a blocking question only when its answer would change the target query, the factual ceiling, the recommended intervention, or whether a rewrite is safe. Group questions by priority and ask no more than five at once. Do not ask for optional analytics, personas, or keywords merely to appear thorough.

3. Separate eligibility from writing

Give two clearly separated diagnoses:

  • Retrieval and authority limits: indexing, crawl access, snippet eligibility, page HTML, internal links, canonicalization, structured data, publisher reputation, backlinks, and off-site mentions. These can dominate visibility but are outside a prose-only edit.
  • Writing-level opportunities: relevance, extractable answers, evidence, attribution, entity clarity, structure, specificity, and human readability in the supplied text.

Do not imply that prose can repair an unindexed page or weak publisher authority. Google says its ordinary Search eligibility and people-first practices remain foundational for AI features and that no special AI markup is required. Treat platform behavior as changeable and cross-engine findings as non-universal.

4. Select only applicable levers

Use the smallest useful set. Label each recommendation supported, promising, or speculative; the label describes the evidence for the recommendation, not a prediction for this page.

  1. Add unique, verifiable information — promising. Prefer firsthand data, a defined method, an expert observation, or a real example over a commodity summary. Ask for proof when it is missing.
  2. Put a scoped answer near its descriptive heading — promising. Make the first useful sentence answer the likely question directly, then add nuance. Do not manufacture certainty or flatten a complex answer.
  3. Tie claims to evidence and attribution — promising. Name who found what, when, in which population or context, and from which supplied source. More citations are not automatically better.
  4. Clarify entities and relationships — promising. On first reference, disambiguate organizations, products, people, places, and acronyms when a reader could reasonably confuse them.
  5. Use descriptive sections and coherent chunks — promising. Give each section one job. Use headings that name the subject and consequence; avoid vague labels such as “Overview” when a precise label is available.
  6. Match format to intent — promising and conditional. Use steps for a real procedure and tables for genuine comparisons. Do not bolt FAQs, tables, or question headings onto announcements that do not need them.
  7. Expose legitimate freshness — promising and conditional. State a real publication, update, measurement, or effective date for time-sensitive information. Never add, hide, or alter a date to simulate freshness.
  8. Replace promotion with specific, qualified prose — promising. Trade empty superiority claims for the exact supported outcome, scope, and limitation. Keep necessary brand voice.
  9. Preserve useful precision — supported human-quality guard. Simplify syntax when it helps, but retain technical terms, caveats, and register the audience needs. A lower reading grade is not a universal win.
  10. Remove repetition and checklist padding — supported safety guard. Use a natural term when it is the right term; do not repeat keywords, create doorway copy, or expand the document so every lever appears.

For a press release, the strongest intervention may be better proof or a separate owned analysis page with method, data, and limitations. Say so when the announcement cannot credibly answer the target query. Do not disguise a thin announcement as an authoritative explainer with cosmetic headings.

Show full SKILL.md (505 more words)Show less

5. Audit, ask, suggest, or rewrite

Audit

Identify the extractable claims, evidence gaps, ambiguous entities, buried answers, mismatched structure, promotional passages, and applicable levers. Name the dominant non-writing limitation before recommending prose changes.

Question

Ask only blockers. Explain in a phrase what each answer would unlock. If a question only changes polish, continue without it and state the assumption.

Suggest

Rank no more than three changes by expected usefulness to the intended reader and likely query. For each, identify the exact passage, edit, evidence label, reason, and tradeoff. Avoid a universal checklist or fake score.

Rewrite

Rewrite only when requested and the fact ledger is sufficient. Keep the document's meaning, voice, document type, and evidentiary ceiling. Do not:

  • invent facts or strengthen an unsupported claim;
  • convert correlation into causation;
  • change who said or found something;
  • detach a number from its denominator, period, population, or source;
  • remove caveats to create a cleaner answer;
  • recommend hidden text, misleading schema, citation laundering, or keyword stuffing.

After rewriting, compare the revision against the ledger. If a protected item changed or disappeared, restore it or stop and disclose the blocker.

Output

Return readable Markdown in this order:

Verdict

Two sentences: what the document can credibly become and the dominant limit.

Highest-leverage changes

List up to three changes. Then show:

ChangeWhyConfidenceTradeoff

Use only supported, promising, or speculative in the Confidence column.

Blocking questions

Include only when needed. Say None when the supplied facts are sufficient.

Revision

Include only when requested and safe. If blocked, say what proof or decision is needed; do not emit a knowingly misleading partial rewrite.

Fact-preservation note

Name protected details retained, any claim intentionally softened, and any material passage left unchanged because evidence was missing.

Measurement caveat

State in one sentence that the edits may improve clarity or extractability but do not guarantee retrieval, mention, citation, ranking, traffic, or coverage. When useful, propose a before/after test using the same query set, platform, location, time window, and repeated runs; measure mentions, citations, and accurate answer use separately.

Short examples

Thin release: If “Acme launches the leading fraud platform” has no metric, method, customer evidence, or comparison set, ask for proof and do not upgrade the claim. Recommend an evidence page if the release itself cannot carry it.

Technical blog: If a security article defines a result precisely, preserve its caveats and terminology. Improve the heading and opening answer without rewriting it to a universal low reading grade.

Freshness-sensitive article: If the draft supplies an effective date and an official source, keep both beside the affected claim. Do not change an old date or add “updated” without a real update.

Final quality gate

Before returning, confirm that:

  • every suggestion is applicable to this document and target query;
  • every stronger claim is supported by supplied or verified evidence;
  • every protected ledger item survives the rewrite with its relationships;
  • out-of-scope technical work is labeled rather than smuggled into prose advice;
  • the result remains useful and natural for the intended human reader;
  • no sentence promises an AI visibility outcome.

© elvisun, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/ai-visibility-writing of elvisun/newsjack.

Open the folder on GitHubat commit 3b7fb82

Compare with similar skills

AI Visibility Writing next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

AI Visibility Writing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
AI Visibility Writing this skillelvisun/newsjack1.5k—~2.6kAutomated safety check: PassMIT
Blog StrategyAgriciDaniel/claude-blog2.3k—~4.4kAutomated safety check: PassMIT
Blog StrategyInfrasity-Labs/dev-gtm-claude-skills136—~3.8kAutomated safety check: PassMIT
Geo Fundamentalswasp-lang/wasp19k9 repos~861Automated safety check: PassMIT
SEO GeoReScienceLab/opc-skills1.8k4 repos~2.1kAutomated safety check: PassApache-2.0
GEO-First SEO Audit Toolzubair-trabzada/geo-seo-claude11k—~2.8kAutomated safety check: NotesMIT

Similar skills

  • Blog Strategy

    AgriciDaniel/claude-blog

    Blog strategy development including topic cluster architecture with hub-and-spoke design, audience mapping, competitive landscape analysis, AI citation surface strategy across ChatGPT/Perplexity/AI…

    2.3k GitHub stars~4.4k tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed
  • Blog Strategy

    Infrasity-Labs/dev-gtm-claude-skills

    Blog strategy development including topic cluster architecture with hub-and-spoke design, audience mapping, competitive landscape analysis, AI citation surface strategy across ChatGPT/Perplexity/AI…

    136 GitHub stars~3.8k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed
  • Geo Fundamentals

    wasp-lang/wasp

    Generative Engine Optimization for AI search engines (ChatGPT, Claude, Perplexity).

    19k GitHub starsUsed in 9 repos~861 tokens
    Marketing & SEOAuto-check passed
  • SEO Geo

    ReScienceLab/opc-skills

    SEO & GEO (Generative Engine Optimization) for websites. An agent skill from ReScienceLab/opc-skills.

    1.8k GitHub starsUsed in 4 repos~2.1k tokens
    Marketing & SEOAuto-check passed
  • GEO-First SEO Audit Tool

    zubair-trabzada/geo-seo-claude

    Audits a website for AI search visibility across ChatGPT, Claude, Perplexity and Google AI Overviews while checking traditional SEO, schema and E-E-A-T content quality.

    11k GitHub stars~2.8k tokensUpdated yesterday
    Marketing & SEOAuto-check: notes
  • Qiaomu SEO

    joeseesun/qiaomu-seo

    Audit, diagnose, research, plan, implement, experiment on, and verify website SEO across Google, Bing, and AI-search surfaces.

    441 GitHub stars~2.6k tokensUpdated 2 mo ago
    Marketing & SEOAuto-check passed

More from elvisun/newsjack

All 31 skills in this repo
  • Eval Graphics

    elvisun/newsjack

    Turn an eval study's numbers into on-brand, publish-ready figures using the Newsjack chart room (the eval design system), then validate them with Playwright.

    1.5k GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Coverage Reel

    elvisun/newsjack

    Turn a user-owned coverage CSV and reviewed press-clip captures into an honest, source-linked earned-media dashboard and a motion-designed highlight reel (MP4) that scrolls each real article to the…

    1.5k GitHub stars~3.9k tokensUpdated today
    Auto-check passed
  • Icp Evidence Analysis

    elvisun/newsjack

    Turn a source-bound company and market dossier into testable ideal-customer-profile hypotheses, buying roles, triggers, constraints, disqualifiers, standing, counterevidence, and research gaps.

    1.5k GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Research any company, product, or service from a URL plus description and build a comprehensive, evidence-bound AEO/GEO/AI-visibility prompt panel across buyer jobs, information acts, journey…

    1.5k GitHub stars~3.1k tokensUpdated today
    Auto-check passed
  • Reactive Comment

    elvisun/newsjack

    Triage inbound journalist source queries and draft a response only when the user's expertise is a real fit.

    1.5k GitHub stars~5.6k tokensUpdated today
    Auto-check passed
  • Recover source-bound buyer jobs, struggling moments, desired progress, forces, workarounds, information acts, journey states, criteria, constraints, roles, locales, and authentic language.

    1.5k GitHub stars~1.4k tokensUpdated today
    Auto-check passed

Works with

Questions about AI Visibility Writing

What does AI Visibility Writing do?

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…. AI Visibility Writing is an agent skill from elvisun/newsjack. 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.

When should I use AI Visibility Writing?

AI Visibility Writing fits situations like: someone asks for AI visibility; chatGPT citation optimization of supplied writing; they want an evidence-aware pre-publication audit; another Newsjack workflow needs a prose-level AI-discoverability pass.

How do I install AI Visibility Writing in Claude Code?

Run `npx skills add elvisun/newsjack --skill ai-visibility-writing -a claude-code`. Or copy the skill folder (skills/ai-visibility-writing in elvisun/newsjack) into .claude/skills/ai-visibility-writing in your project. Claude Code loads it when a task matches its description.

How do I install AI Visibility Writing in Codex?

Run `npx skills add elvisun/newsjack --skill ai-visibility-writing -a codex`. Or copy the skill folder (skills/ai-visibility-writing in elvisun/newsjack) into .agents/skills/ai-visibility-writing in your project. Codex loads it when a task matches its description.

Can I use AI Visibility Writing in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add elvisun/newsjack --skill ai-visibility-writing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ai-visibility-writing, .gemini/skills/ai-visibility-writing, .github/skills/ai-visibility-writing and .opencode/skills/ai-visibility-writing in your project.

What does AI Visibility Writing need to run?

SKILL.md names no scripts, command-line tools or credentials: AI Visibility Writing is instructions for the agent only.

Does AI Visibility Writing access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is AI Visibility Writing safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does AI Visibility Writing use?

AI Visibility Writing is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does AI Visibility Writing use?

About 2.6k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to AI Visibility Writing?

Skills that share tags, products or a category with AI Visibility Writing: Blog Strategy (AgriciDaniel/claude-blog, 2.3k stars), Blog Strategy (Infrasity-Labs/dev-gtm-claude-skills, 136 stars), Geo Fundamentals (wasp-lang/wasp, 19k stars) and SEO Geo (ReScienceLab/opc-skills, 1.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains AI Visibility Writing?

elvisun (a GitHub user) maintains it in elvisun/newsjack, which has 1,541 GitHub stars. The repository holds 30 skills in this directory. The repository was last updated on October 11, 2026.

Source: elvisun/newsjack on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.