菜单
Use to audit Agent Skills catalogs or installed skill roots: validate SKILL.md frontmatter, Codex openai.yaml metadata, README catalog coverage, cli-* version pins, and relative resource links; optionally apply conservative --fix-safe metadata repairs.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
Use only when explicitly asked to archive/prune/compact/roll over checked tasks from TODO.md into `.ai/todos/TODO_UNTIL_YYYY_MM_DD.md`, leaving unchecked tasks.
Use only when explicitly invoked for Git commit workflows: stage intended changes, craft Conventional Prefix Format messages by default, Natural Language messages with --natural or configured repos, commit, and optionally --all, --staged, --deep, --close, or --push.
Use for dependency updates: update/bump deps, npm/pnpm/yarn/bun package upgrades, outdated checks, package.json updates, or taze.
Use for release versioning: bump/cut/tag a release, bump version, create a release, changelog updates, or version tagging.
Use for GitHub PR/issue/discussion workflows: create/update PRs or issues, post comments, start discussions; triggers include create/open PR, file/update issue, yeet.
Use to polish recently changed code: simplify for readability/maintainability and run a risk-profiled review that autonomously applies fixes. Default runs both passes; pass --simplify or --review for one. Covers code/PR review, audits, bug/security checks, reviewing diffs or changes, cleanup, refactoring, and reducing complexity.
| argument-hint | [--root PATH ...] [--format text|json] [--fix-safe] [--include-shelved] |
| disable-model-invocation | false |
| name | skill-doctor |
| user-invocable | true |
| description | Use to audit Agent Skills catalogs or installed skill roots: validate SKILL.md frontmatter, Codex openai.yaml metadata, README catalog coverage, cli-* version pins, and relative resource links; optionally apply conservative --fix-safe metadata repairs. |
Audit local Agent Skills catalogs and installed skill roots, then apply only narrow metadata repairs when requested.
--root PATH: Scan this catalog or installed skill root. Repeatable. Default: current working directory.--format text|json: Select report format. Default: text.--fix-safe: Create missing agents/openai.yaml files or update mismatched policy.allow_implicit_invocation.--include-shelved: Include shelved/*/SKILL.md in metadata checks. Shelved skills are never required in README.md.Resolve the skill directory, then run the helper from that directory:
uv run scripts/skill-doctor.py "$ARGUMENTS"
Use JSON when another command or agent will consume the result:
uv run scripts/skill-doctor.py --root . --format json
Run safe fixes only after reading the findings:
uv run scripts/skill-doctor.py --root . --fix-safe
Re-run without --fix-safe after any manual edits.
error findings as catalog defects that should block publishing or syncing.warning findings as review-required catalog hygiene issues.path and line from JSON output for precise follow-up edits.--fix-safe may only:
agents/openai.yaml with policy.allow_implicit_invocation derived from SKILL.md.allow_implicit_invocation boolean when it disagrees with disable-model-invocation.Do not use the helper to rewrite frontmatter order, descriptions, README rows, references/version.txt, or relative links. Make those edits manually and verify with a fresh audit.
0: Clean, or all requested safe fixes succeeded and no findings remain.1: Findings remain.2: Invalid arguments or unreadable environment.3: A requested safe fix failed.