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.