skills/nodnarbnitram__claude-code-extensions

mirror of https://github.com/nodnarbnitram/claude-code-extensions.git synced 2026-09-14 18:36:21 +08:00

Files

T

History

Brandon Martin 2232aae10c fix(plugins): remove unsupported manifest path fields (#7 )

## Summary
- remove explicit `agents`, `skills`, and `commands` fields from
generated plugin manifests
- rely on Claude Code's standard auto-discovery for plugin-root
`agents/`, `skills/`, and `commands/` directories
- flatten packaged agents to `agents/*.md` so discovery does not depend
on nested-path recursion
- keep the fix minimal by only retaining the explicit `hooks` entry for
`cce-core`

## Why
A local plugin install failed with:

```text
Plugin has an invalid manifest file ... Validation errors: agents: Invalid input
```

Our packaged plugins already follow the standard directory structure, so
the extra manifest path fields were unnecessary and were the most likely
validator mismatch. Greptile also flagged that many generated plugin
agents were nested under paths like `agents/specialized/...`, which
could silently fail if discovery is non-recursive. This change aligns
the packages with the default plugin structure instead of relying on
special manifest fields or recursive discovery.

## Changes
- update `scripts/sync_plugin_packages.py` to stop emitting manifest
path overrides
- flatten generated packaged agents to plugin-root `agents/*.md`
- regenerate all packaged plugin manifests with minimal metadata-only
manifests
- regenerate all packaged plugin agent files into the flat standard
layout

## Verification
- `python3 scripts/sync_plugin_packages.py`
- `python3 -m py_compile scripts/sync_plugin_packages.py
install_extensions.py`
- validated all 19 generated plugin manifests as JSON
- confirmed no generated manifest still contains `agents`, `skills`, or
`commands`
- confirmed packaged agents are flat: `flat_agents=78 nested_agents=0`

2026-04-01 22:25:42 -05:00

.claude-plugin

fix(plugins): remove unsupported manifest path fields (#7 )

2026-04-01 22:25:42 -05:00

agents

fix(plugins): remove unsupported manifest path fields (#7 )

2026-04-01 22:25:42 -05:00

README.md

refactor(plugins): package self-contained plugin installs (#5 )

2026-04-01 21:51:29 -05:00

README.md

cce-devops

DevOps Tooling for CI/CD and Infrastructure Management

Complete DevOps agent suite providing expert guidance for GitHub Actions CI/CD, Helm chart development, ArgoCD GitOps, and Crossplane infrastructure-as-code.

Overview

The cce-devops plugin provides specialized agents for:

GitHub Actions CI/CD: Workflow development, debugging, optimization, security, and custom action creation
Helm Charts: Template development, Go templating, Sprig functions, and chart best practices
ArgoCD GitOps: Installation, security hardening, multi-tenancy, scaling, and operational troubleshooting
Crossplane: Infrastructure provisioning, composition development, AWS resources, and upgrade management

Agents Included

GitHub Actions Expert

Agent: github-actions-expert Trigger: Use when working with .github/workflows/, action.yml files, or CI/CD pipeline development

Capabilities:

Workflow YAML development with security best practices
OIDC authentication for cloud deployments (AWS, Azure, GCP)
Performance optimization (caching, matrix builds, concurrency)
Custom action creation (composite, JavaScript, Docker)
Debugging with diagnostic commands and error analysis
Migration from other CI/CD platforms

Helm Template Master

Agent: helm-template-master Trigger: Use for Helm chart template development, debugging template issues, or working with Go templating

Capabilities:

Go template language and Helm built-in objects
Sprig function library (70+ functions)
Helper template patterns (_helpers.tpl)
Advanced patterns (checksum annotations, secret preservation, conditional resources)
Template validation and debugging
values.yaml structure design

ArgoCD Experts

Agents:

argocd-operator-expert - Infrastructure and operational management
argocd-developer-expert - Application deployment patterns
argocd-user-expert - End-user workflows and troubleshooting
helm-argocd-applicationset-expert - ApplicationSet patterns and Helm integration

Capabilities:

Installation and high availability setup
SSO/OIDC and RBAC configuration
Multi-tenancy with AppProject isolation
Sharding and performance tuning
Backup/disaster recovery procedures
Application deployment strategies
Progressive rollouts and sync waves
Monitoring and troubleshooting

Crossplane Experts

Agents:

crossplane-upgrade-agent - Version upgrades and migration guidance
crossplane-aws-rds-expert - AWS RDS provisioning with Crossplane

Capabilities:

Crossplane installation and configuration
Composition and XRD development
Provider configuration (AWS, Azure, GCP)
Infrastructure resource management
Version upgrade planning and execution
AWS RDS database provisioning patterns

Installation

Via Plugin System (Recommended)

# Add marketplace (if not already added)
/plugin marketplace add https://github.com/nodnarbnitram/claude-code-extensions

# Install the plugin
/plugin install cce-devops@cce-marketplace

# Verify installation
/agents  # Should show DevOps agents

Standalone Installation

# Clone repository
git clone https://github.com/nodnarbnitram/claude-code-extensions.git

# Copy agents to your project or user directory
cp -r claude-code-extensions/plugins/cce-devops/agents/specialized/devops ~/.claude/agents/specialized/
cp -r claude-code-extensions/plugins/cce-devops/agents/specialized/helm ~/.claude/agents/specialized/
cp -r claude-code-extensions/plugins/cce-devops/agents/specialized/argocd ~/.claude/agents/specialized/
cp -r claude-code-extensions/plugins/cce-devops/agents/specialized/crossplane ~/.claude/agents/specialized/

Usage Examples

GitHub Actions Workflow Development

> Create a GitHub Actions workflow for a Node.js app with:
> - Test on multiple Node versions (18, 20, 22)
> - Docker build and push to GHCR
> - AWS deployment using OIDC
> - Proper caching and security practices

The github-actions-expert agent will create a production-ready workflow with security best practices, performance optimizations, and comprehensive error handling.

Helm Chart Creation

> Create a Helm chart for a FastAPI application with:
> - Deployment with health checks
> - Service and Ingress
> - ConfigMap with checksum-triggered restarts
> - HPA for autoscaling
> - Proper value structure and helpers

The helm-template-master agent will generate complete templates with Go templating best practices, Sprig functions, and proper indentation handling.

ArgoCD Setup and Configuration

> Set up ArgoCD in HA mode with:
> - 3 replicas for argocd-server
> - Controller sharding for 500+ applications
> - OIDC integration with Okta
> - Multi-tenancy for dev, staging, prod teams

The argocd-operator-expert agent will provide production-ready configurations with security hardening, RBAC policies, and monitoring setup.

Crossplane Infrastructure

> Create a Crossplane composition for an AWS RDS PostgreSQL database with:
> - VPC and subnet configuration
> - Security group rules
> - Automated backups
> - Multi-AZ deployment

The crossplane-aws-rds-expert agent will generate compositions, XRDs, and claims with AWS best practices.

When Agents Activate

All agents in this plugin use proactive delegation. They activate automatically when:

Working with files in .github/workflows/ (GitHub Actions)
Editing Helm templates or working with values.yaml (Helm)
Configuring ArgoCD applications, projects, or manifests (ArgoCD)
Creating Crossplane compositions, XRDs, or claims (Crossplane)
User explicitly mentions the technology ("create a GitHub Actions workflow", "debug Helm template", etc.)

Agent Capabilities Matrix

Agent	CI/CD	Templating	GitOps	IaC	Security	Troubleshooting
github-actions-expert	✓	-	-	-	✓	✓
helm-template-master	-	✓	-	-	-	✓
argocd-operator-expert	-	-	✓	-	✓	✓
argocd-developer-expert	-	-	✓	-	-	✓
argocd-user-expert	-	-	✓	-	-	✓
helm-argocd-applicationset-expert	-	✓	✓	-	-	-
crossplane-upgrade-agent	-	-	-	✓	-	✓
crossplane-aws-rds-expert	-	-	-	✓	✓	-

Security Features

GitHub Actions

Minimal GITHUB_TOKEN permissions
Script injection prevention patterns
OIDC authentication (no long-lived credentials)
Action pinning to commit SHAs
Safe event trigger selection

ArgoCD

SSO/OIDC integration
Granular RBAC policies
AppProject-based multi-tenancy
TLS for all connections
External secrets management integration

Crossplane

Provider credential management
RBAC for resource creation
Composition-level security policies
Secret store integration

Performance Optimizations

GitHub Actions

Dependency caching strategies
Matrix builds for parallelization
Concurrency groups for cancellation
Conditional execution to skip unnecessary work

ArgoCD

Controller sharding (consistent-hashing algorithm)
Repo server parallelization
Status/operation processor tuning
Redis compression

Helm

Template optimization patterns
Efficient value lookups
Minimal resource generation

Troubleshooting

Common Issues

GitHub Actions:

Permission denied → Check GITHUB_TOKEN scopes
Cache not working → Verify cache key includes lock file hash
Slow workflows → Enable caching, use matrix builds

Helm:

Indentation errors → Use nindent instead of indent
Scope loss in range → Use $ to preserve root context
Type conversion errors → Always quote environment variable values

ArgoCD:

Sync failures → Check RBAC permissions and AppProject restrictions
Performance issues → Enable controller sharding and increase status processors
Git connection issues → Validate credentials and repository access

Crossplane:

Resource not creating → Check provider credentials and RBAC
Composition not rendering → Validate XRD and composition syntax
Provider upgrade issues → Follow version-specific upgrade paths

Getting Help

Each agent provides:

Structured troubleshooting guides
Common error patterns and solutions
Diagnostic commands for debugging
Validation procedures

Simply describe the issue and the relevant agent will guide you through resolution.

Technology Versions

Supported as of January 2025:

GitHub Actions: Node 20 runtime, actions/* v4
Helm: v3.12+
ArgoCD: v3.1+ (Kubernetes v1.30-v1.33)
Crossplane: v1.14+

Contributing

See the main CONTRIBUTING.md for guidelines.

License

MIT License - see LICENSE

cce-kubernetes: Kubernetes cluster operations and health diagnostics
cce-cloudflare: Cloudflare Workers and VPC services
cce-core: Essential hooks, commands, and universal tools

Support

For issues, questions, or feature requests:

GitHub Issues: https://github.com/nodnarbnitram/claude-code-extensions/issues
Documentation: https://github.com/nodnarbnitram/claude-code-extensions

README.md

cce-devops

Overview

Agents Included

GitHub Actions Expert

Helm Template Master

ArgoCD Experts

Crossplane Experts

Installation

Via Plugin System (Recommended)

Standalone Installation

Usage Examples

GitHub Actions Workflow Development

Helm Chart Creation

ArgoCD Setup and Configuration

Crossplane Infrastructure

When Agents Activate

Agent Capabilities Matrix

Security Features

GitHub Actions

ArgoCD

Crossplane

Performance Optimizations

GitHub Actions

ArgoCD

Helm

Troubleshooting

Common Issues

Getting Help

Technology Versions

Contributing

License

Related Plugins

Support