# Skill Doctor

> Lints every Claude Agent Skill (SKILL.md) in a repo before you ship it. Use this whenever you add or edit a skill, to catch missing frontmatter fields, oversized descriptions, or a broken python_import before an agent ever loads it.

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

---


# Skill Doctor

A meta-skill: it uses `skillsmith` to lint every other skill in this
repository, so an agent (or a CI job) can self-check the skills it ships
before anyone relies on them.

## Usage

```
python -c "from skill_doctor import run; run('.')"
```

or from the shell:

```
skillsmith lint .
```

## When to use this

- Right after scaffolding a new skill with `skillsmith init`.
- In CI, before merging a PR that adds or edits a `SKILL.md`.
- Whenever an agent is about to hand a freshly written skill to another agent.