Devlery
BlogSkillsTags

github-actions-docs

Infra

설치

$ npx skills add https://github.com/xixu-me/skills --skill github-actions-docs

요약

CI 실패 원인을 좁히거나 재사용 가능한 워크플로를 정리할 때 적합합니다.

  • GitHub Actions 워크플로 문법과 운영 패턴을 확인하며 CI 설정을 다듬는 데 도움을 주는 문서형 스킬입니다.
  • 한국어 큐레이션 기준으로 이 스킬의 핵심을 먼저 정리했습니다.
  • 설치는 개별 스킬 페이지의 명령을 그대로 사용합니다.
  • 아래 해설 섹션에서 사용 맥락과 주의점을 한국어로 길게 풀어 읽을 수 있습니다.

해설

어떤 스킬인가

github-actions-docs는 GitHub Actions 워크플로를 작성하거나 고칠 때 문법과 공식 동작을 확인하도록 돕는 스킬입니다. 트리거, job, matrix, cache, permissions, reusable workflow처럼 CI 구성에서 자주 쓰는 요소를 점검합니다.

CI 파일은 YAML이라 작은 들여쓰기나 권한 설정 하나로도 실패가 납니다. 에이전트가 기억에 의존해 워크플로를 작성하면 최신 문법이나 제한을 놓칠 수 있으므로, 문서 기반 확인이 중요합니다.

언제 쓰면 좋은가

GitHub Actions 실패를 고치거나 새 workflow를 만들 때 좋습니다. 특히 permissions, OIDC, cache key, pull request 이벤트, 환경별 secret 범위처럼 보안과 실행 조건이 섞인 작업에서 유용합니다.

단순한 빌드 스크립트 작성보다 "왜 이 workflow가 특정 이벤트에서만 실패하는지"를 좁힐 때 더 가치가 큽니다. 실제 실패 로그와 함께 쓰면 추정이 줄어듭니다.

설치

npx skills add https://github.com/xixu-me/skills --skill github-actions-docs

요청할 때는 workflow 파일과 실패한 run 로그를 함께 제공하는 편이 가장 좋습니다.