using-devops-skills

IF A SKILL APPLIES TO YOUR TASK, YOU DO NOT HAVE A CHOICE. YOU MUST USE IT.

This is not negotiable. This is not optional. You cannot rationalize your way out of this.

This plugin supports the FULL DevOps lifecycle – Development AND Operations.

Core Principles

For Development

1. Test First – Write tests before implementation (TDD)
2. Debug Systematically – Follow evidence, not hunches
3. Review Thoroughly – Code review before merge
4. Plan Before Coding – Design before implementation

For Operations

1. Never Auto-Apply – All terraform/tofu apply commands require explicit user approval
2. Explain Each Step – Guide the user through what will happen before doing it
3. Escalate Conflicts – When uncertain, ask the user rather than guessing
4. Fewer Mistakes – Safety over speed, always

How to Access Skills

In Claude Code: Use the Skill tool. When you invoke a skill, its content is loaded and presented to you—follow it directly. Never use the Read tool on skill files.

The Rule

Invoke relevant or requested skills BEFORE any response or action. Even a 1% chance a skill might apply means you should invoke the skill.

digraph skill_flow {
    "User message received" [shape=doublecircle];
    "Might any skill apply?" [shape=diamond];
    "Invoke Skill tool" [shape=box];
    "Announce: 'Using [skill] to [purpose]'" [shape=box];
    "Has checklist?" [shape=diamond];
    "Create TodoWrite todo per item" [shape=box];
    "Follow skill exactly" [shape=box];
    "Respond (including clarifications)" [shape=doublecircle];

    "User message received" -> "Might any skill apply?";
    "Might any skill apply?" -> "Invoke Skill tool" [label="yes, even 1%"];
    "Might any skill apply?" -> "Respond (including clarifications)" [label="definitely not"];
    "Invoke Skill tool" -> "Announce: 'Using [skill] to [purpose]'";
    "Announce: 'Using [skill] to [purpose]'" -> "Has checklist?";
    "Has checklist?" -> "Create TodoWrite todo per item" [label="yes"];
    "Has checklist?" -> "Follow skill exactly" [label="no"];
    "Create TodoWrite todo per item" -> "Follow skill exactly";
}

Available Skills

Development Skills

Operations Skills

Commands

Skill Priority

When multiple skills could apply, use this order:

1. Process skills first (brainstorming, debugging) – these determine HOW to approach the task
2. Implementation skills second (TDD, code review) – these guide execution
3. Infrastructure skills when working with IaC

Examples:

• “Let’s build X” → brainstorming first, then TDD
• “Fix this bug” → systematic-debugging first
• “Deploy this change” → terraform-plan-review, then aws-profile-management

Red Flags – STOP if You Think These

Development Red Flags

Operations Red Flags

Dangerous Commands – ALWAYS BLOCKED

These commands are intercepted by safety hooks:

• terraform apply / tofu apply (without explicit approval flow)
• terraform destroy / tofu destroy
• terraform state rm
• terraform force-unlock
• Any command with -auto-approve flag

Parallel Agent Workflows

For complex tasks, dispatch multiple agents in parallel:

Infrastructure Analysis

/plan command →
  ├─→ Task(terraform-plan-analyzer) → Risk Analysis
  ├─→ Task(security-reviewer) → Security Analysis
  └─→ Task(historical-pattern-analyzer) → Pattern Detection

Development Tasks

Multiple test failures →
  ├─→ Task(fix test file A)
  ├─→ Task(fix test file B)
  └─→ Task(fix test file C)

Memory System

DevOps-skills maintains memory across sessions for learning from history.

User Instructions

Instructions say WHAT, not HOW. “Add X” or “Fix Y” doesn’t mean skip workflows.

The user’s #1 goal is fewer mistakes. Honor that above all else – in BOTH development AND operations.