AI 코딩 에이전트에 검증된 스킬을 안전하게 설치하는 방법
Claude Code나 Cursor 같은 AI 코딩 도구를 쓰다 보면 에이전트가 새로운 작업을 수행하도록 지시하는 '스킬'을 추가하고 싶을 때가 있습니다. 하지만 공개 마켓플레이스의 스킬 중 상당수가 보안 문제를 안고 있어 안심하고 쓰기 어렵습니다. 이 저장소는 그런 위험을 줄이기 위해 보안 검사를 마친 스킬만 모아둔 목록입니다. 필요한 기능을 골라 설치하면, 에이전트가 해당 작업을 수행할 때 필요한 지침과 자료를 자동으로 불러오게 됩니다.
보안 검증을 거친 스킬만 담는 이유
공개된 AI 스킬 마켓플레이스에서는 전체 스킬의 13.4%에 치명적인 보안 문제가 발견된다는 통계를 인용하며, 이 저장소가 왜 필요한지 설명합니다. 모든 스킬은 공개 소스이며 바이너리 파일이 포함되지 않습니다. CI/CD 파이프라인에서 정적 분석을 거치고, 파일 무결성을 해시 값으로 확인합니다. 또한 Snyk Agent Scan을 통해 배포 전 스캔을 수행하며, CLI 도구 자체도 경로 격리와 심볼릭 링크 가드 등 다층적인 보안 조치를 적용합니다.
지원하는 AI 코딩 에이전트
이 저장소는 다양한 AI 코딩 에이전트와 호환되도록 설계되었습니다. Claude Code, Cursor, GitHub Copilot, Windsurf 등 널리 쓰이는 도구부터 Aider, Antigravity, Amazon Q, Gemini CLI, Kiro, OpenAI Codex, Roo Code, TRAE, Tabnine, Sourcegraph Cody, Augment, Droid, OpenCode까지 폭넓게 지원합니다. 특정 에이전트가 목록에 없다면 이슈를 열어 추가 요청을 할 수 있습니다.
대표적인 스킬 예시
현재 카탈로그에는 개발, 클라우드, 자동화, 디자인, 보안 등 다양한 카테고리의 스킬이 포함되어 있습니다. 예를 들어 'tlc-spec-driven'은 프로젝트를 계획하고 설계하며 태스크를 나누는 4단계 워크플로우를 제공합니다. 'aws-advisor'는 AWS 아키텍처 설계와 보안 검토를 돕고, 'playwright-skill'은 브라우저 자동화 테스트를 수행합니다. 'figma' 스킬은 Figma 디자인을 코드 변환으로 연결하며, 'security-best-practices'는 언어별 보안 취약점을 찾아 수정을 제안합니다.
설치와 관리 방법
설치는 npx @tech-leads-club/agent-skills 명령어로 시작하는 인터랙티브 마법사 형태로 진행됩니다. 원하는 스킬을 선택하고 대상 에이전트를 지정하며, 복사 또는 심볼릭 링크 방식으로 설치 범위를 결정합니다. 다운로드된 스킬은 ~/.cache/agent-skills/에 캐시되어 오프라인에서도 사용할 수 있으며, agent-skills audit 명령어로 설치 이력을 추적할 수 있습니다.
사용 전 확인 사항
이 저장소는 MIT 라이선스(소프트웨어 엔진)와 CC-BY-4.0(스킬 파일)을 적용하며, 제3자 스킬은 원본 라이선스를 따릅니다. 카탈로그를 사용할 경우 Tech Leads Club에 출처를 명시해야 합니다. MCP 서버를 통해 에이전트가 스킬 카탈로그를 직접 검색하고 필요한 파일만 가져오는 방식도 지원하므로, MCP 호환 클라이언트를 사용하는 경우 해당 설정을 참고해야 합니다. 보안이 최우선인 환경에서 AI 에이전트의 기능을 확장하고 싶다면, 이 저장소의 검증 과정을 신뢰할 수 있는지 SECURITY.md 문서를 추가로 검토하는 것이 좋습니다.
