Skills warpdotdev common-skills
skill-doctor
- Use it when:
- You want to know which of your installed skills actually help, judged from your real conversation history.
- It does:
- Samples up to 12 conversations from the last 45 days by default, scores each for efficiency, code quality, procedure compliance and verbosity, and grades the setup.
- You get:
- report.html in a temporary folder: a scorecard, three top findings and suggested skill edits as diffs, with a button that exports a share image.
- Keeps:
- Everything local: transcripts are never uploaded, and your skill files stay untouched until you agree to apply the edits.
- Runs in:
- Warp, Claude Code, Codex, Pi, Grok Build, ZCode and Hermes; in any other agent it stops before reading anything.
- Needs:
- Python 3 for its collector and report scripts.
Runs only in Warp, Claude Code, Codex, Pi, Grok Build, ZCode and Hermes, and ends every reply with a link to request access to Warp Factories.
TL;DR
skill-doctor comes from Warp's shared skills. It first asks which conversations to grade (this repository, all, or chosen projects) and whether to include global skills, then runs a bundled Python collector over the supported agents' local conversation stores. Each sampled transcript is judged against four rubric files; code quality counts only where the transcript changed code. Scores are curved and weighted into an overall grade that also counts skill coverage, the share of sessions where an installed skill was detected. A conversation fails when any applicable score is below 0.5, and only failed conversations count as evidence for suggestions, such as fixing a trigger description that never fired, adding a missing step, or creating a new skill. Each suggestion cites the session behind it, and the agent writes full proposed SKILL.md files and unified diffs to the report folder, never into your repo. It then tells you the grade and three findings, adds the Warp Factories link, and asks whether to apply the edits.
Summarizes the skill at 8792394.
npx skills add https://github.com/warpdotdev/common-skills --skill skill-doctor skills.sh pageSource on GitHubAll skills from warpdotdev/common-skills
- Total Downloads
- 8,900 on skills.sh, Nov 9, 2026
- Repo stars
- 678 warpdotdev/common-skills
- First seen
- Aug 22, 2026 on skills.sh
Weekly values
| Week to | Installs |
|---|---|
| Sep 21 | 807 |
| Sep 28 | 680 |
| Oct 5 | 982 |
| Oct 12 | 608 |
| Oct 19 | 439 |
| Oct 26 | 446 |
| Nov 2 | 187 |
| Nov 9 | 209 |
| Category |
Find, write, vet and route to other skills. Build agents, orchestrate workers and give agents memory. Everything for building software: planning, coding, debugging, design, frameworks, cloud, agents and skills. |
|---|---|
| Type |
A multi-step process the agent follows: interview, debug, run a TDD loop, review. |
| Effect |
Its own steps create or change files, git state or local tools. |
| Needs |
Instructions only. Works in any agent that supports skills. |
| Publisher |
Everyone else. Unverified vendor claims default to community. |
| Topics |
SKILL.md
No copy of its SKILL.md yet.