woodpecker-ci

Operate and troubleshoot Woodpecker CI deployments, pipelines, and incidents.

40|6|Updated Jul 11, 2026
One-click install
npx skills add https://github.com/magnus919/agent-skills --skill woodpecker-ci-magnus919
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: woodpecker-ci
Source: https://github.com/magnus919/agent-skills/tree/main/woodpecker-ci
Command: npx skills add https://github.com/magnus919/agent-skills --skill woodpecker-ci-magnus919

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This skill resolves the complexity of managing distributed CI/CD pipelines by providing a structured, evidence-based framework for Woodpecker CI deployment, configuration, and incident response.

Core Features & Use Cases

  • Deployment Orchestration: Standardizes the setup of Woodpecker servers and agents using Docker Compose or Kubernetes, ensuring consistent environment contracts.
  • Pipeline Lifecycle Management: Provides templates and linting workflows to design, validate, and secure CI pipelines, including secret management and plugin integration.
  • Incident Diagnosis: Offers a systematic troubleshooting loop and failure-signature mapping to quickly isolate issues across forge integrations, agent connectivity, and backend execution.

Quick Start

Use the woodpecker-ci skill to diagnose why the current pipeline is failing by running the connectivity doctor script and checking the agent logs.

Frequently Asked Questions about woodpecker-ci

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot a Woodpecker CI pipeline that is failing?▼

Troubleshoot Woodpecker CI pipeline failures by running a connectivity doctor script to verify forge integration and reviewing agent logs to isolate execution backend issues.

How do I deploy a Woodpecker CI server and agents using Docker Compose?▼

Deploy Woodpecker CI servers and agents using Docker Compose by standardizing environment contracts to ensure consistent infrastructure setup across distributed CI/CD pipelines.

Why does my Woodpecker CI agent lose connection to the server?▼

Woodpecker CI agent connection loss is diagnosed through a systematic troubleshooting loop that maps failure signatures to backend execution issues and verifies agent registration.

Can I run Woodpecker CI pipelines on a Kubernetes backend?▼

Woodpecker CI supports Kubernetes backends for pipeline execution, allowing you to orchestrate containerized CI/CD workflows while maintaining consistent environment contracts.

How do I validate and lint Woodpecker CI workflow syntax?▼

Validate Woodpecker CI workflow syntax using provided linting workflows and templates to properly design, secure pipelines, and manage secrets before pipeline execution.

What do I need to check when Woodpecker CI cannot connect to my forge?▼

Check Woodpecker CI forge connectivity by verifying standard CLI tool access and running diagnostic scripts to ensure proper integration with your Git repository provider.