Harness용 Claude Code 스킬 모음

Harness.io CI/CD 플랫폼을 위한 Claude Code 스킬입니다. 자연어로부터 파이프라인 YAML 생성, 리소스 관리, 실패 디버깅, 비용 분석 등을 수행할 수 있습니다.

이 저장소는 단순한 프롬프트 폴더가 아니라 워크플로우 시스템으로 설계되었습니다. 최상위 지침(AGENTS.md, CLAUDE.md에서 가져옴)은 공유된 동작을 설정하며, 개별 스킬들은 생성, 디버깅, 거버넌스 및 보고 작업에 특화되어 있습니다.

• Harness MCP v2 Server - MCP 기반 스킬에 필수적입니다. 이 저장소의 대부분의 스킬은 Harness API 접근을 위해 이를 사용합니다.

저장소를 클론하고 프로젝트 디렉토리에서 Claude Code를 실행하세요. 스킬들은 skills/*/SKILL.md에서 자동으로 발견됩니다. 프로젝트 규칙은 CLAUDE.md를 통해 로드됩니다.

→ @AGENTS.md:

git clone https://github.com/harness/harness-skills.git
cd harness-skills
claude

Harness MCP 서버를 추가하려면 Claude Code 설정(~/.claude/settings.json)에서 구성하세요:

{
"mcpServers": {
"harness-mcp-v2": {
...

이름으로 스킬 호출하기:

/create-pipeline
Node.js 앱에 대한 CI 파이프라인을 생성하여 빌드하고, 테스트를 실행하며, ECR에 Docker 이미지를 푸시합니다.

• 저장소를 프로젝트 또는 참조 작업 공간으로 클론하세요:
  git clone https://github.com/harness/harness-skills.git

• 이 저장소에는 Cursor가 프로젝트 규칙으로 자동으로 로드하는 .cursor/rules/harness.mdc가 포함되어 있습니다.

• Cursor에서 Harness MCP 서버를 구성하세요 (~/.cursor/mcp.json):

{
"mcpServers": {
"harness-mcp-v2": {
...

• 프롬프트에서 @file을 사용하여 개별 스킬을 참조하세요:

@harness-skills/skills/create-pipeline/SKILL.md
내 Go 서비스에 대한 CI 파이프라인을 생성합니다.

• 저장소를 작업 디렉토리로 클론하세요:
  git clone https://github.com/harness/harness-skills.git

• 이 저장소에는 루트에 AGENTS.md가 포함되어 있으며, Codex가 시스템 지침으로 자동으로 읽습니다.

• Codex MCP 설정에서 Harness MCP 서버를 구성하세요:

참조할 개별 스킬 파일을 컨텍스트로 사용하기 위해 프롬프팅:

Using the instructions in harness-skills/skills/debug-pipeline/SKILL.md,
diagnose why my deploy pipeline failed

프로젝트에 저장소를 복제하세요:

git clone https://github.com/harness/harness-skills.git

이 저장소에는 다음 파일들이 포함되어 있습니다.

.github/copilot-instructions.md

이는 Copilot이 GitHub.com과 VS Code 모두에서 프로젝트 레벨 컨텍스트로 자동으로 읽습니다. -
VS Code의 경우, 워크스페이스 설정( .vscode/mcp.json )에 Harness MCP 서버를 구성하세요:

{
"servers": {
"harness-mcp-v2": {
...

Copilot Chat에서 #file을 사용하여 스킬 파일을 참조하세요:

#file:harness-skills/skills/create-pipeline/SKILL.md
Create a CI pipeline for my Python service

GitHub.com의 GitHub Copilot의 경우, Copilot Chat에서 스킬 파일을 컨텍스트로 첨부하거나 Copilot 조직 설정의 지식 기반 참조로 추가하세요.

이 저장소의 스킬들은 YAML 프론트매터가 있는 일반 Markdown 파일입니다. 이들은 다음을 지원하는 모든 AI 코딩 도구와 작동합니다:

시스템 명령어 (System instructions) - 프로젝트 레벨 컨텍스트로 AGENTS.md를 사용하고 (CLAUDE.md는 Claude Code용으로 이를 가져옵니다). MCP 서버 (MCP servers) - API 액세스를 위해 Harness MCP v2 서버에 연결합니다. 파일 컨텍스트 (File context) - 프롬프트에서 개별 skills/*/SKILL.md 파일을 참조합니다.

최고의 Harness 스킬들은 서로 다른 리소스 유형을 대상으로 할 때도 동일한 제어 흐름을 따릅니다:

범위 먼저 설정 (Establish scope first) - 리소스를 나열, 생성, 업데이트 또는 삭제하기 전에 계정/조직/프로젝트 컨텍스트를 확인합니다. 종속성 생성 전 검증 (Verify dependencies before generating dependents) - 존재가 확인되지 않은 커넥터, 시크릿, 환경, 인프라 또는 템플릿을 참조하지 않습니다. 페이로드 작성 전 스키마 발견 (Discover schema before writing payloads) - 필드 이름이나 페이로드 형태를 추측하는 대신 harness_describe와 API 유효성 검사 피드백을 사용합니다.

이 저장소 레벨의 플레이북들은 다음 위치에 있습니다:

references/scope-establishment.md
references/dependency-check-playbook.md

references/schema-validation-loop.md

templates/operation-summary.md

다음 순서로 스킬을 사용하세요:

/create-connector

/create-secret

/create-service

/create-environment

/create-infrastructure

/create-pipeline

/create-trigger

일반적인 순서 (Typical sequence):

/run-pipeline
최신 실행을 식별하거나 문제를 재현할 때
/debug-pipeline
실패를 분류하고 근본 원인(root cause)을 검사할 때
/template-usage
공유 템플릿이 문제를 전파했을 수 있을 때
/manage-delegates
실패가 데리게이트 용량 또는 연결성으로 지적될 때

harness-skills/
├── skills/
│ ├── create-pipeline/
...

여러 스킬에 걸쳐 일관성을 유지해야 하는 동작에는 루트 레벨 공유 자산(references/)을 사용합니다:

templates/

• 범위 설정, 종속성 검증, 스키마 검증 루프와 같은 재사용 가능한 운영 지침
• 작업 요약 및 보고서 형식과 같은 재사용 가능한 출력 계약

콘텐츠가 도메인별이고 광범위하게 가져와져서는 안 되는 경우 개별 스킬의 references/ 또는 templates/를 사용합니다.

각 스킬은 skills/ 아래의 디렉토리이며, YAML 프론트매터와 일관된 마크다운 본문을 가진 SKILL.md 파일이 포함되어 있습니다:

name: my-skill
description: >-
...

복잡한 스킬의 경우, SKILL.md를 부풀리는 대신 스킬 디렉토리 아래에 references/ 또는 templates/를 추가하세요.

MCP 기반 스킬은 Harness MCP v2 서버를 사용하며, 이 서버는 resource_type에 의해 배포되는 10개의 일반 도구를 제공합니다:

스킬 작성 표준, 유효성 검사 규칙 및 기여 워크플로우는 CONTRIBUTING.md를 참조하세요.

본 프로젝트는 Apache License 2.0에 따라 라이선스가 부여됩니다.

Copyright 2026 Harness Inc.