Agent 스킬

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

스킬은 Agent에게 새로운 능력을 가르칩니다. 전문 지식, 선호하는 패턴, 특화된 지식을 Agent와 공유해 더 나은 일관된 결과를 얻을 수 있습니다.

​

스킬이 중요한 이유

Agent로 빌드할 때마다 유용한 컨텍스트가 생깁니다: 문제 해결책, 디자인 결정, 프레임워크 선호도. 하지만 채팅이 끝나면 그 컨텍스트는 사라집니다. 스킬은 이를 보존합니다. GSAP 애니메이션 스킬은 Agent가 특정 라이브러리를 올바르게 사용하는 방법을 가르칩니다. 디자인 시스템 스킬은 정확한 색상과 간격 규칙을 적용하도록 합니다. 버그 수정 스킬은 Agent가 같은 실수를 반복하지 않도록 해결책을 포착합니다. 이전에는 일관성이 없었던 작업이 신뢰할 수 있게 됩니다. 스킬은 또한 오픈 표준입니다. Replit Agent를 포함한 모든 에이전트와 함께 작동하므로 도구 간에 이동할 수 있습니다.

​

능동적 스킬 vs 반응적 스킬

스킬을 언제 어떻게 만들지에 대한 사고 프레임워크입니다. 두 패턴을 모두 이해하면 더 효과적으로 활용할 수 있습니다.

​

능동적 스킬

능동적 스킬은 빌드를 시작하기 전에 추가하는 스킬입니다. 사용하려는 라이브러리나 패턴을 조사하고, 스킬을 찾거나 만들고, 프롬프트를 시작하세요. 예시: 손으로 그린 SVG 애니메이션이 있는 포트폴리오 사이트를 빌드하기 전에 애니메이션 라이브러리를 조사하고 GSAP를 찾습니다. GSAP React 스킬을 설치한 후 Agent에게 애니메이션 빌드를 요청합니다. Agent는 처음부터 필요한 특화된 지식을 갖습니다 — 라이브러리의 API, 모범 사례, 일반 패턴을 이해합니다. 스킬 없이는 일반적이거나 잘못된 결과물을 만들 수 있습니다. 이 패턴은 다음과 같은 경우에 잘 작동합니다:

• Agent가 혼자서는 완벽하게 처리하지 못할 수 있는 미묘한 패턴이 있는 인기 라이브러리를 사용할 때
• 프로젝트 전반에 걸쳐 일관된 디자인 선택(타이포그래피, 간격, 애니메이션 스타일)을 원할 때
• 프로젝트를 시작하면서 이미 기술적 방향을 알고 있을 때

​

반응적 스킬

반응적 스킬은 문제를 해결한 후에 만드는 스킬입니다. 문제를 발견하고, Agent와 함께 디버깅하고, 수정한 후, 같은 일이 반복되지 않도록 해결책을 포착합니다. 예시: 모바일 앱용 캔버스를 빌드하면서 확대 시 이미지 가장자리가 울퉁불퉁해지는 것을 발견합니다. Agent와 함께 디버깅하면 이것이 미니피케이션 앨리어싱 — 이미지가 축소될수록 오히려 더 나빠지는 렌더링 문제 — 임을 알게 됩니다. 수정을 구현한 후 Agent에게 스킬을 만들어달라고 요청합니다: Agent는 대화 기록을 사용해 프로젝트별 스킬을 작성합니다. 다음에 이 문제가 발생하면 처음부터 디버깅하는 대신 스킬을 참조하면 됩니다. 이 패턴은 다음과 같은 경우에 잘 작동합니다:

• 명확하지 않은 버그를 수정하고 재발을 방지하고 싶을 때
• 디버깅 세션 중에 앱 아키텍처에 대해 무언가를 배웠을 때
• 발견하는 데 상당한 노력이 필요한 해결책을 저장하고 싶을 때

​

스킬 선별하기

스킬을 친구에게 아파트를 찾아오는 길 안내하는 것처럼 생각하세요. 목표 지향적인 지시 목록은 효과적입니다. 문서 바인더는 그렇지 않습니다 — 아무도 그걸 읽을 시간이 없고, 중요한 세부 정보가 묻혀버립니다. Agent도 마찬가지입니다. 너무 많은 스킬을 추가하면 Agent가 혼란스러울 수 있습니다. 특정 프로젝트에 어떤 스킬을 활성화할지 신중하게 결정하고, 더 이상 필요하지 않은 스킬은 제거하세요.

​

보안 고려 사항

Replit 스킬 패널의 스킬은 안전성 검토를 거쳤습니다. 하지만 스킬은 어디서든 설치할 수 있습니다 — 누구나 기여할 수 있는 오픈 소스 저장소에서 제공됩니다. 스킬은 Agent가 따르는 지시 사항이기 때문에, 악의적인 스킬은 Agent에게 프로젝트의 민감한 데이터를 유출하도록 지시할 수 있습니다. 외부 소스에서 스킬을 설치하기 전에:

1. 파일을 여세요. 스킬은 마크다운입니다. 사용하기 전에 /.agents/skills/에서 내용을 읽어보세요.
2. 출처를 확인하세요. 신뢰할 수 있는 저장소나 작성자에게서 온 스킬인지 확인하세요.
3. 지시 내용을 검토하세요. 스킬이 의심스러운 외부 URL을 참조하거나 민감한 정보를 요청하지 않는지 확인하세요.

​

스킬 vs MCP 서버

스킬과 MCP 서버는 에이전트를 확장하는 두 가지 주요 방법이며, 서로 다른 목적을 가집니다. 스킬은 컨텍스트 효율적입니다. 스킬이 호출될 때까지 간략한 설명만 로드됩니다. 다음에 스킬을 사용하세요:

• 워크플로우와 관례 (“배포 방법”, “코드 리뷰 체크리스트”)
• 참고 자료 (API 패턴, 스타일 가이드, 디자인 시스템)
• 재사용 가능한 프롬프트와 특화된 지식 (애니메이션 라이브러리, 프레임워크 패턴)

MCP 서버는 컨텍스트 집약적입니다. 모든 도구 설명이 초기에 로드되어 너무 많이 추가하면 출력 품질이 저하될 수 있습니다. 다음에 MCP 서버를 사용하세요:

• 외부 서비스 연결 (Notion, Linear, Figma)
• API 접근이 필요한 액션
• 단순 지시가 아닌 실제 작업을 수행하는 도구

핵심 차이: 스킬은 에이전트가 어떻게 작업해야 하는지를 정의합니다. MCP 서버는 에이전트가 무엇에 접근할 수 있는지를 정의합니다. 둘 다 Replit Agent와 직접 빌드하는 에이전트에서 작동합니다.

​

다음 단계