Agent skill · writing content · jeremylongshore
audit-plugin
Performs a deep review of the Claude Code plugin, skill, or sub-agent defined in the current project against official best practices. Documents findings as GitHub issues and writes a prioritised fix plan to the project CLAUDE.md. Use when the user says audit this plugin, review this skill, check this agent, or audit addon.
Why this skill is useful
Adds a detailed auditing process for Claude Code plugins that includes generating actionable GitHub issues and a prioritised fix plan, which the AI wouldn't reliably generate on its own.
What it needs
Requires gh installed locally. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Audit Plugin Project: !basename $(git rev-parse --show-toplevel 2>/dev/null) 2>/dev/null basename $PWD Branch: !git branch --show-current 2>/dev/null echo "unknown" Reviews the Claude Code addon in the current project (plugin, skill, sub-agent, or a combination) against official Claude Code best practices. Generates actionable GitHub issues and a prioritised fix plan. Step 0: Pre-flight check Step 1: Identify what kind of addon this project defines Scan for known Claude Code addon files: Read each file found. Build a mental model of: Plugin manifest (.claude-plugin/plugin.json) — name, version, declared agents/skills Skills (skills/<name>/SKILL.md) — frontmatter fields, body structure, tool declarations Agents (agents/<name>.md) — frontmatter fields, description examples, tool restrictions Step 2: Fetch current best-practice documentation Use WebFetch to retrieve up-to-date guidance from these known URLs: Skills: https://code.claude.com/docs/en/skills Sub-agents: https://code.claude.com/docs/en/agents Plugins: https://code.claude.com/docs/en/plugins If any URL returns an error, use WebSearch to find the current equivalent under code.claude.com. Summarise the key quality criteria from each source. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/audit-plugin