# Skill Dependency Audit

> Use when auditing optional Python dependencies for vendored Claude skill helper scripts, checking missing imports, deciding whether dependencies belong in MCP runtime, or troubleshooting a skill script that fails with ModuleNotFoundError.

- Skill: `26zl/skill-dependency-audit` (Agent Skill)
- Install (CLI): `npx skillmds@latest add 26zl/skill-dependency-audit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/26zl/skill-dependency-audit/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: 26zl (https://skillmd.com/u/26zl)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/26zl/skill-dependency-audit

---


# 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:

```bash
python3 scripts/audit_skill_dependencies.py
```

1. For JSON output:

```bash
python3 scripts/audit_skill_dependencies.py --json
```

1. For CI-like behavior:

```bash
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.