Community생산성 & 협업github.com

에이전트 닥터

프로젝트에서 발견된 에이전트 지침(AGENTS.md, CLAUDE.md, GEMINI.md)과 스킬 정의를 검사하여 정적 연결 문제를 보고하고, 로컬 세션 로그에서 거의 또는 전혀 호출되지 않는 설치된 스킬을 파악합니다. "스킬이 로딩되지 않는 이유", "에이전트 설정 확인", "스킬 발견 진단", "AGENTS.md 및 스킬 감사", "사용하지 않는 스킬" 같은 질문에 사용하세요.

에이전트 닥터란 무엇인가요?

이 에이전트 닥터 스킬은 개발자와 AI 에이전트 사용자가 에이전트 설정 문제를 진단하고 스킬 발견 문제를 해결하는 데 도움을 줍니다. 실제 파일 시스템에서 발견된 AGENTS.md, CLAUDE.md, GEMINI.md 같은 에이전트 지침 파일과 스킬 정의를 읽기 전용으로 스캔하여 정적 연결 오류를 보고하며, 스킬을 로드하거나 변경하거나 활성화하지 않습니다. Claude Code, Cursor, Codex, Gemini, GitHub Copilot, Windsurf, Cline, Devin 등 주요 AI 에이전트 플랫폼에서 사용되는 표준 스킬 폴더 구조(예: `.claude`, `.cursor`, `.codex`, `.gemini`, `.github`, `.cline` 등)를 모두 인식하고, 심볼릭 링크 탈출과 중복 보고를 방지합니다. 또한 `--usage` 플래그를 통해 로컬 세션 로그를 분석하여 거의 또는 전혀 호출되지 않는 스킬을 식별하고, 스킬 보관(archive) 워크플로우를 제공합니다. 모든 작업은 읽기 전용이며 파일을 수정하지 않습니다.

지원 대상✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI✓OpenCode✓Windsurf
npx skills add https://github.com/evemcgivern/agent-skills/tree/HEAD/plugins/agent-workflow/skills/agent-doctor

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

에이전트 닥터은(는) 무엇을 하나요?

이 스킬을 사용하여 에이전트 지침과 스킬 발견 진단을 실제로 존재하는 파일에 근거하여 수행하세요. 보고서는 소스를 발견된 것으로 표시하며, 런타임에 로드되었거나 사용 가능하도록 구성된 것으로 표시하지 않습니다.

먼저 결정론적 스캔을 실행한 다음, 보고서와 보고서가 명명한 파일만을 바탕으로 추론하세요. 스캔은 읽기 전용이며 파일을 수정하거나, 스킬을 로드하거나, 권한을 요청하거나, 일반 홈, 환경, 자격 증명 또는 인증 파일을 읽지 않습니다.

이 스킬의 설치 디렉터리에서 다음을 실행하세요:

python3 scripts/agent_doctor.py --project <프로젝트-경로> --format markdown

Fixture 또는 대체 전역 발견을 위해 --home /fixture/home을 사용하세요. 추가로 허용된 스킬 루트에 대해서만 명시적으로 --skill-root /path/to/skills를 추가하세요. --model <이름>은 실행 중인 모델(예: Claude, claude-opus-5-5, GPT-5 등 리터럴 이름)을 받아 일반 스킬 문구의 리터럴 "You are " 식별 주장과 비교하며, 대소문자, 하이픈 대 공백/점, 선행 claude-를 무시하고 불일치를 권고 사항으로만 보고합니다. 생략하면 해당 검사를 건너뜁니다. 기계 판독 가능 출력을 위해 --format json을 선택하세요. 집중된 진단을 위해 --max-files, --max-bytes, --max-directories를 사용하여 경계가 지정된 스캔 범위를 좁힐 수 있습니다.

스캔은 깊이, 디렉터리, 파일 및 바이트를 제한하며, 종속성, VCS, 캐시 및 작업 트리 디렉터리를 건너뜁니다. 상위 및 중첩된 AGENTS.md/CLAUDE.md/GEMINI.md, 허용 목록에 포함된 전역 지침 파일 (~/.codex/AGENTS.md, ~/.claude/CLAUDE.md, ~/.gemini/GEMINI.md), 그리고 모든 문서화된 호스트 폴더의 평면 스킬 폴더(홈: .agents, .codex, .claude, .gemini, .cursor, .copilot 및 .codeium/windsurf 스킬, 프로젝트: .agents, .codex, .claude, .gemini, .cursor, .github, .opencode, .cline, .clinerules, .devin 및 .windsurf 스킬)를 인식합니다. 여러 폴더(예: Skills CLI의 심볼릭 링크)를 통해 도달한 스킬은 한 번만 보고됩니다. 정규 경로와 별칭을 분리하고, 심볼릭 링크 탈출을 거부하며, 원시 파일 내용을 내보내지 않습니다.

스킬 사용 및 보관

거의 또는 전혀 호출되지 않는 스킬의 경우 python3 scripts/agent_doctor.py --usage를 실행하고 references/usage.md를 참조하세요. 세션 로그를 읽기 전용으로 읽고 스킬 이름과 횟수만 출력합니다. 소유자에게 표를 보여준 다음, 스킬별로 업데이트, 유지 또는 보관을 물어보세요. "로그에서 호출을 찾을 수 없음"이라고 말하고, "사용되지 않음"이라고 말하지 마세요. scripts/skill_archive.py로만 보관하세요: plan을 실행하고, 보여주고, 해당 스킬에 대해 명시적인 동의를 받은 다음 archive --yes를 실행하세요. 질문과 같은 턴에 실행하지 마세요. restore를 언급하세요.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

evemcgivern/agent-skills

Reconsiders a project or shelved idea against current capabilities, proposes three ambitious outcomes, and designs an experiment for the hardest uncertainty. Use when asked "what more is now feasible", "is this worth attempting now", "revisit this shelved idea", or "think bigger about this project".

evemcgivern/agent-skills

Review an external PDF, image, screenshot, article, or URL against a repository's current issues and code to sort its ideas into new, already tracked, shipped, contradicted, or unverifiable, read-only by default. Use when the user asks to '/check-worth' or '$check-worth' a source, or asks whether an external idea is worth pulling into a repository as an issue or code change.

evemcgivern/agent-skills

Routes each task to a suitable model tier in Claude Code, Codex, or another agent that can start subagents on a chosen model (for example Gemini CLI or Antigravity CLI), following the user's routing preferences. Keeps small tasks local, delegates discovery, routine coding, and testing to cheaper subagents, and sends difficult decisions and risky reviews to a stronger one. Use when deciding whether to delegate, writing subagent handoffs, or setting routing preferences, or when asked to "save tokens", "use cheaper models", "fan out subagents", "stay inside my quota", or "efficient-frontier-routing help".

evemcgivern/agent-skills

Makes the most expensive model in a session the senior decision-maker, keeping its reasoning for intent, architecture, decomposition, tradeoffs, final review, and synthesis while cheaper agents handle discovery, implementation, tests, logs, and verification. Use when the active agent is Fable or another top-tier model, or when asked to "act as chief agent", "delegate the grunt work", or "save the expensive model for decisions".

관련 스킬