woodpecker-ci

Configure Woodpecker CI pipelines for Docker builds and deployments on Gitea/Forgejo.

Updated Feb 2, 2026
One-click install
npx skills add https://github.com/JNZader-Vault/project-starter-framework --skill woodpecker-ci
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: woodpecker-ci
Source: https://github.com/JNZader-Vault/project-starter-framework/tree/main/.ai-config/skills/infrastructure/woodpecker-ci
Command: npx skills add https://github.com/JNZader-Vault/project-starter-framework --skill woodpecker-ci

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides patterns and guidance for setting up and optimizing container-native Continuous Integration pipelines using Woodpecker CI, specifically for self-hosted environments with Gitea or Forgejo.

Core Features & Use Cases

  • Container-Native Pipelines: Every step of your CI process runs in an isolated container, ensuring consistency and reproducibility.
  • Gitea/Forgejo Integration: Tailored for users of these self-hosted Git platforms.
  • Monorepo Support: Efficiently manage independent workflows for different services within a single repository.
  • Use Case: Configure a Woodpecker CI pipeline to automatically build, test, and deploy a Docker image whenever code is pushed to the main branch of your Gitea repository.

Quick Start

Configure a basic Woodpecker CI pipeline to build a Node.js application on push events to the main branch.

Frequently Asked Questions about woodpecker-ci

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

FAQPage Schema
How do I configure Woodpecker CI pipelines for a self-hosted Gitea repository?

Woodpecker CI pipelines for a Gitea repository are configured using container-native syntax where every step runs in an isolated container. This Skill provides pipeline patterns, secrets management, and conditional execution rules to automate builds and deployments efficiently.

Can I run matrix builds and Docker builds in Woodpecker CI?

Yes, you can run matrix builds and Docker builds in Woodpecker CI. This Skill provides configuration patterns for executing parallel matrix builds across multiple environments and automating Docker image builds within isolated container steps.

What is the best way to structure monorepo workflows in Woodpecker CI?

The best way to structure monorepo workflows in Woodpecker CI is by defining independent workflows for different services within a single repository. This Skill outlines monorepo strategies to efficiently isolate and manage containerized workflows for individual service paths.

Does Woodpecker CI work with Forgejo for container-native continuous integration?

Woodpecker CI works directly with Forgejo to provide container-native continuous integration. It is specifically tailored for self-hosted platforms like Forgejo, ensuring every CI process step runs consistently in an isolated container environment.

What are common anti-patterns to avoid when setting up Woodpecker CI pipelines?

Common Woodpecker CI anti-patterns include improper secrets handling and inefficient pipeline step structuring. This Skill details critical anti-patterns to help you avoid configuration mistakes and optimize your container-native CI/CD workflows.