ansible-deployment
Automates server configuration and multi-server deployments. Use when writing Ansible playbooks, setting up SSH auth, or checking deployment diffs.
Best use case
ansible-deployment is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Automates server configuration and multi-server deployments. Use when writing Ansible playbooks, setting up SSH auth, or checking deployment diffs.
Teams using ansible-deployment should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/ansible-deployment/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How ansible-deployment Compares
| Feature / Agent | ansible-deployment | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Automates server configuration and multi-server deployments. Use when writing Ansible playbooks, setting up SSH auth, or checking deployment diffs.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Ansible Deployment Automation 서버 설정 파일 배포 시 안전하고 효율적인 Ansible 패턴을 제공합니다. **핵심 철학**: - 배포 전 diff 확인 필수 (사용자가 변경 내용 검토) - Ansible 네이티브 기능 우선 (shell 스크립트 최소화) - 단일 비밀번호 입력으로 전체 워크플로우 완료 - 색상 diff로 가독성 향상 ## Instructions ### 워크플로우: 요청 분석 및 리소스 선택 사용자 요청을 분석하여 필요한 리소스만 선택적으로 로드합니다. #### 1. 키워드 매칭 사용자 요청의 키워드를 분석하여 필요한 리소스를 판단: **Diff 체크** (`resources/01-diff-checking.md`) - "diff", "차이", "변경 사항" - "배포 전 확인", "dry-run" - "file_diff_checker" - "copy 모듈" **SSH 인증** (`resources/02-ssh-auth.md`) - "SSH", "인증", "비밀번호" - "vars_prompt" - "ProxyJump", "Gateway" - "VPN", "접속" **Copy 모듈 활용** (`resources/03-copy-module.md`) - "copy 모듈", "copy module" - "check_mode", "diff" - "파일 동기화", "파일 배포" **Playbook 패턴** (`resources/04-playbook-patterns.md`) - "playbook", "role" - "배포", "deploy" - "서비스 reload", "handler" - "사용자 확인", "pause" **검증 및 테스트** (`resources/05-testing-validation.md`) - "syntax check", "문법 검사" - "dry-run", "테스트" - "lint", "검증" - "justfile" #### 2. 리소스 로딩 전략 **단일 키워드 감지** - User: "배포 전 diff 확인하고 싶어" - → Read resources/01-diff-checking.md - → Read resources/03-copy-module.md **복합 요청** - User: "Ansible로 설정 파일 안전하게 배포하는 방법" - → Read resources/01-diff-checking.md (Diff) - → Read resources/02-ssh-auth.md (SSH) - → Read resources/03-copy-module.md (Copy) - → Read resources/04-playbook-patterns.md (Playbook) **불명확한 요청** - User: "Ansible 배포 설정" - → REFERENCE.md 확인하여 사용자에게 선택지 제시 - → 선택에 따라 리소스 로드 #### 3. 리소스 적용 1. **현재 프로젝트 구조 파악** - ansible 디렉토리 위치 확인 - 기존 playbook, role 확인 2. **리소스 Read** - 필요한 리소스만 Read - 다른 리소스 참조 필요 시 추가 Read 3. **패턴 적용** - Read한 리소스의 패턴을 프로젝트에 적용 - 기존 설정이 있으면 수정, 없으면 생성 - 사용자에게 변경 사항 확인 4. **검증** - ansible-playbook --syntax-check - 가능하면 실행하여 동작 확인 - 문제 발생 시 사용자에게 보고 ### 예시 #### 예시 1: Diff 체크 Role 생성 User: "배포 전에 변경 내용을 diff로 보고 싶어" 1. 키워드 매칭: "diff", "배포 전" → Diff Checking 2. Read resources/01-diff-checking.md 3. Read resources/03-copy-module.md 4. ansible/roles/file_diff_checker/ 생성 5. copy 모듈 check_mode + diff 패턴 적용 6. 사용자에게 사용법 안내 #### 예시 2: SSH 인증 개선 User: "Ansible 실행할 때 비밀번호 여러 번 입력하기 귀찮아" 1. 키워드 매칭: "비밀번호" → SSH Auth 2. Read resources/02-ssh-auth.md 3. vars_prompt 설정 추가 4. ansible_password + ansible_become_password 설정 5. 테스트 실행 확인 #### 예시 3: 안전한 배포 Playbook User: "서버 설정 파일을 안전하게 배포하는 playbook 만들어줘" 1. 키워드 매칭: "배포", "안전" → 전체 2. Read resources/01-diff-checking.md 3. Read resources/02-ssh-auth.md 4. Read resources/03-copy-module.md 5. Read resources/04-playbook-patterns.md 6. Playbook 생성 (diff → 확인 → 배포 → reload) 7. 실행 테스트 ## 중요 원칙 1. **토큰 효율**: 필요한 리소스만 Read 2. **Ansible 네이티브 우선**: shell 스크립트 대신 Ansible 모듈 사용 3. **사용자 확인**: 배포 전 diff 확인 필수 4. **실행 검증**: 가능하면 항상 실행하여 동작 확인 5. **범용성**: 프로젝트 특정 내용 없이 패턴만 제공 ## Technical Details 상세한 설정 및 예제는 각 리소스 파일 참조: - `REFERENCE.md`: 리소스 전체 개요 - `resources/01-diff-checking.md`: 배포 전 diff 확인 패턴 - `resources/02-ssh-auth.md`: SSH 인증 및 vars_prompt - `resources/03-copy-module.md`: copy 모듈 활용법 - `resources/04-playbook-patterns.md`: 안전한 배포 playbook 구조 - `resources/05-testing-validation.md`: 검증 및 테스트 워크플로우
Related Skills
azure-deployment
Deploys applications to Azure using Azure Dev CLI, Bicep infrastructure as code, and GitHub Actions CI/CD. Use this skill when asked to deploy to Azure, create infrastructure, set up CI/CD, configure Azure resources, or create deployment pipelines.
azd-deployment
Deploy containerized applications to Azure Container Apps using Azure Developer CLI (azd). Use when setting up azd projects, writing azure.yaml configuration, creating Bicep infrastructure for Cont...
arc-terraform-deployment
Deploy ARC (Actions Runner Controller) infrastructure using Terraform on Rackspace Spot. Handles CRD registration, ArgoCD installation, and namespace management. Use when deploying or troubleshooting ARC infrastructure.
app-store-deployment
Publishes mobile applications to iOS App Store and Google Play with code signing, versioning, and CI/CD automation. Use when preparing app releases, configuring signing certificates, or setting up automated deployment pipelines.
ansible
Provides comprehensive guidance for Ansible automation including playbooks, roles, inventory, and module usage. Use when the user asks about Ansible, needs to automate IT tasks, create Ansible playbooks, or manage infrastructure with Ansible.
ansible-workflow
Ansible automation workflow guidelines. Activate when working with Ansible playbooks, ansible-playbook, inventory files (.yml, .ini), or Ansible-specific patterns.
ansible-validator
Comprehensive toolkit for validating, linting, testing, and automating Ansible playbooks, roles, and collections. Use this skill when working with Ansible files (.yml, .yaml playbooks, roles, inventories), validating automation code, debugging playbook execution, performing dry-run testing with check mode, or working with custom modules and collections.
ansible-testinfra
Bootstrap minimal testinfra pytest suite for an Ansible role and remind to run via uv
ansible-roles
Use when structuring and reusing code with Ansible roles for modular, maintainable automation and configuration management.
ansible-role-init
Scaffold a new Ansible role via ansible-galaxy init
ansible-playbooks
Use when writing and organizing Ansible playbooks for automated configuration management and infrastructure orchestration.
ansible-playbook
Write and review Ansible playbooks following best practices. Use when the user says "write ansible", "ansible playbook", "review playbook", "automate with ansible", or asks to configure servers with Ansible.