Ask HN: 기술 파일은 어떻게 관리하시나요?

Ask HN: How do you manage skills files?

▲ 307imadtaieber280 HN 토론

저는 스킬 파일을 어떻게 찾고, 정리하고, 실제로 작동하는지 확인하는 방법이 궁금합니다. 시간이 지나면서 스킬을 개선하고 있나요? 모델의 능력이 향상되면 결국 스킬이 대체될 것이라고 생각하지만, 그때까지는 더 나은 관리 방법을 찾고 있습니다.

모델의 능력은 커스텀 스킬이 가진 알 수 없는 빈칸을 채울 수 없습니다. 모델은 밥에게 연결하라는 요청을 받았을 때 whoami를 실행하고 .ssh 폴더에서 키와 과거 연결 기록을 찾는 영리함을 가질 수 있지만, 스킬 파일은 '키 Z와 사용자 X로 밥에게 연결한다'고 간단히 말할 수 있어 불필요한 추론 없이 작업을 완료할 수 있습니다. 내부 지식이 필요한 작업에서는 간결하고 정보 밀도가 높은 스킬이 항상 토큰 소비에서 우위를 점할 것입니다. 조사 단계를 완전히 없애기 때문입니다.
저는 '범용' 코딩 에이전트가 계속해서 발전하여 스킬의 유용성이 점점 줄어들 것이라고 생각합니다. 그리고 그 발전 속도는 스킬을 통해 맞춤화하는 것보다 훨씬 빠를 것입니다. 이는 제가 코드를 작성하면서 느낀 경험에서 나온 것으로, 에이전트는 이미 소프트웨어 엔지니어링 관례에 능숙합니다. 지금은 스킬을 최소한으로 유지합니다. 예를 들어 '이 저장소의 문서에서 슬램 포크를 제거하세요' 같은 한 문장짜리 프롬프트를 자주 보냅니다. 팀이 접근할 수 있는 저장소에 모든 스킬을 공유합니다. 압박 없이 사용하고, 변형하고, 추가하세요. 작업 방식을 공유하고 참여하는 것이 모두가 같은 방식으로 작업하게 하는 것보다 중요합니다.
저는 docs/ 폴더가 있고, 특정 애플리케이션에 필요한 모든 스킬과 문서를 거기에 둡니다. 이를 ADR처럼 취급하여 AI가 작업 중인 시스템의 일부를 이해하도록 돕습니다.
원문 읽기 →RSS

HN 토론

280
  1. avaer

    기술(skills)은 대부분 사기나 다름없습니다. 사람들이 사용하는 방식(유명인사로부터 쿵푸를 다운로드하려는 열망)을 보면 말이죠.

    예전에는 중요했을 때도 있었지만(작년), 요즘 에이전트들은 좋은 저장소와 프롬프트만 있으면 기술 없이도 정확히 필요한 것을 찾을 수 있습니다.

    개발자 매크로로서의 '기술'은 유용할 수 있지만, 기껏해야 팀(저장소 내)과 공유되는 것들이지, 인터넷에서 다운로드하는 것이 아닙니다. 관리할 필요를 느낄 정도로 많은 기술을 가지고 있다면, 그것은 코드 냄새(code smell)입니다.

  2. alexhans

    저는 기술을 찾지 않고, 직접 만듭니다.

    - 모든 코딩 하네스에 심볼릭 링크로 설치하는 소프트웨어 저장소에 체계적으로 보관합니다. 프론트매터(frontmatter) 기반의 점진적 공개(progressive disclosure)가 나머지를 처리합니다.

    - AI 평가(evals)와 함께 작동하도록 만듭니다. 동작을 증명하는 통합 테스트라고 생각하세요. 흐름을 최적화하는 데 유용합니다. 제 기술은 대부분 자연어와 그들이 호출하는 좋고 작고 빠른 도구 사이의 번역이 되도록 노력합니다.

    - 새로운 문제가 발생할 때 변경합니다. 그냥 이유 없이 바꾸지 않습니다.

    기술이 제 팀이나 저 개인에게 맞춤화된 워크플로우를 나타낸다면, 기술은 모델의 능력에 의해 대체될 수 없습니다.

    과거에 좋은 정신 모델에 대해 글을 쓴 적이 있습니다:

    https://alexhans.github.io/posts/series/evals/building-agent...

  3. FailMore

    아직 언급되지 않아 놀랍지만, https://github.com/vercel-labs/skills에 의존하는 것이 건전하다고 생각합니다. 다양한 코딩 에이전트에 대한 전역 설치를 처리합니다. 내부 전용 기술을 작업한다면 아마도 같은 기반을 사용할 것입니다.

  4. srijanshukla18

    저는 GitHub에 기술 저장소를 두고 있고, Hermes 자동화를 사용하여 기술 저장소를 동기화합니다. 이 Hermes 자동화는 모든 기기에 있습니다.

    즉석에서 만드는 모든 기술은 제 전역 AGENTS.md에 기술 저장소 경로를 업데이트하고 적절히 배치하라는 지침이 있습니다.

  5. WatchDog

    저는 기술을 사용하지 않습니다. 사람들이 가장 유용하게 생각하는 기술은 어떤 것들인가요?

    일반적인 작업의 경우, 모델이 스스로 알아서 처리할 수 있는 것 같습니다. 프로젝트나 환경 특정 작업의 경우, 그 정보를 README나 agents.md 파일에 넣습니다.

  6. jve

    지난주에 다른 프로젝트에서 직접 만든 기술을 재사용해야 했습니다. AI가 제안한 해결책이 마음에 들었고 꽤 잘 작동합니다: 플러그인으로 배포하고 git 저장소를 마켓플레이스로 추가하는 것입니다.

    설치가 매우 쉽고, 같은 코드베이스를 다른 플랫폼에서 작업할 수 있기 때문에 심볼릭 링크를 사용할 필요가 없습니다. (플랫폼마다 다를 수 있으므로)

    codex plugin marketplace add "https://path-to-my-git-repo"

    codex plugin add agent-tools@mycompany

    claude plugin marketplace add "https://path-to-my-git-repo"

    claude plugin install agent-tools@mycompany

    AI가 마켓플레이스용 .json 파일을 생성하도록 하세요.

    아직 이 부분까지는 진행하지 않았지만, 설치만큼 쉽게 작동할 것이라고 확신합니다.

    claude plugin marketplace update mycompany

    claude plugin update agent-tools@mycompany

  7. shermantanktop

    의도적으로 기술 세트를 선별하고 이름으로 특별히 호출하는 것은 별 의미가 없는 것 같습니다. AI가 그 기술들을 모두 건너뛰고 코드와 내부/외부 웹사이트를 읽는 것만으로 더 잘하는 것을 지켜보는 것뿐입니다.

  8. maxim-fin

    요즘에는 반복적인 작업을 위해 기술을 직접 만드는 경우가 많습니다(코딩 어시스턴트의 도움을 받아). 예를 들어, Claude CLI가 작업 트리를 codex CLI에 보내 리뷰를 받고, 그 결과를 읽고 변경 사항을 적용하도록 하는 제 자신의 기술을 사용합니다.

이 날의 다른 글

2026-09-07