Auditing Prompt Docs

Audit and fix prompt-bearing documents — SKILL.md, CLAUDE.md, AGENTS.md, agent and command definitions, reference files, whole repositories — against Anthropic's published prompting guidance for current Claude models, proposing edits for approval before writing anything. Also answers how to prompt a specific model: holds the per- model guidance for Claude Fable 5.2, Claude Opus 5.5, Claude Sonnet 5.5, and Claude Haiku 5.5 alongside the cross-model practices. Use when reviewing or slimming an instruction file, when instructions are ignored or fire too often, when migrating a prompt to a newer m

5 starsAI, LLMs & Agents Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add tomada1114/tomada-claude-plugins

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add tomada1114/tomada-claude-plugins --skill auditing-prompt-docs
Manual install
git clone --depth 1 https://github.com/tomada1114/tomada-claude-plugins.git /tmp/tomada-claude-plugins
mkdir -p ~/.claude/skills
cp -r /tmp/tomada-claude-plugins/tomada-kit/skills/auditing-prompt-docs ~/.claude/skills/auditing-prompt-docs

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Auditing prompt docs

The published guidance lives in `references/` and a linter finds the phrasings
that measurably hurt; memory of prompting advice predates the current models.

## Contract

**Input:** free-form. Either a question about prompting a model, or one or more
targets to audit (a file, a directory, a repository, a skill name). With no
target named for an audit request, ask which one.

**Output:** for a question, an answer grounded in the reference files. For an
audit, a proposal at
`${AGENT_SKILL_STATE_DIR:-$HOME/.local/state/agent-skills}/auditing-prompt-docs/<target-slug>/findings.md`,
then edits to the target — only after the user approves them.

## Path A: answer a prompting question

Read [references/general-practices.md](references/general-practices.md) first; it holds the cross-model practices
and the table of where the models diverge. Open the file for the model in
question when the answer turns on that model's behavior. Answer from those files
rather than from memory, and say which model a claim is measured on — guidance
for one model is not automatically true of another.

## Path B: audit documents

### 1. Scan

```bash
python3 ${CLAUDE_SKILL_DIR}/scripts/lint_prompt_doc.py <target...> --json
```

Directories are walked for SKILL.md, CLAUDE.md, AGENTS.md, and `*.md` under
`agents/`, `commands/`, and `references/`. Any other document has to be passed
as an explicit file path. Exit code 1 means findings, 2 means bad invocation.
Read the full skill on GitHub

Details

Skill name
auditing-prompt-docs
Path
tomada-kit/skills/auditing-prompt-docs/SKILL.md
Repo updated
12 November 2026

FAQ

What does the Auditing Prompt Docs skill do?

Audit and fix prompt-bearing documents — SKILL.md, CLAUDE.md, AGENTS.md, agent and command definitions, reference files, whole repositories — against Anthropic's published prompting guidance for current Claude models, proposing edits for approval before writing anything. Also answers how to prompt a specific model: holds the per- model guidance for Claude Fable 5.2, Claude Opus 5.5, Claude Sonnet 5.5, and Claude Haiku 5.5 alongside the cross-model practices. Use when reviewing or slimming an instruction file, when instructions are ignored or fire too often, when migrating a prompt to a newer m

How do I install the Auditing Prompt Docs skill?

Claude Code plugin: /plugin marketplace add tomada1114/tomada-claude-plugins. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Auditing Prompt Docs popular?

It lives in tomada1114/tomada-claude-plugins, which has 5 GitHub stars and 0 forks.

Related skills

Auditing Repositories

5

tomada1114/tomada-claude-plugins

Audit the repository you are in, often a template or an app cut from one, for technical debt and room to improve in four areas: architecture and design patterns; tests; file structure and code quality; and tooling, CI, dependencies and the agent harness. Design a safe, test-first fix for every evidenced finding, and file the findings as GitHub issues that follow the repository's own issue conventions (triaging-issues, issue forms, past issues). A finding inherited from the template is also filed in the template repository. Cheap read-only sub-agents collect the evidence and high-effort analyst

Testing & QA

Authoring Goal Prompts

5

tomada1114/tomada-claude-plugins

Author a self-contained prompt for Claude Code's /goal command, run unattended in a separate session — a lead-to-staff handoff where this session researches, designs, and decides with full context, and a fresh executor session (Opus 5.5 or Fable 5.2, with none of that context) implements. Drafts a goal with measurable done-criteria, transcript-verifiable checks, scope + anti-cheat constraints, and stop rules; packages design intent, code examples, research findings, checklists, and pre-answered decisions as support files in a per-goal state directory whenever the executor would otherwise re-de

AI, LLMs & Agents

Bootstrapping From Templates

5

tomada1114/tomada-claude-plugins

Cut a new GitHub repository from one of the user's template repositories and bring it to a clean first commit: create it from the template (public by default) with scripts/create_from_template.py, clone it under ghq, follow the template's own starting-an-app procedure for the rename or bootstrap (a script, a just recipe, or a placeholder inventory), write AGENTS.md's Product section from signed-off requirements, copy kickoff drafts into docs/, run the template's checks, sync its labels, and push. Use when creating a repository from a template, running a template's bootstrap or rename, a placeh

Writing & Content

AI Agents Architect

5

Dreydrey9000/claude-skills

Expert in designing and building autonomous AI agents. Masters tool use, memory systems, planning strategies, and multi-agent orchestration. Use when: build agent, AI agent, autonomous agent, tool ...

AI, LLMs & Agents

Close

5

Magnus-Gille/claude-skills

Close a coding-agent session or produce its final handoff only when the user explicitly asks to close, wrap up, or produce an end-of-session handoff.

AI, LLMs & Agents

Agent Development

5

Dreydrey9000/claude-skills

This skill should be used when the user asks to "create an agent", "add an agent", "write a subagent", "agent frontmatter", "when to use description", "agent examples", "agent tools", "agent colors", "autonomous agent", or needs guidance on agent structure, system prompts, triggering conditions, or agent development best practices for Claude Code plugins.

AI, LLMs & Agents

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.