Agent skill · warpdotdev
skill-doctor
Grades agent skills by scoring agent conversations against efficiency and code-quality rubrics, then drafts concrete skill edits and a shareable report. Use when the user wants their agent setup graded from real conversation history, or asks which of their installed skills are actually working.
What it needs
About 5k tokens when loaded.
What this skill does
skill-doctor Grade the user's agent setup by scoring recent local agent conversations, then propose concrete skill edits and render one shareable report page. The report can cover conversations in the current repository, conversations in selected projects, or all local conversations. It can evaluate project skills alone or project and global skills together. Everything runs locally. Never upload transcripts, session files, or any excerpt of them anywhere. The only shareable artifact is the report the user chooses to post. Let SKILLROOT be the directory containing this SKILL.md. Step 0: Start the run Verify the executing harness Read $SKILLROOT/references/supported-harnesses.md and identify the harness executing this skill from the runtime context. If it is unsupported or cannot be identified confidently, follow the reference's stop behavior. Do not create a report directory or read conversation history. Ask which conversations to grade First check whether the current directory is inside a git repository: Use the harness's user-question tool when available. When a current repository is available, ask “Which conversations should I grade?” with: 1. Conversations in this repository — recommended. 2. All conversations. 3. Choose projects to analyze. When there is no current repository, ask the same question with: 1. All conversations — recommended. 2. Choose projects to analyze. If the user chooses projects, ask for one or more project paths. Expand and validate every path as a git repository before continuing. The run produces one combined report across those projects. Ask which skills to evaluate Then ask “Which skills should I evaluate?” with: 1. Project skills + global skills — recommended. 2. Project skills only. For an all-conversations run, “Project skills” means skills from local git repositories inferred from the conversations' working directories. After these answers, proceed immediately. Never write artifacts into the user's repo. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills warpdotdev/skill-doctor