A comprehensive collection of agents and skills for Claude Code focused on DevOps, infrastructure management, and developer productivity. Add to your Clewfile: echo "adamancini/devops-toolkit" >> ~/.claude/Clewfile Or install directly: /plugin marketplace add adamancini/devops-toolkit /plugin install devops-toolkit@devops-toolkit Restart Claude Code and invoke skills: "Create a wildcard certificat
Add this skill
npx mdskills install adamancini/devops-toolkitBroad collection of agents and skills, but lacks individual skill implementations for review
1# DevOps Toolkit23A comprehensive collection of agents and skills for Claude Code focused on DevOps, infrastructure management, and developer productivity.45## Quick Start67Add to your `Clewfile`:8```bash9echo "adamancini/devops-toolkit" >> ~/.claude/Clewfile10clew sync11```1213Or install directly:14```15/plugin marketplace add adamancini/devops-toolkit16/plugin install devops-toolkit@devops-toolkit17```1819Restart Claude Code and invoke skills:20```21"Create a wildcard certificate for example.com"22"Configure aerospace for my workspace"23```2425## Agents2627Specialized agents for project-specific workflows and task automation.2829### CLAUDEMD Compliance Checker30Verifies compliance with project-specific instructions in CLAUDE.md/AGENTS.md files.3132### Helm Chart Developer33Production-quality Helm chart development with Helm 3 standards and best practices.3435### Home Manager36Expert management of home directory structure, dotfiles with yadm, and system configuration.3738### Linear Assistant39Processes verbose Linear MCP responses and returns concise summaries for context optimization.4041### Markdown Writer42Creates, edits, and improves Markdown documents with proper formatting and style compliance.4344### MCP Security Validator45Validates MCP servers for security issues before addition to Claude Code.4647### Obsidian Notes48Expert Obsidian knowledge management for vault operations and Notion synchronization.4950### Quality Control Enforcer51Reviews work to ensure it meets quality standards and avoids common pitfalls.5253### Shell Code Optimizer54Ensures shell scripts follow portability, simplicity, and best practices for cross-platform compatibility.5556### YAML Kubernetes Validator57Validates YAML documents for proper formatting and Kubernetes API specification compliance.5859## Skills Overview6061### SSL Certificate Manager6263Comprehensive SSL/TLS certificate management with Let's Encrypt.6465**Key Features:**66- Automated DNS challenges (Google Cloud DNS, Cloudflare, Route53)67- Manual DNS challenges for any provider68- Wildcard certificate support69- Certificate inspection and validation70- Kubernetes TLS secret generation71- Renewal workflows with expiration monitoring7273**Example:**74```75"Create a wildcard certificate for *.example.com using Cloudflare DNS"76```7778[Full Documentation →](./skills/ssl-cert-manager/)7980### AeroSpace Configuration Manager8182Safe management of AeroSpace window manager configurations on macOS.8384**Key Features:**85- Automatic backup before changes86- Keybinding conflict detection (AeroSpace + macOS + apps)87- Application workspace assignments88- Floating vs tiling window rules89- Multi-monitor configuration90- TOML validation and rollback9192**Example:**93```94"Assign Chrome to workspace 2"95"Add keybinding for fullscreen toggle"96```9798[Full Documentation →](./skills/aerospace-config-manager/)99100## Installation101102### Prerequisites103104- **General**: Claude Code, macOS 14+105- **SSL Cert Manager**: Docker, DNS provider access106- **AeroSpace Manager**: [AeroSpace](https://github.com/nikitabobko/AeroSpace), Python 3.11+107108### Recommended: Via Clewfile109110Add to `~/.claude/Clewfile`:111```112adamancini/devops-toolkit113```114115Then sync:116```bash117clew sync118```119120### Direct Installation121122```123/plugin marketplace add adamancini/devops-toolkit124/plugin install devops-toolkit@devops-toolkit125```126127Restart Claude Code to load the plugin.128129## Configuration130131### SSL Certificate Manager132133Configure DNS provider credentials:134135**Google Cloud DNS:**136```bash137# Place service account JSON138~/letsencrypt/credentials.json139```140141**Cloudflare:**142```bash143# Create credentials file144cat > ~/letsencrypt/cloudflare.ini <<EOF145dns_cloudflare_api_token = your-token146EOF147```148149**Route53:**150```bash151export AWS_ACCESS_KEY_ID="your-key"152export AWS_SECRET_ACCESS_KEY="your-secret"153```154155### AeroSpace Configuration Manager156157No additional configuration required. Works with existing `~/.aerospace.toml`.158159## Usage Examples160161### SSL Certificates162163**Generate certificate:**164```165User: "Create a wildcard certificate for *.lab.example.com using Google Cloud DNS"166167→ Verifies credentials168→ Runs certbot with dns-google plugin169→ Generates cert + key170→ Shows expiration date171→ Optionally creates Kubernetes secret172```173174**Renew certificate:**175```176User: "Renew my example.com certificate"177178→ Checks expiration179→ Runs renewal180→ Updates Kubernetes secrets181```182183### AeroSpace Configuration184185**Workspace setup:**186```187User: "Set up my development workspace layout"188189→ Detects running apps190→ Suggests assignments (Browser→1, Editor→2, etc.)191→ Creates backup192→ Applies configuration193→ Generates cheatsheet194```195196**Add keybinding:**197```198User: "Add alt+m for fullscreen"199200→ Checks conflicts201→ Shows preview202→ Backs up config203→ Applies change204→ Reloads AeroSpace205```206207## Architecture208209```210devops-toolkit/ # MARKETPLACE211├── README.md # This file212├── .claude-plugin/ # Marketplace manifest213│ └── marketplace.json # Marketplace catalog214├── CHANGELOG.md # Version history215├── LICENSE # MIT License216└── plugins/ # Plugins directory217 └── devops-toolkit/ # PLUGIN218 ├── .claude-plugin/219 │ └── plugin.json # Plugin manifest220 ├── agents/ # Agent definitions221 │ ├── claudemd-compliance-checker.md222 │ ├── helm-chart-developer.md223 │ ├── home-manager.md224 │ ├── linear-assistant.md225 │ ├── markdown-writer.md226 │ ├── mcp-security-validator.md227 │ ├── obsidian-notes.md228 │ ├── quality-control-enforcer.md229 │ ├── shell-code-optimizer.md230 │ └── yaml-kubernetes-validator.md231 ├── commands/232 │ └── repl-proposal.md233 ├── scripts/234 │ └── sync-replicated-elements.sh235 └── skills/236 ├── ssl-cert-manager/237 │ ├── ssl-cert-manager.md # Skill implementation238 │ └── README.md # Skill documentation239 ├── aerospace-config-manager/240 │ ├── aerospace-config-manager.md241 │ └── README.md242 └── linear-mcp-operations/243 ├── SKILL.md244 └── README.md245```246247## Development248249### Adding Agents2502511. Create agent markdown file in `agents/`2522. Include YAML frontmatter with description and capabilities2533. Add detailed agent instructions2544. Update this README with agent description2555. Update CHANGELOG.md256257### Adding Skills2582591. Create skill directory in `skills/`2602. Add skill markdown file (implementation)2613. Add README.md (user documentation)2624. Update `plugin.json` manifest2635. Update this README and CHANGELOG264265### Testing266267Test skills by invoking in Claude Code:268```269"Test ssl certificate with staging environment"270"Validate my aerospace configuration"271```272273### Contributing2742751. Fork the repository2762. Create feature branch2773. Make changes2784. Test thoroughly2795. Submit pull request280281## Troubleshooting282283### Plugin Not Loading284285```bash286# Verify marketplace is added287/plugin marketplace list288289# Check if plugin is installed290/plugin list291292# Verify JSON validity293python3 -m json.tool < .claude-plugin/marketplace.json294python3 -m json.tool < plugins/devops-toolkit/.claude-plugin/plugin.json295296# Restart Claude Code297```298299### SSL Certificate Issues300301- **Rate limits**: Use Let's Encrypt staging for testing302- **DNS propagation**: Wait 5-10 minutes after DNS changes303- **Docker**: Verify Docker daemon is running304305### AeroSpace Issues306307- **Config backup**: Check `~/.aerospace.toml.backups/`308- **TOML errors**: Run `python3 -c "import tomllib; tomllib.load(open('~/.aerospace.toml', 'rb'))"`309- **Keybinding conflicts**: Check System Settings > Keyboard310311## Security312313- SSL private keys stored locally in `~/letsencrypt/`314- DNS credentials should follow least-privilege principle315- AeroSpace backups stored locally (no remote transmission)316- All configuration changes backed up before modification317318## Roadmap319320### Planned Skills321322- Kubernetes helpers (pod debugging, log aggregation)323- Helm chart validator324- Docker Compose manager325- Terraform manager326- CI/CD pipeline helpers327328See [CHANGELOG.md](./CHANGELOG.md) for version history.329330## Support331332- **Issues**: [GitHub Issues](https://github.com/adamancini/devops-toolkit/issues)333- **Discussions**: [GitHub Discussions](https://github.com/adamancini/devops-toolkit/discussions)334335## Author336337**Ada Mancini** ([@adamancini](https://github.com/adamancini))338339DevOps engineer specializing in Kubernetes, Helm, and infrastructure automation.340341## License342343MIT License - see [LICENSE](./LICENSE) file.344345## Acknowledgments346347- [AeroSpace](https://github.com/nikitabobko/AeroSpace) - macOS tiling window manager348- [Let's Encrypt](https://letsencrypt.org/) - Free SSL/TLS certificates349- [Claude Code](https://claude.ai/code) - AI development assistant350
Full transparency — inspect the skill content before installing.