developing-buildkite-pipelines

YAML drift occurs when pipeline configurations diverge from current Buildkite documentation. This Skill reads official docs first, then validates your pipeline YAML against step-types, dynamic-pipelines, plugins, and environment variable references to ensure configurations stay current and avoid outdated patterns.

Yes. This Skill references official Buildkite documentation to validate syntax, check plugin usage, and verify dynamic pipeline patterns. Use dry-run commands and consult current references in step-types.md and dynamic-pipelines.md to catch errors early.

Run the update-docs.sh script to fetch the latest official Buildkite documentation. This ensures your references for index.md, step-types.md, dynamic-pipelines.md, and other docs reflect current API and patterns before modifying pipelines.

Reference official Buildkite documentation on plugin usage before configuring. This Skill grounds plugin, artifact, and environment variable configurations in current docs, preventing reliance on training data that may contain outdated plugin patterns or deprecated syntax.

Yes. This Skill applies to writing, modifying, and debugging dynamic pipelines, dependencies, plugins, artifacts, and environment variables by consulting official Buildkite references, ensuring configurations remain accurate across pipeline complexity.

Buildkite features and syntax evolve; training data grows stale. Reading official documentation first prevents YAML drift and ensures pipeline configurations use current step-types, dynamic-pipeline mechanics, and plugin APIs rather than outdated or incorrect patterns.