Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
본 문서는 AI 에이전트(Claude Code, Codex, Cursor 등)의 개발 워크플로우를 강화하는 'ai-agent-plugins' 플러그인 모음을 소개합니다. 이 플러그인은 Git 초기화, 코드 감사(접근성, SEO), 프로젝트 검증 등 다양한 기능을 자동화하여 개발 효율성을 높여줍니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Claude Ecosystem의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기Git 및 프로젝트 워크플로우, 코드 감사(code audits), 릴리스 체크를 위한 플러그인입니다. 총 13개의 플러그인이 Claude Code에서 실행되며, 그중 8개는 Codex와 Cursor에서도 실행됩니다. 각 플러그인은 자체 명령어를 추가하므로 필요한 것만 설치하세요.
claude-code-plugins-dev에서 오셨나요? 버전 3.0.0이 리포지토리와 마켓플레이스 이름을 변경했습니다. 현재 설치된 것은 계속 작동합니다. 새로운 이름으로 전환하려면 Moving from claude-code-plugins-dev를 참조하세요.
각 스킬은 Claude Code와 Cursor에서 /git-init과 같이 이름으로 실행하는 명령어입니다. 대화형(Interactive) 스킬은 필요한 내용을 질문하며, 나머지는 코드베이스에 직접 실행됩니다. 일부는 /seo-fix --dry-run 및 /swift-verify --fix와 같은 플래그(flag)를 사용합니다. 각 플러그인의 README를 참조하세요.
| Plugin | What it does | Commands | Runs in |
|---|---|---|---|
| ai-accessibility | 코드에 대한 WCAG 감사 또는 Playwright MCP를 통한 실시간 URL 감사를 수행합니다. | /accessibility-audit | Claude Code, Codex, Cursor |
| ... |
Claude Code 전용 플러그인은 Claude Code 서브 에이전트(subagents), 설정 파일, 규칙, 상태 표시줄 또는 CLAUDE.md에 의존합니다.
감사 스킬은 설정을 인자(arguments)로 받기 때문에 예약되거나 비동기적으로 실행되어도 멈춰서 질문하지 않습니다. 예를 들어, /accessibility-audit 2.2 AA src/, /modernize-audit src --defaults, /seo-audit geo 또는 /swift-preflight --check-only가 있습니다. Claude Code에서는 /security-audit가 병렬 security-auditor 서브 에이전트 간에 검토를 분할할 수도 있습니다.
감사 플러그인 참고 사항: 감사 플러그인은 코드를 읽고 발견한 내용을 보고하며, 일부는 실시간 URL도 확인할 수 있습니다. 개발 중에 문제를 포착하는 데 사용하고, 런타임 테스트 및 수동 검토를 통해 확인하세요.
[클로드 코드 설치]를 한 후 마켓플레이스를 추가하고 원하는 플러그인을 설치합니다:
/plugin marketplace add charlesjones-dev/ai-agent-plugins
/plugin install <플러그인 이름>@ai-agent-plugins
...
그런 다음 플러그인의 명령 중 아무거나 실행합니다:
/git-init # 프로젝트용 .gitignore 생성
/security-init # 비밀 정보에 대한 파일 접근 거부 규칙 추가
/ado-init # Azure DevOps 및 MCP 서버 설정
codex plugin marketplace add charlesjones-dev/ai-agent-plugins
codex plugin add <플러그인 이름>@ai-agent-plugins
...
Codex는 표에서 Codex로 표시된 플러그인만 나열하며, 각 스킬은 ai-git:git-init과 같이 플러그인 이름을 접두사로 붙입니다. 설치 후 새 세션을 시작하고, 스킬을 선택하려면 $를 입력하거나 /skills를 엽니다. Codex는 사용자가 직접 선택할 때만 스킬을 실행하며, 예외는 세 가지가 있습니다. 사이트나 README 파일이 AI 작성물처럼 보이는지 여부를 물어볼 때는 슬롭 감사(slop audit)를 시작할 수 있고, 코드 주석을 정리하거나 청소해달라고 요청할 때는 주석 검토(comment review)를 할 수 있으며, 커밋 전에 코드를 확인하도록 요청할 때는 Git 사전 점검(git preflight checks)을 수행합니다. 플러그인은 Codex IDE 확장 프로그램에 로드되지 않으므로, Codex CLI 또는 ChatGPT 데스크톱 앱을 사용해야 합니다.
Cursor는 Teams 및 Enterprise 요금제에서 팀 마켓플레이스(team marketplaces)를 통해 플러그인을 설치합니다. 관리자는 https://github.com/charlesjones-dev/ai-agent-plugins를 사용하여 대시보드 > 플러그인 및 MCPs > 팀 마켓플레이스 > 마켓플레이스 추가 > 레포에서 가져오기 경로에 이 저장소를 추가합니다. Cursor는 표에서 Cursor로 표시된 플러그인만 나열합니다.
하나의 장치에서만 특정 플러그인을 사용하려면, 해당 폴더를 ~/.cursor/plugins/local/로 복사합니다. 예를 들어, plugins/ai-git을 ~/.cursor/plugins/local/ai-git으로 복사한 다음 개발자: 창 다시 로드를 실행합니다. Teams 및 Enterprise 요금제에서는 관리자가 **로컬 플러그인 가져오기 허용(Allow Local Plugin Imports)**을 활성화해야만 로컬 플러그인이 로드되며, 이 기능은 Enterprise에서 기본적으로 비활성화되어 있습니다. /와 스킬 이름을 사용하여 스킬을 실행합니다.
Codex와 Cursor에서 실행되는 플러그인은 Agent Plugins 1.0 형식을 따르며, 각 플러그인 폴더의 루트에 plugin.json 파일이 있습니다. 이 표준을 지원하는 다른 에이전트들은 plugins/<플러그인 이름>에서 이를 로드할 수 있습니다.
버전 3.0.0에서 저장소 이름이 claude-code-plugins-dev에서 ai-agent-plugins로 변경되었고, 마켓플레이스도 이에 맞춰 변경되었습니다. GitHub가 이전 URL을 리디렉션하므로 기존 설치 및 링크는 계속 작동합니다.
Claude Code는 플러그인을 이전 마켓플레이스 이름으로 유지하므로, @ai-agent-plugins를 사용하는 명령어로는 이를 찾을 수 없습니다. 전환하려면:
/plugin marketplace remove claude-code-plugins-dev
/plugin marketplace add charlesjones-dev/ai-agent-plugins
/plugin install <플러그인 이름>@ai-agent-plugins
이전 마켓플레이스를 제거하면 해당 플러그인들이 모두 제거되므로, 사용하는 플러그인은 다시 설치해야 합니다.
네 개의 플러그인이 다른 플러그인에 병합되었습니다. Claude Code는 기존 설치의 설정을 대체된 플러그인으로 전환하지만, 해당 플러그인은 여전히 한 번 설치해야 합니다:
| 이전 플러그인 | 현재 포함됨 | 단 1회 실행 |
|---|---|---|
| ai-writing | ai-slop | /plugin install ai-slop@ai-agent-plugins |
| ... |
이 명령어들은 이름이 변경되었거나 다른 명령어로 병합되었습니다:
| 이전 명령어 | 새 명령어 |
|---|---|
/writing-humanize | /slop-rewrite |
| ... |
ai-knowledge 2.0은 지식 기반(knowledge base)이 위치하는 곳도 변경합니다. ai-knowledge 1.x의 지식 기반를 참조하십시오.
만약 /workflow-ship 또는 /workflow-preflight를 사용했다면, ai-git을 설치하십시오. 이 마켓플레이스에서 대체재 없이 제거된 명령어는 Deprecated & Removed에 나열되어 있습니다.
3.0.0 버전에서는 accessibility-auditor, modernize-auditor, performance-auditor, security-dependency-scanner, 그리고 swift-release-auditor 하위 에이전트가 제거되었습니다. 이들은 감싸고 있던 스킬(skills)을 로드할 수 없었기 때문입니다. 대신, /performance-audit 또는 /swift-preflight --check-only와 같이 인자(arguments)를 사용하여 일치하는 스킬을 실행하십시오.
Codex에서는 codex plugin marketplace remove claude-code-plugins-dev를 실행한 다음 Codex 단계를 따르십시오.
ai-knowledge 2.0은 지식 기반을 CLAUDE.md 내의 테이블 대신 Claude Code 규칙으로 저장합니다. 따라서 Claude Code는 각 아티클을 적절한 시점에 스스로 로드합니다.
1.x 버전에서는 아티클이 docs/kb/에 존재했으며, CLAUDE.md의 테이블은 Claude에게 언제 어떤 아티클을 읽어야 하는지 알려주었습니다. 이 테이블은 모든 세션에서 로드되었고, 아티클은 오직 Claude가 테이블을 읽고, 행과 일치하는 것을 찾아 파일을 열기로 선택했을 때만 Claude에게 도달했습니다. 반면, Claude Code는 파일들을 .claude/rules/에 자체적으로 로드합니다:
paths 프런트매터(frontmatter)와 함께 .claude/rules/kb/에 존재하며, 예시로 src/api/**가 있습니다. Claude Code는 Claude가 일치하는 파일을 읽거나, 쓰거나, 편집할 때 하나를 로드하며, 해당 파일들을 전혀 건드리지 않는 세션에서는 그 내용으로 인해 컨텍스트(context)를 소비하지 않습니다.paths 없이 .claude/rules/kb/에 존재하며, 이전과 마찬가지로 모든 세션 시작 시 로드됩니다..claude/kb/에 존재하며, 각각 .claude/rules/kb/_index.md의 한 줄로 구성되어 모든 세션에서 로드됩니다. 그리고 작업이 해당 라인과 일치할 때 Claude가 아티클을 여는 방식입니다. 이는 1.x 테이블 전체가 의존했던 유일한 부분입니다.또한, _index.md에는 키워기와 함께 각 범위 지정된 아티클 목록도 포함되어 있어, Claude가 관련 파일을 건드리기 전에 주제가 언급될 때 하나를 읽을 수 있도록 합니다. 범위 지정되거나 온디맨드 아티클이 로드되면, Claude는 📖 Loaded KB: conventions/api.md와 같이 한 줄로 이를 알려줍니다.
Claude Code가 자체적으로 “.claude/rules/”를 읽기 때문에, 팀원들은 플러그인을 설치할 필요 없이 git에서 지식 기반(knowledge base)을 얻게 되며, CLAUDE.md에는 더 이상 표가 포함되지 않습니다. 이 플러그인은 아티클을 캡처(capture), 추가(add), 조회(query), 정리(prune), 마이그레이션(migrate)하는 데 사용됩니다.
아티클은 자신들을 가리키는 짧은 규칙 파일 뒤에 “docs/kb/”에 머무를 수 없습니다. Claude Code는 세션 시작 시, 해당 규칙의 paths가 일치하지 않더라도 규칙 내부의 “@” 임포트를 확장하므로, 모든 아티클이 매번 로드됩니다.
1.x 버전에서는 학습 내용을 캡처하도록 상기시키는 “/kb-auto”가 있었습니다. 2.0 버전에서는 이를 자동 캡처(auto-capture)로 대체했습니다. 이 기능을 켜면, 팀이 알아야 할 수정 사항, 규칙 및 결정 사항을 사용자가 “/kb-learn”를 실행하지 않아도 Claude가 자동으로 저장하며, 무엇을 저장했는지 한 줄로 알려주어 되돌릴 수 있게 합니다. “/kb-init”와 “/kb-migrate”는 auto=off를 지정하지 않는 한 이 기능을 활성화합니다. 이는 개발자별로 설정되므로 팀원들에게 아무런 변화가 없으며, Claude Code의 자동 메모리 기능이 켜져 있든 꺼져 있든 작동합니다. 작성되는 모든 내용은 다른 사람에게 도달하기 전에 diff에서 표시됩니다.
Codex와 Cursor는 “.claude/rules/”를 로드하지 않으므로, “/kb-init”와 “/kb-migrate” 또한 해당 에이전트들에게 지식 기반을 읽는 방법을 알려주는 짧은 섹션을 AGENTS.md에 추가합니다 (“agents=off”로 건너뛸 수 있음). 이들은 내용을 읽을 수는 있지만, 추가할 수는 없습니다: “/kb-” 명령어와 자동 캡처는 Claude Code에서만 실행됩니다.
사용자에게 두 가지 변화가 있습니다:
1.x 지식 기반을 가진 각 프로젝트에서 /kb-migrate를 한 번 실행하거나, 먼저 미리 보기를 하려면 /kb-migrate --dry-run을 사용하세요. 이 명령어는 각 아티클을 테이블 행과 프론트매터(frontmatter)로부터 스코프 지정(scoped), 고정(pinned), 또는 온디맨드(on-demand)로 분류하고, git mv를 사용하여 히스토리가 유지되도록 이동시키며, 각 행의 키워드를 태그에 보존하고, 링크를 일반 경로(plain paths)로 변환하며, CLAUDE.md 테이블과 /kb-auto 블록 및 docs/kb/.obsidian/ 디렉터리를 제거합니다. 마지막으로 auto=off를 지정하지 않는 한 자동 캡처(auto-capture) 기능을 활성화해줍니다. 또한 지식 기반, CLAUDE.md, AGENTS.md, 그리고 docs/ 내에서 여전히 이름이 변경되거나 삭제된 명령어(예: /writing-humanize 또는 /geo-audit)를 사용하는 노트를 찾아내고 수정 방안을 제안합니다. 새로운 내용을 포착하려면 나중에 다시 실행하세요. 자세한 내용은 ai-knowledge README을 참조하십시오.
Claude Code가 이제 네이티브로 지원하거나 다른 플러그인으로 이동한 플러그인 및 스킬은 여기서 폐기되었습니다. 제거된 플러그인과 스킬은 git 히스토리에 남아 있습니다.
| 항목 | 상태 | 대체됨 (Superseded by) | 세부 정보 |
|---|---|---|---|
ai-writing (/writing-humanize) | 🗑️ 제거됨 (2026년 10월, v3.0.0) | ai-slop /slop-rewrite | 동일한 재작성 기능이며, 이제 /slop-audit와 하나의 신호 목록을 공유하고, 붙여넣은 텍스트 또는 파일 경로를 인수로 받습니다 |
| ... |
여러 ai-workflow 스킬과 ai-git의 /git-commit-push-pr에 있는 PR 가이드는 tstack에서 각색되었으며, Theo Browne가 Claude Code와 Codex를 위해 만든 에이전트 스킬을 사용합니다. 이 중 일부는 T3 Code 기능을 활용합니다. tstack은 MIT 라이선스를 따릅니다. 이를 사용하는 각 플러그인은 라이선스와 각색된 파일 목록이 담긴 THIRD-PARTY-NOTICES.md를 배포합니다: ai-workflow 및 ai-git.
버그 보고와 수정 사항을 환영합니다. CONTRIBUTING.md를 참조하십시오.
MIT License. LICENSE를 참조하십시오.
Charles Jones