jenkinsfile-validator

Jenkinsfile Validator Skill

Use this skill to validate Jenkins pipelines and shared libraries with local scripts first, then optionally enrich findings with plugin documentation.

Trigger Phrases

Use this skill when requests look like:

• "Validate this Jenkinsfile"
• "Check this pipeline for security issues"
• "Lint my Declarative/Scripted pipeline"
• "Why is this Jenkins pipeline failing syntax checks?"
• "Validate vars/.groovy or src/**/.groovy shared library files"

Scope

This skill validates:

• Declarative pipelines (pipeline { ... })
• Scripted pipelines (node { ... } and Groovy-style pipelines)
• Shared library files (vars/*.groovy, src/**/*.groovy)
• Hardcoded credential patterns
• Pipeline best practices and maintainability signals

Prerequisites

Run commands from repository root unless noted.

Required tools

• bash
• grep
• sed
• awk
• head
• wc
• find (needed for shared-library directory scans)

Recommended tools

• jq (optional; improves JSON-heavy troubleshooting workflows)

Script prerequisites

• Scripts live in devops-skills-plugin/skills/jenkinsfile-validator/scripts/
• Main orchestrator can run child scripts even if +x is missing (it uses bash fallback)
• If you want direct execution (./script.sh), make scripts executable:

chmod +x devops-skills-plugin/skills/jenkinsfile-validator/scripts/*.sh

Preflight check (recommended)

SKILL_DIR="devops-skills-plugin/skills/jenkinsfile-validator"

command -v bash grep sed awk head wc find >/dev/null && echo "required tools: ok" || echo "required tools: missing"
command -v jq >/dev/null && echo "jq: installed (optional)" || echo "jq: missing (optional)"

[ -d "$SKILL_DIR/scripts" ] && echo "scripts dir: ok" || echo "scripts dir: missing"
[ -f "$SKILL_DIR/scripts/validate_jenkinsfile.sh" ] && echo "main validator: ok" || echo "main validator: missing"

Quick Start (Normalized Paths)

Use a single base path variable to avoid path ambiguity.