{"version":"2.1.221","anchor":"claude-api-skill-gains-a-prompt-audit-subcommand","canonical_anchor":"claude-api-skill-gains-a-prompt-audit-subcommand","heading":"claude-api skill gains a prompt-audit subcommand","tier":"use","area":"Skills","scope":null,"heads_up":null,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.221\/e\/claude-api-skill-gains-a-prompt-audit-subcommand","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.221","markdown":"### claude-api skill gains a `prompt-audit` subcommand\n\nYou can run \/claude-api prompt-audit to scan prompts and tool descriptions for outdated patterns and get a diff.\n\n**What**\n\nThe bundled Claude API skill can now audit existing prompts, skills, and tool descriptions for dated patterns written for older models, driven by a new `shared\/prompt-audit.md` guide registered in the skill's file map.\n\n**Details**\n\n- `prompt-audit` is added as a second top-level subcommand row alongside `migrate`, and is a recognized subcommand so `\/claude-api prompt-audit` routes straight to a seven-step procedure covering pressure language, prefill and stop-sequence scaffolds, over-specification, and fossils.\n- It is specified as non-interactive: Step 0 establishes scope and target model from the request and the repository and states assumptions rather than asking.\n- Output is both an audit report (findings with `file:line`, pattern, why it's obsolete, confidence) and a proposed diff, emitted without pausing for confirmation; edits are applied only if explicitly asked.\n- The skill-assembly function special-cases the subcommand: when no project language is detected it appends the \"ask the user which language\" instruction only if the subcommand is not `prompt-audit`. The prompt text carries matching carve-outs, so the \"Before You Start\" non-Anthropic-provider stop is skipped (markers go into the report's stated assumptions instead) and the Language Detection section says to skip its ask steps because the inventory is language-agnostic.\n- The migration guide and the reference-documentation index both route \"audit \/ clean up prompts, skills, or tool descriptions for outdated patterns\" to the new file.\n\n**Usage**\n\n`\/claude-api prompt-audit` **Evidence** `Audit existing prompts, skills, and tool descriptions for dated patterns (\"cruft\") written for older models.`, `No project language was auto-detected. Ask the user which language they are using, then refer to the matching docs below.`, `**Audit \/ clean up prompts, skills, or tool descriptions for outdated patterns (\"cruft\"):**`, `shared\/prompt-audit.md`\n\n- Area: Skills\n- Names: `\/claude-api prompt-audit`\n- Tier: Use it now\n- Useful: 4\/5\n- Signal: 0\/5"}