Skip to content

installation.md

Latest commit

 

History

History
183 lines (130 loc) · 3.52 KB

installation.md

File metadata and controls

183 lines (130 loc) · 3.52 KB

Installation Guide

This guide shows how to install AgenticOps skills for different platforms.

clawdbot

Option 1: Clone Entire Repository (Recommended)

# Clone to clawdbot skills directory
git clone https://github.com/agenticdevops/agentic-ops-skills.git \
  ~/.clawdbot/skills/agentic-ops

# Verify installation
ls ~/.clawdbot/skills/agentic-ops/skills/

Skills are automatically loaded on next clawdbot session.

Option 2: Symlink Individual Skills

If you only want specific skills:

# Clone repository somewhere
git clone https://github.com/agenticdevops/agentic-ops-skills.git ~/agentic-ops-skills

# Create clawdbot skills directory
mkdir -p ~/.clawdbot/skills

# Symlink only the skills you want
ln -s ~/agentic-ops-skills/skills/k8s-debug ~/.clawdbot/skills/
ln -s ~/agentic-ops-skills/skills/docker-ops ~/.clawdbot/skills/
ln -s ~/agentic-ops-skills/skills/incident-response ~/.clawdbot/skills/

Option 3: Symlink All Skills

# Clone repository
git clone https://github.com/agenticdevops/agentic-ops-skills.git ~/agentic-ops-skills

# Create clawdbot skills directory
mkdir -p ~/.clawdbot/skills

# Symlink all skills
for skill in ~/agentic-ops-skills/skills/*/; do
  ln -sf "$skill" ~/.clawdbot/skills/
done

# Verify
ls ~/.clawdbot/skills/

Verify Installation

# Start clawdbot TUI
clawdbot tui

# Test a skill by asking:
# "help me debug my kubernetes pods"
# "check system health"
# "show docker containers"

Update Skills

# If cloned directly
cd ~/.clawdbot/skills/agentic-ops && git pull

# If symlinked
cd ~/agentic-ops-skills && git pull

aof.sh

Clone to Skills Directory

# Clone to aof skills directory
git clone https://github.com/agenticdevops/agentic-ops-skills.git \
  ~/.aof/skills/agentic-ops

# Or symlink to workspace
mkdir -p ~/.claude/skills
for skill in ~/agentic-ops-skills/skills/*/; do
  ln -sf "$skill" ~/.claude/skills/
done

# Verify
aofctl skills list --eligible

Claude Code

Add to CLAUDE.md

Copy the contents of claude-code/CLAUDE.md to your Claude configuration:

# Append to your global CLAUDE.md
cat ~/agentic-ops-skills/claude-code/CLAUDE.md >> ~/.claude/CLAUDE.md

# Or copy as separate file
cp ~/agentic-ops-skills/claude-code/CLAUDE.md ~/.claude/devops-skills.md

Then reference it in your main CLAUDE.md:

# Include DevOps skills
See also: devops-skills.md

Troubleshooting

Skills Not Loading

  1. Check directory structure:

    ls ~/.clawdbot/skills/
# Should show skill directories (k8s-debug, docker-ops, etc.)

ls ~/.clawdbot/skills/k8s-debug/
# Should show SKILL.md

  2. Check permissions:

    chmod -R 755 ~/.clawdbot/skills/

  3. Verify SKILL.md format:

    head -20 ~/.clawdbot/skills/k8s-debug/SKILL.md
# Should show YAML frontmatter starting with ---

Symlinks Not Working

# Check if symlinks are valid
ls -la ~/.clawdbot/skills/

# If broken, recreate
rm ~/.clawdbot/skills/k8s-debug
ln -s /full/path/to/agentic-ops-skills/skills/k8s-debug ~/.clawdbot/skills/

Requirements Not Met

Some skills require specific tools. Check if they're installed:

# Kubernetes skills
which kubectl

# Docker skills
which docker

# AWS skills
which aws

# Terraform skills
which terraform

# ArgoCD skills
which argocd

Uninstall

# Remove cloned repo
rm -rf ~/.clawdbot/skills/agentic-ops

# Or remove symlinks
rm ~/.clawdbot/skills/k8s-debug
rm ~/.clawdbot/skills/docker-ops
# ... etc