Agent skill

Phoenix Docs Gap Audit

by Arize-ai in Arize-ai/phoenix

Audit documentation gaps across the Phoenix repo by analyzing recent commits to main (default: last 7 days).

Custom licenceAuto-check passedDevelopment

Install Phoenix Docs Gap Audit

skills CLI
$ npx skills add Arize-ai/phoenix --skill phoenix-docs-gap-audit -a claude-code

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

GitHub CLI
$ gh skill install Arize-ai/phoenix phoenix-docs-gap-audit --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/Arize-ai/phoenix.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/phoenix-docs-gap-audit .claude/skills/phoenix-docs-gap-audit && 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
phoenix-docs-gap-audit
GitHub stars
12k
Token cost
~4.8k tokens
SKILL.md length
2,273 words
Files
1
Skills in repo
39
Repo updated
First seen
Licence
Custom licence

At a glance

Audit documentation gaps across the Phoenix repo by analyzing recent commits to main (default: last 7 days).

  • Works in 5 steps: Gather commits → Triage → Locate the real code → …
  • The user asks to find undocumented features
  • SKILL.md covers Scope — what counts as…, Workflow, Grounding rules — do not skip and Report format, plus 2 more sections
  • Calls git

What it does

Phoenix Docs Gap Audit is an agent skill from Arize-ai/phoenix. Audit documentation gaps across the Phoenix repo by analyzing recent commits to main (default: last 7 days). Use this skill whenever the user asks to find undocumented features, identify docs gaps, audit what shipped without docs, check which recent changes need documentation, review stale docs against current code, or mentions "documentation debt", "doc coverage", "undocumented APIs", or "what's missing from /docs". Also trigger on requests like "what from last week needs docs", "find stale READMEs", or "check…

Its SKILL.md is about 4.8k 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 Development, covering Technical documentation and LLM observability. It works with Python. The repository describes itself as: AI Observability & Evaluation.

When your agent uses it

  • The user asks to find undocumented features
  • Identify docs gaps
  • Audit what shipped without docs
  • Check which recent changes need documentation

Example prompts

  • “documentation debt”
  • “doc coverage”
  • “undocumented APIs”
  • “/phoenix-docs-gap-audit”

Requirements

  • Python 3

Workflow steps

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

  1. Gather commits
  2. Triage
  3. Locate the real code
  4. Check every doc surface
  5. Classify every gap

What it can do on your machine

Read from SKILL.md and the folder at commit 856100b. 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

    Shell commands in SKILL.md call:

    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Phoenix Docs Gap Audit loads about 4.8k tokens when it runs. Until then it costs about 178 tokens; SKILL.md has 2,273 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 2,273 words (~4,808 tokens).

“Find everything in the Phoenix repo that shipped recently without proper documentation. The output is a gap report — not release notes, not new docs. The gap report tells the user (or a follow-up skill) exactly what is missing, where…”

— opening of SKILL.md by Arize-ai, Custom licence
name
phoenix-docs-gap-audit
metadata.internal
true

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/phoenix-docs-gap-audit of Arize-ai/phoenix.

Open the folder on GitHubat commit 856100b

Compare with similar skills

Phoenix Docs Gap Audit 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.

Phoenix Docs Gap Audit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Phoenix Docs Gap Audit this skillArize-ai/phoenix12k—~4.8kAutomated safety check: PassCustom licence
Adk Sample Creatorgoogle/adk-python22k—~1.3kAutomated safety check: PassApache-2.0
Glossarylightly-ai/lightly-studio896—~482Automated safety check: PassApache-2.0
Docstring Deep Divealbumentations-team/AlbumentationsX567—~534Automated safety check: PassAGPL-3.0
Swarmauri Add Community Standaloneswarmauri/swarmauri-sdk104—~387Automated safety check: PassApache-2.0
Swarmauri Add Experimental Standaloneswarmauri/swarmauri-sdk104—~457Automated safety check: PassApache-2.0

Similar skills

  • Adk Sample Creator

    google/adk-python

    Official

    Creates a new sample agent in the ADK Python repository — the sample directory, its agent.py, and its README.md — following the conventions the existing samples already use.

    22k GitHub stars~1.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Glossary

    lightly-ai/lightly-studio

    Read when naming anything user-facing - GUI text, docs, public Python API names, arguments, docstrings, or error messages.

    896 GitHub stars~482 tokensUpdated today
    DevelopmentAuto-check passed
  • Docstring Deep Dive

    albumentations-team/AlbumentationsX

    Review public AlbumentationsX docstrings for useful descriptions, runnable examples, parameter semantics, and related transforms.

    567 GitHub stars~534 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Swarmauri Add Community Standalone

    swarmauri/swarmauri-sdk

    Add a second-class standalone Swarmauri package under pkgs/community.

    104 GitHub stars~387 tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Add an experimental standalone Swarmauri package under pkgs/experimental.

    104 GitHub stars~457 tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Swarmauri Add Plugin Package

    swarmauri/swarmauri-sdk

    Add a Swarmauri plugin package under pkgs/plugins. An agent skill from swarmauri/swarmauri-sdk.

    104 GitHub stars~435 tokensUpdated 1 mo ago
    DevelopmentAuto-check passed

More from Arize-ai/phoenix

All 39 skills in this repo
  • Harbor Exec

    Arize-ai/phoenix

    A skill your agent uses when working with Harbor's harbor exec CLI workflow: compiling files, directories, or globs into Harbor tasks; running map jobs; configuring artifacts and existence-only…

    12k GitHub stars~909 tokensUpdated today
    Auto-check passed
  • Mintlify

    Arize-ai/phoenix

    Build and maintain documentation sites with Mintlify. An agent skill from Arize-ai/phoenix.

    12k GitHub starsUsed in 8 repos~3.4k tokens
    Auto-check passed
  • Phoenix Frontend

    Arize-ai/phoenix

    Frontend development guidelines for the Phoenix AI observability platform.

    12k GitHub stars~709 tokensUpdated today
    Auto-check passed
  • Phoenix Graphql

    Arize-ai/phoenix

    Write efficient GraphQL queries against the Phoenix API. An agent skill from Arize-ai/phoenix.

    12k GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Phoenix Server

    Arize-ai/phoenix

    Backend development guide for the Phoenix AI observability platform (Strawberry GraphQL, SQLAlchemy async, FastAPI).

    12k GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Phoenix Storybook

    Arize-ai/phoenix

    Conventions for creating, modifying, and reviewing production-faithful Storybook stories in the Phoenix frontend (js/app/stories, js/app/.storybook).

    12k GitHub stars~1.9k tokensUpdated today
    Auto-check passed

Works with

Questions about Phoenix Docs Gap Audit

What does Phoenix Docs Gap Audit do?

Audit documentation gaps across the Phoenix repo by analyzing recent commits to main (default: last 7 days). Phoenix Docs Gap Audit is an agent skill from Arize-ai/phoenix. Audit documentation gaps across the Phoenix repo by analyzing recent commits to main (default: last 7 days).

When should I use Phoenix Docs Gap Audit?

Phoenix Docs Gap Audit fits situations like: the user asks to find undocumented features; identify docs gaps; audit what shipped without docs; check which recent changes need documentation.

How do I install Phoenix Docs Gap Audit in Claude Code?

Run `npx skills add Arize-ai/phoenix --skill phoenix-docs-gap-audit -a claude-code`. Or copy the skill folder (.agents/skills/phoenix-docs-gap-audit in Arize-ai/phoenix) into .claude/skills/phoenix-docs-gap-audit in your project. Claude Code loads it when a task matches its description.

How do I install Phoenix Docs Gap Audit in Codex?

Run `npx skills add Arize-ai/phoenix --skill phoenix-docs-gap-audit -a codex`. Or copy the skill folder (.agents/skills/phoenix-docs-gap-audit in Arize-ai/phoenix) into .agents/skills/phoenix-docs-gap-audit in your project. Codex loads it when a task matches its description.

Can I use Phoenix Docs Gap Audit 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 Arize-ai/phoenix --skill phoenix-docs-gap-audit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/phoenix-docs-gap-audit, .gemini/skills/phoenix-docs-gap-audit, .github/skills/phoenix-docs-gap-audit and .opencode/skills/phoenix-docs-gap-audit in your project.

What does Phoenix Docs Gap Audit need to run?

Going by SKILL.md and its folder, Phoenix Docs Gap Audit needs the command-line tools its instructions call (git). Our summary lists: Python 3.

Does Phoenix Docs Gap Audit access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Phoenix Docs Gap Audit 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 Phoenix Docs Gap Audit use?

Phoenix Docs Gap Audit has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Phoenix Docs Gap Audit use?

About 4.8k tokens (SKILL.md is roughly 19k 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 Phoenix Docs Gap Audit?

Skills that share tags, products or a category with Phoenix Docs Gap Audit: Adk Sample Creator (google/adk-python, 22k stars), Glossary (lightly-ai/lightly-studio, 896 stars), Docstring Deep Dive (albumentations-team/AlbumentationsX, 567 stars) and Swarmauri Add Community Standalone (swarmauri/swarmauri-sdk, 104 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Phoenix Docs Gap Audit?

Arize-ai (a GitHub organization) maintains it in Arize-ai/phoenix, which has 11,744 GitHub stars. The repository holds 39 skills in this directory. The repository was last updated on October 8, 2026.

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