Skill helper dependency audit

Use this skill when a vendored .claude/skills/*/scripts/*.py helper fails to import, or when deciding whether optional skill dependencies should be installed.

Workflow

1. Run the dependency auditor:

python3 scripts/audit_skill_dependencies.py

1. For JSON output:

python3 scripts/audit_skill_dependencies.py --json

1. For CI-like behavior:

python3 scripts/audit_skill_dependencies.py --fail-on-missing

Policy

• Do not add every vendored helper dependency to mcp_server/pyproject.toml.
• Keep MCP runtime minimal unless the MCP server imports the dependency directly.
• Treat vendored skill helper dependencies as optional, task-specific extras.
• If a helper becomes a supported project feature, add tests and promote only its required dependencies.

Output interpretation

• third_party_imports: import names found in skill helper scripts.
• missing: imports not available in the active Python environment.
• examples: representative scripts that import that module.