hello-ansible-skills

🥈Silver

Ansible automation skills for Claude Code enable playbook development, debugging, shell conversion, and interactive workflows. Operations teams benefit from streamlined automation tasks, reducing manual effort and improving efficiency. Connects to existing Ansible environments and integrates with shell scripts for workflow automation.

4410Updated 2mo ago

Intermediate30min to implementautomation

Saves ~160 min per use

Quick InstallView Source

git clone https://github.com/sigridjineth/hello-ansible-skills.git

Works with:

Claude

Overview

About This Skill

How to Use

1. **Define your task**: Replace [TASK] with your specific automation goal (e.g., 'install security patches', 'configure database replication', 'rollback a failed deployment'). 2. **Specify targets**: Replace [TARGET_HOSTS] with your inventory group (e.g., 'db_servers', 'prod_webservers') or a specific host list. 3. **Select modules**: Replace [MODULES] with the Ansible modules needed (e.g., 'yum, service, template' or 'apt, systemd, copy'). Use the 'ansible-doc' command to explore available modules. 4. **Configure error handling**: Replace [ERROR_HANDLING] with your strategy (e.g., 'ignore_errors: yes', 'failed_when: result.rc != 0', 'block/rescue'). 5. **Test incrementally**: Run the playbook with '--check --diff' flags first to preview changes without applying them. Use '--limit' to test on specific hosts. **Pro Tips:** - Use 'ansible-lint' to validate playbook syntax before execution - Store sensitive data in Ansible Vault files referenced by [VARS_FILE] - For complex workflows, break tasks into multiple playbooks with import_playbook - Enable 'ANSIBLE_DEBUG=1' environment variable for detailed execution logs

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/sigridjineth/hello-ansible-skills

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Create an Ansible playbook to [TASK] on [TARGET_HOSTS]. The playbook should include [MODULES] and handle errors with [ERROR_HANDLING]. Use [VARS_FILE] for variables and output results to [LOG_FILE]. Include a pre-flight check to verify [PREFLIGHT_CHECKS].

Example Output

```yaml
---
- name: Deploy updated web application with health checks
  hosts: web_servers
  become: yes
  vars_files:
    - vars/web_vars.yml
  tasks:
    - name: Verify target hosts are reachable
      ansible.builtin.ping:
      register: ping_result
      until: ping_result is success
      retries: 3
      delay: 10

    - name: Install required packages
      ansible.builtin.apt:
        name: ['nginx', 'python3-pip']
        state: present
        update_cache: yes
      when: ansible_os_family == 'Debian'

    - name: Deploy application code
      ansible.builtin.copy:
        src: /tmp/app_v2.1.0/
        dest: /var/www/html/
        owner: www-data
        group: www-data
        mode: '0755'
      notify: Restart nginx

    - name: Verify application health endpoint
      ansible.builtin.uri:
        url: "http://localhost/health"
        return_content: yes
      register: health_check
      until: health_check.status == 200
      retries: 5
      delay: 5

  handlers:
    - name: Restart nginx
      ansible.builtin.service:
        name: nginx
        state: restarted

```

**Execution Results:**
```
PLAY [Deploy updated web application with health checks] *********************************

TASK [Verify target hosts are reachable] **********************************************
ok: [web1.example.com] => {"changed": false, "ping": "pong"}
ok: [web2.example.com] => {"changed": false, "ping": "pong"}

TASK [Install required packages] ********************************************************
changed: [web1.example.com] => {"cache_update_time": 1689278401, "cache_updated": true}
changed: [web2.example.com] => {"cache_update_time": 1689278401, "cache_updated": true}

TASK [Deploy application code] **********************************************************
changed: [web1.example.com] -> {"checksum": "d41d8cd98f00b204e9800998ecf8427e", "dest": "/var/www/html/", "gid": 33, "group": "www-data", "md5sum": "d41d8cd98f00b204e9800998ecf8427e", "mode": "0755", "owner": "www-data", "size": 0, "src": "/tmp/app_v2.1.0/", "state": "directory", "uid": 33}
changed: [web2.example.com] -> {"checksum": "d41d8cd98f00b204e9800998ecf8427e", "dest": "/var/www/html/", "gid": 33, "group": "www-data", "md5sum": "d41d8cd9800b204e9800998ecf8427e", "mode": "0755", "owner": "www-data", "size": 0, "src": "/tmp/app_v2.1.0/", "state": "directory", "uid": 33}

TASK [Verify application health endpoint] **********************************************
ok: [web1.example.com] => {"changed": false, "content": "{\"status\":\"healthy\",\"version\":\"2.1.0\"}", "elapsed": 0, "json": {"status": "healthy", "version": "2.1.0"}, "msg": "OK (200)", "redirected": false, "status": 200, "url": "http://localhost/health"}
ok: [web2.example.com] => {"changed": false, "content": "{\"status\":\"healthy\",\"version\":\"2.1.0\"}", "elapsed": 0, "json": {"status": "healthy", "version": "2.1.0"}, "msg": "OK (200)", "redirected": false, "status": 200, "url": "http://localhost/health"}

PLAY RECAP ***********************************************************************
web1.example.com : ok=4 changed=2 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
web2.example.com : ok=4 changed=2 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
```

The playbook successfully deployed the new application version to both web servers with zero failures. The health checks confirmed the application was running correctly with version 2.1.0. All tasks completed within 2 minutes, including package installation and code deployment.