DevOps Toolkit

A comprehensive collection of agents and skills for Claude Code focused on DevOps, infrastructure management, and developer productivity.

Quick Start

Add to your Clewfile:

echo "adamancini/devops-toolkit" >> ~/.claude/Clewfile
clew sync

Or install directly:

/plugin marketplace add adamancini/devops-toolkit
/plugin install devops-toolkit@devops-toolkit

Restart Claude Code and invoke skills:

"Create a wildcard certificate for example.com"
"Configure aerospace for my workspace"

Agents

Specialized agents for project-specific workflows and task automation.

CLAUDEMD Compliance Checker

Verifies compliance with project-specific instructions in CLAUDE.md/AGENTS.md files.

Helm Chart Developer

Production-quality Helm chart development with Helm 3 standards and best practices.

Home Manager

Expert management of home directory structure, dotfiles with yadm, and system configuration.

Linear Assistant

Processes verbose Linear MCP responses and returns concise summaries for context optimization.

Markdown Writer

Creates, edits, and improves Markdown documents with proper formatting and style compliance.

MCP Security Validator

Validates MCP servers for security issues before addition to Claude Code.

Obsidian Notes

Expert Obsidian knowledge management for vault operations and Notion synchronization.

Quality Control Enforcer

Reviews work to ensure it meets quality standards and avoids common pitfalls.

Shell Code Optimizer

Ensures shell scripts follow portability, simplicity, and best practices for cross-platform compatibility.

YAML Kubernetes Validator

Validates YAML documents for proper formatting and Kubernetes API specification compliance.

Skills Overview

SSL Certificate Manager

Comprehensive SSL/TLS certificate management with Let's Encrypt.

Key Features:

• Automated DNS challenges (Google Cloud DNS, Cloudflare, Route53)
• Manual DNS challenges for any provider
• Wildcard certificate support
• Certificate inspection and validation
• Kubernetes TLS secret generation
• Renewal workflows with expiration monitoring

Example:

"Create a wildcard certificate for *.example.com using Cloudflare DNS"

Full Documentation →

AeroSpace Configuration Manager

Safe management of AeroSpace window manager configurations on macOS.

Key Features:

• Automatic backup before changes
• Keybinding conflict detection (AeroSpace + macOS + apps)
• Application workspace assignments
• Floating vs tiling window rules
• Multi-monitor configuration
• TOML validation and rollback

Example:

"Assign Chrome to workspace 2"
"Add keybinding for fullscreen toggle"

Full Documentation →

Installation

Prerequisites

• General: Claude Code, macOS 14+
• SSL Cert Manager: Docker, DNS provider access
• AeroSpace Manager: AeroSpace, Python 3.11+

Recommended: Via Clewfile

Add to ~/.claude/Clewfile:

adamancini/devops-toolkit

Then sync:

clew sync

Direct Installation

/plugin marketplace add adamancini/devops-toolkit
/plugin install devops-toolkit@devops-toolkit

Restart Claude Code to load the plugin.

Configuration

SSL Certificate Manager

Configure DNS provider credentials:

Google Cloud DNS:

# Place service account JSON
~/letsencrypt/credentials.json

Cloudflare:

# Create credentials file
cat > ~/letsencrypt/cloudflare.ini  Keyboard

## Security

- SSL private keys stored locally in `~/letsencrypt/`
- DNS credentials should follow least-privilege principle
- AeroSpace backups stored locally (no remote transmission)
- All configuration changes backed up before modification

## Roadmap

### Planned Skills

- Kubernetes helpers (pod debugging, log aggregation)
- Helm chart validator
- Docker Compose manager
- Terraform manager
- CI/CD pipeline helpers

See [CHANGELOG.md](./CHANGELOG.md) for version history.

## Support

- **Issues**: [GitHub Issues](https://github.com/adamancini/devops-toolkit/issues)
- **Discussions**: [GitHub Discussions](https://github.com/adamancini/devops-toolkit/discussions)

## Author

**Ada Mancini** ([@adamancini](https://github.com/adamancini))

DevOps engineer specializing in Kubernetes, Helm, and infrastructure automation.

## License

MIT License - see [LICENSE](./LICENSE) file.

## Acknowledgments

- [AeroSpace](https://github.com/nikitabobko/AeroSpace) - macOS tiling window manager
- [Let's Encrypt](https://letsencrypt.org/) - Free SSL/TLS certificates
- [Claude Code](https://claude.ai/code) - AI development assistant