스킬이 중요한 이유
Agent로 빌드할 때마다 유용한 컨텍스트가 생깁니다: 문제 해결책, 디자인 결정, 프레임워크 선호도. 하지만 채팅이 끝나면 그 컨텍스트는 사라집니다. 스킬은 이를 보존합니다. GSAP 애니메이션 스킬은 Agent가 특정 라이브러리를 올바르게 사용하는 방법을 가르칩니다. 디자인 시스템 스킬은 정확한 색상과 간격 규칙을 적용하도록 합니다. 버그 수정 스킬은 Agent가 같은 실수를 반복하지 않도록 해결책을 포착합니다. 이전에는 일관성이 없었던 작업이 신뢰할 수 있게 됩니다. 스킬은 또한 오픈 표준입니다. Replit Agent를 포함한 모든 에이전트와 함께 작동하므로 도구 간에 이동할 수 있습니다.능동적 스킬 vs 반응적 스킬
스킬을 언제 어떻게 만들지에 대한 사고 프레임워크입니다. 두 패턴을 모두 이해하면 더 효과적으로 활용할 수 있습니다.능동적 스킬
능동적 스킬은 빌드를 시작하기 전에 추가하는 스킬입니다. 사용하려는 라이브러리나 패턴을 조사하고, 스킬을 찾거나 만들고, 프롬프트를 시작하세요. 예시: 손으로 그린 SVG 애니메이션이 있는 포트폴리오 사이트를 빌드하기 전에 애니메이션 라이브러리를 조사하고 GSAP를 찾습니다. GSAP React 스킬을 설치한 후 Agent에게 애니메이션 빌드를 요청합니다. Agent는 처음부터 필요한 특화된 지식을 갖습니다 — 라이브러리의 API, 모범 사례, 일반 패턴을 이해합니다. 스킬 없이는 일반적이거나 잘못된 결과물을 만들 수 있습니다. 이 패턴은 다음과 같은 경우에 잘 작동합니다:- Agent가 혼자서는 완벽하게 처리하지 못할 수 있는 미묘한 패턴이 있는 인기 라이브러리를 사용할 때
- 프로젝트 전반에 걸쳐 일관된 디자인 선택(타이포그래피, 간격, 애니메이션 스타일)을 원할 때
- 프로젝트를 시작하면서 이미 기술적 방향을 알고 있을 때
반응적 스킬
반응적 스킬은 문제를 해결한 후에 만드는 스킬입니다. 문제를 발견하고, Agent와 함께 디버깅하고, 수정한 후, 같은 일이 반복되지 않도록 해결책을 포착합니다. 예시: 모바일 앱용 캔버스를 빌드하면서 확대 시 이미지 가장자리가 울퉁불퉁해지는 것을 발견합니다. Agent와 함께 디버깅하면 이것이 미니피케이션 앨리어싱 — 이미지가 축소될수록 오히려 더 나빠지는 렌더링 문제 — 임을 알게 됩니다. 수정을 구현한 후 Agent에게 스킬을 만들어달라고 요청합니다: Agent는 대화 기록을 사용해 프로젝트별 스킬을 작성합니다. 다음에 이 문제가 발생하면 처음부터 디버깅하는 대신 스킬을 참조하면 됩니다. 이 패턴은 다음과 같은 경우에 잘 작동합니다:- 명확하지 않은 버그를 수정하고 재발을 방지하고 싶을 때
- 디버깅 세션 중에 앱 아키텍처에 대해 무언가를 배웠을 때
- 발견하는 데 상당한 노력이 필요한 해결책을 저장하고 싶을 때
스킬 선별하기
스킬을 친구에게 아파트를 찾아오는 길 안내하는 것처럼 생각하세요. 목표 지향적인 지시 목록은 효과적입니다. 문서 바인더는 그렇지 않습니다 — 아무도 그걸 읽을 시간이 없고, 중요한 세부 정보가 묻혀버립니다. Agent도 마찬가지입니다. 너무 많은 스킬을 추가하면 Agent가 혼란스러울 수 있습니다. 특정 프로젝트에 어떤 스킬을 활성화할지 신중하게 결정하고, 더 이상 필요하지 않은 스킬은 제거하세요.스킬은 일반적인 지침보다 구체적이고 반복 가능한 패턴을 포착할 때 가장 효과적입니다. 구체적인 워크플로우, 확립된 관례, 검증된 해결책에 집중하세요.
스킬을 잘 작성하기
스킬은 복잡하고 정교할 수 있습니다. 몇 가지 원칙으로 스킬의 효과를 유지할 수 있습니다:- 올바른 방법을 설명하세요. Agent에게 올바르게 수행하는 방법을 알려주세요. 하지 말아야 할 것들을 나열하다 보면 전체 접근 방식을 재구성해야 한다는 신호입니다.
- 가능하면 스크립트를 사용하세요. 결정론적 스크립트는 Agent가 매번 같은 단계를 추론하도록 요청하는 것보다 더 신뢰할 수 있습니다.
- 링크를 사용하세요. 다른 Markdown 파일을 가리키도록 스킬을 구성하면 Agent가 현재 작업에 필요한 것만 가져옵니다.
- 정기적으로 벤치마크하세요. 스킬이 실제로 작동하는지 가정하는 대신 확인하는 방법입니다.
- 직접 작성하세요. 목표는 간결하고 의도적인 컨텍스트이며, 스킬을 직접 작성함으로써 달성됩니다. Agent가 초안을 잡는 데 도움을 줄 수 있지만, 모든 줄이 의미 있도록 직접 다듬으세요.
- 맞춤형으로 유지하세요. 코드 청결도나 보안을 위한 일반적인 스킬을 만들지 마세요 — 이미 Agent에 포함되어 있습니다. 스킬은 여러분 또는 조직에 특화된 것을 포착해야 합니다.
- 스킬이 발동되지 말아야 할 때 발동됩니다. 설명이 너무 광범위합니다. 범위를 좁히고 언제 사용하지 말아야 하는지 명시하세요 — “블로그 게시물이나 도움말 문서에는 해당 없음”이 긍정적인 지시보다 유용한 경우가 많습니다.
- 스킬이 발동되지만 출력이 잘못되었습니다. 지시가 너무 일반적입니다. “전문적으로 만들어”와 같은 모호한 지침을 정확한 이름, 구체적인 요구 사항, 피해야 할 명시적 사항으로 대체하세요.
- 두 스킬이 충돌합니다. 같은 작업에서 두 스킬이 모두 발동되지 않도록 설명을 수정하세요. 충돌은 거의 항상 지시 문제가 아닌 범위 문제입니다.
스킬을 워크스페이스 전체로 확장하기
지금까지의 모든 내용은 단일 프로젝트의 스킬에 적용됩니다. 팀에서는 전체 워크스페이스에 맞게 Agent를 사용자 정의할 수도 있어서, 모든 프로젝트에서 다시 설명할 필요 없이 같은 관례에서 시작할 수 있습니다. 워크스페이스 사용자 정의에는 두 가지 부분이 있습니다:- 커스텀 지침 — 누군가 프롬프트를 입력하기 전에 모든 프로젝트와 모든 메시지에서 Agent의 컨텍스트에 주입되는 항상 활성화된 규칙. “자격 증명을 일반 텍스트로 저장하지 마세요”와 같이 진정으로 보편적인 소수의 규칙을 위해 예약하세요. 매 턴에 로드되므로 모든 단어가 Agent의 컨텍스트 예산의 일부를 사용합니다 — 짧게 유지하세요.
- 워크스페이스 스킬 — 위에서 설명한 것과 동일한 스킬로, 워크스페이스의 모든 사람이 사용할 수 있으며 중앙에서 관리됩니다. 관련 작업이 호출할 때까지 거의 무료로 유지되므로 출력을 저하시키지 않고 많은 것을 제공할 수 있습니다.
보안 고려 사항
Replit 스킬 패널의 스킬은 안전성 검토를 거쳤습니다. 하지만 스킬은 어디서든 설치할 수 있습니다 — 누구나 기여할 수 있는 오픈 소스 저장소에서 제공됩니다. 스킬은 Agent가 따르는 지시 사항이기 때문에, 악의적인 스킬은 Agent에게 프로젝트의 민감한 데이터를 유출하도록 지시할 수 있습니다. 외부 소스에서 스킬을 설치하기 전에:- 파일을 여세요. 스킬은 마크다운입니다. 사용하기 전에
/.agents/skills/에서 내용을 읽어보세요. - 출처를 확인하세요. 신뢰할 수 있는 저장소나 작성자에게서 온 스킬인지 확인하세요.
- 지시 내용을 검토하세요. 스킬이 의심스러운 외부 URL을 참조하거나 민감한 정보를 요청하지 않는지 확인하세요.
스킬 vs MCP 서버
스킬과 MCP 서버는 에이전트를 확장하는 두 가지 주요 방법이며, 서로 다른 목적을 가집니다. 스킬은 컨텍스트 효율적입니다. 스킬이 호출될 때까지 간략한 설명만 로드됩니다. 다음에 스킬을 사용하세요:- 워크플로우와 관례 (“배포 방법”, “코드 리뷰 체크리스트”)
- 참고 자료 (API 패턴, 스타일 가이드, 디자인 시스템)
- 재사용 가능한 프롬프트와 특화된 지식 (애니메이션 라이브러리, 프레임워크 패턴)
- 외부 서비스 연결 (Notion, Linear, Figma)
- API 접근이 필요한 액션
- 단순 지시가 아닌 실제 작업을 수행하는 도구
다음 단계
Agent 커스터마이제이션
전체 팀을 위한 워크스페이스 전체 커스텀 지침 및 스킬을 설정하세요.
스킬 사용하기
메시지에 스킬을 첨부하거나, 프로젝트에 설치하거나, 스킬에서 새 프로젝트를 시작하세요.
Agent 스킬 참조
스킬 구조와 작동 방식에 대한 기술적 세부 정보.
Replit의 MCP 서버
Model Context Protocol을 통해 Agent를 외부 서비스와 도구에 연결하세요.
효과적인 프롬프트
Agent가 첫 번째 시도에서 더 가까운 결과를 얻을 수 있도록 더 명확한 지시를 작성하세요.