bird-chinese-community/BIRD.skills / birdcc-cicd
birdcc-cicd
VerifiedBuild or review GitHub Actions workflows for BIRD 2/3 projects using bird-chinese-community/setup-birdcc and @birdcc/cli. Use for pull-request lint/format/parse checks, BIRD2/BIRD3 matrices, BIRD_BIN, changed config files, pnpm/Turbo caching, submodule configs, action pinning, or .github/workflows changes. Route local config work to bird-agent and local editor/CLI installation to birdcc-installer.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.9 KB |
| agents/openai.yaml | config | 369 B |
| assets/logo-small.png | binary | 2.9 KB |
| assets/logo.png | binary | 6.5 KB |
| evals/evals.json | config | 3.6 KB |
| metadata.json | config | 490 B |
| plugin.json | config | 480 B |
| references/setup-birdcc.md | markdown | 4.5 KB |
references/setup-birdcc.md
View on GitHub# `setup-birdcc` GitHub Actions Reference
`setup-birdcc` prepares checkout, Node.js, pnpm, dependency and Turbo caches, optional Rust, and an
optional BIRD 2/3 binary. It does not run lint commands and does not guarantee a global `birdcc`.
## Config-only repository
Use an ephemeral CLI and disable dependency/Turbo work:
```yaml
name: BIRD config
on:
pull_request:
paths:
- "**/*.conf"
- "**/*.bird"
- "**/*.bird2"
- "**/*.bird3"
- "bird.config.json"
- "birdcc.config.json"
push:
branches: [main]
paths:
- "**/*.conf"
- "**/*.bird"
- "**/*.bird2"
- "**/*.bird3"
- "bird.config.json"
- "birdcc.config.json"
permissions:
contents: read
jobs:
validate:
runs-on: ubuntu-latest
steps:
- name: Set up BIRD tooling
id: setup
uses: bird-chinese-community/setup-birdcc@v1.0.0
with:
bird-version: "2"
install-dependencies: "false"
cache-turbo: "false"
- name: Check formatting
run: pnpm --package=@birdcc/cli@latest dlx birdcc fmt bird.conf --check
- name: Lint and parse
run: pnpm --package=@birdcc/cli@latest dlx birdcc lint bird.conf --bird
env:
BIRD_BIN: ${{ steps.setup.outputs.bird-bin }}
```
`pnpm --package=<package> dlx <binary>` unambiguously selects the scoped package and its `birdcc`
binary.
## Locked pnpm project
If `package.json` declares `@birdcc/cli`, keep `install-dependencies` enabled and use the lockfile:
```yaml
- name: Set up BIRD tooling
id: setup
uses: bird-chinese-community/setup-birdcc@v1.0.0
with:
bird-version: "2"
cache-turbo: "false"
- run: pnpm exec birdcc fmt bird.conf --check
- run: pnpm exec birdcc lint bird.conf --bird
env:
BIRD_BIN: ${{ steps.setup.outputs.bird-bin }}
```
The action resolves and caches the pnpm store when `install-dependencies: "true"`. It then runs
`pnpm install --frozen-lockfile --prefer-offline` by default. There is no `cache-pnpm` input.
Set `cache-turbo: "true"` only for a Turborepo that uses the configured `.turbo` path.
## Existing checkout
The action checks out by default. If another step must control checkout:
```yaml
- uses: actions/checkout@v4
with:
fetch-depth: 0
- id: setup
uses: bird-chinese-community/setup-birdcc@v1.0.0
with:
checkout: "false"
```
Keep `fetch-depth: 0` for the `changed-config-files` output.
## BIRD 2/3 matrix
Use a matrix only when the same configuration is intentionally compatible with both majors:
```yaml
strategy:
fail-fast: false
matrix:
bird-version: ["2", "3"]
steps:
- id: setup
uses: bird-chinese-community/setup-birdcc@v1.0.0
with:
bird-version: ${{ matrix.bird-version }}
install-dependencies: "false"
cache-turbo: "false"
- run: pnpm --package=@birdcc/cli@latest dlx birdcc lint bird.conf --bird
env:
BIRD_BIN: ${{ steps.setup.outputs.bird-bin }}
```
If BIRD 2 and BIRD 3 have separate entries, create a matrix object that pairs each version with its
own file instead of testing both binaries against one file.
## Current important inputs
| Input | Default | Meaning |
| --- | --- | --- |
| `checkout` | `true` | Run checkout inside the composite action |
| `fetch-depth` | `0` | Preserve history for changed-file detection |
| `install-dependencies` | `true` | Run the configured pnpm install command |
| `cache-turbo` | `true` | Cache only the Turbo cache path |
| `install-bird` | `true` | Install a BIRD binary on supported runners |
| `bird-version` | `2` | Select BIRD major 2 or 3 |
| `bird-package-source` | `auto` | Select `auto`, `ubuntu`, or `cznic` |
| `submodule-paths` | empty | Shallow-initialize selected config submodules |
| `harden-runner` | `false` | Opt into step-security hardening |
## Outputs
| Output | Use |
| --- | --- |
| `bird-bin` | Set `BIRD_BIN` or invoke the exact binary |
| `bird-version` | Record the installed runtime version |
| `turbo-cache-hit` | Inspect only when Turbo caching is enabled |
| `changed-config-files` | Newline-separated changed BIRD files in PR context |
Do not expand `changed-config-files` with an unquoted shell substitution. Read it line-by-line and
validate paths before passing them to commands.
## Supply-chain choice
- `@v1.0.0`: the currently published readable, immutable release.
- `@v1`: use only after verifying that the movable major tag exists; it was absent during the
2026-07-29 upstream audit.
- full reviewed commit SHA: strongest pin for protected config repositories.
- `@main`: testing upstream action changes only.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |