concourse-ci

Use when working with ANY Concourse CI task: writing pipelines, configuring resources, building images with oci-build-task, troubleshooting failing jobs…

Skill by Netresearch DTT GmbH

IndexedMIT AND CC-BY-SA-4.0★ 2

Write a review

Install

Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install skill/kubementat-concourse-ci

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

Use when working with ANY Concourse CI task: writing pipelines, configuring resources, building images with oci-build-task, troubleshooting failing jobs, migrating from legacy patterns, or optimizing CI/CD. Triggers on: Concourse, pipeline, fly CLI, resource type, oci-build-task, set_pipeline, concourse.yml.

Use cases: devops, data, writing, productivity

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.

Tools: No tools found
Secrets: None asked for
Install scripts: None found
Runs as: Shell scripts

Network hosts it talks to 1

codeload.github.com · found in install command

Files it touches

~/.claude/skills/concourse-ci

What's inside

Skill name: concourse-ci
Description: Use when working with ANY Concourse CI task: writing pipelines, configuring resources, building images with oci-build-task, troubleshooting failing jobs, migrating from legacy patterns, or optimizing CI/CD. Triggers on: Concourse, pipeline, fly CLI, resource type, oci-build-task, set_pipeline, concourse.yml.
License: MIT AND CC-BY-SA-4.0
Compatibility: Requires fly CLI, yq.
Metadata: author: Netresearch DTT GmbH · version: 1.4.0 · repository: https://github.com/netresearch/concourse-ci-skill
Instructions: 58 lines in SKILL.md · view on GitHub

Before installing

Ships executable scripts

Agent Skills spec issues

allowed-tools: must be a space-separated string

Files (13)

SKILL.md
checkpoints.yaml
basic-pipeline.yml · examples/
docker-build.yml · examples/
modern-ci-cd.yml · examples/
multi-branch.yml · examples/
vars-template.yml · examples/
best-practices.md · references/
core-concepts.md · references/
pipeline-syntax.md · references/
resource-types-catalog.md · references/
resources-guide.md · references/
validate-pipeline.sh · scripts/

SKILL.md (first lines)

# Concourse CI Pipeline Development

Expert guidance for writing, refactoring, and optimizing Concourse CI pipelines (v8.0+).

## When to Use

- Creating or modifying Concourse pipelines
- Configuring resources (git, registry-image, custom types)
- Building container images with `oci-build-task`
- Troubleshooting resource check failures or build issues
- Migrating from legacy patterns (docker-image, duplicate jobs)

## Quick Reference

| Task | Modern (Recommended) | Legacy (Avoid) |
|------|---------------------|----------------|
| Building images | `oci-build-task` + `registry-image` | `docker-image` resource |
| Multi-env deploys | `across` step modifier | Duplicate jobs per env |
| Dynamic pipelines | `set_pipeline` + instanced pipelines | Manual pipeline duplication |
| Notification symbols | UTF-8 characters (e.g. `\u2714` for checkmark, `\u274c` for X) | HTML entities (e.g. `&check;`, `&cross;`) |
| Resource styling | Always use `icon:` property | No icon |

## Core Concepts

Pipelines consist of **resources** (external versioned artifacts), **jobs** (sequences of steps), and optional **groups** (UI organization). All execution runs in containers.

Key step types: `get`, `put`, `task`, `set_pipeline`, `in_parallel`, `do`, `try`, `load_var`. Job hooks: `on_success`, `on_failure`, `on_error`, `on_abort`, `ensure`. Note: `on_failure` (exit code 1) differs from `on_error` (container crash) -- handle both.

See `references/core-concepts.md` for step types table, lifecycle hooks, and fly CLI essentials.

## Critical Gotchas

1. **Git tag detection after force-push** -- Escape regex dots, enable `clean_tags: true`, separate read/write resources. See `references/resources-guide.md`.
2. **registry_mirror format mismatch** -- `registry-image` expects an object (`host: mirror`), `docker-image` expects a URL string. Provide separate formats in `CONCOURSE_BASE_RESOURCE_TYPE_DEFAULTS`. See `references/resources-guide.md`.
3. **GitLab Container Registry JWT auth** -- The JWT endpoint lives on the GitLab host, not the registry host. Discover via `Www-Authenticate` header. See `references/resources-guide.md`.

## References

- `references/pipeline-syntax.md` -- Complete YAML schema for pipelines, jobs, resources
- `references/core-concepts.md` -- Step types, lifecycle hooks, fly CLI essentials
- `references/resources-guide.md` -- Git-resource, registry-image, docker-image migration, gotcha details
- `references/best-practices.md` -- Optimization, troubleshooting, notifications, deployment patterns
- `references/resource-types-catalog.md` -- Available resource types (Ansible, Terraform, etc.)

### Examples

Working examples in `examples/`:
- `basic-pipeline.yml` -- Build-test-deploy with versioning
- `modern-ci-cd.yml` -- oci-build-task, across, build_log_retention
- `multi-branch.yml` -- Dynamic branch pipelines with set_pipeline
- `docker-build.yml` -- Container image build and push
- `vars-template.yml` -- Variable file organization

### Validation

Use `scripts/validate-pipeline.sh` to check pipeline syntax before deployment.

From Kubementat/ai_agent_skills, MIT AND CC-BY-SA-4.0.

Signals

Stars: 2
Forks: 0
Open issues: 0
Last commit (this folder): Apr 14, 2026 (6 months ago)

From GitHub (fetched Oct 24, 2026).

Details

Version: 1.4.0
License: MIT AND CC-BY-SA-4.0
Repository: github.com/Kubementat/ai_agent_skills
First seen: Oct 24, 2026
Last checked: Oct 24, 2026
Source: GitHub github-graphql