CtrlK
BlogDocsLog inGet started
Tessl Logo

jenkinsfile-validator

Comprehensive toolkit for validating, linting, testing, and automating Jenkinsfile pipelines (both Declarative and Scripted). Use this skill when working with Jenkins pipeline files, validating pipeline syntax, checking best practices, debugging pipeline issues, or working with custom plugins.

67

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

78%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, highly actionable skill body with excellent progressive disclosure into a real, verified bundle of references and scripts. The main cost is redundancy: the description is restated, the default command is shown twice, and the plugin-lookup workflow is duplicated across two sections.

Suggestions

Deduplicate the plugin-lookup guidance: keep the detailed 5-step workflow in one place and reference it from 'Claude's Workflow' step 3 instead of restating it.

Remove the verbatim restatement of the frontmatter description in the opening paragraph and the repeated default command in 'Command Options' (the 'Full Validation (Recommended)' block already shows it).

Add an explicit feedback loop to 'Claude's Workflow': after providing inline fixes, re-run 'bash scripts/validate_jenkinsfile.sh <file>' to confirm the issues are resolved.

DimensionReasoningScore

Conciseness

The body is mostly efficient with no padding explaining concepts Claude already knows, but it could be tightened: the opening paragraph repeats the frontmatter description verbatim, the default validation command appears both in 'Full Validation (Recommended)' and again in 'Command Options', and the plugin-lookup workflow is stated twice in near-duplicate (the 'Plugin Lookup Workflow' section versus step 3 of 'Claude's Workflow'). That is more than the 'minor instances' of anchor 4 but well short of the heavy padding of anchor 2.

3 / 5

Actionability

Fully executable, copy-paste-ready guidance throughout: concrete bash invocations for every mode ('bash scripts/validate_jenkinsfile.sh --syntax-only Jenkinsfile', '--strict'), the script architecture map, shared-library validation commands, and named MCP tools with exact query strings ('mcp__context7__resolve-library-id with query "jenkinsci <plugin-name>"'). This matches the anchor-5 example of executable commands covering the common cases.

5 / 5

Workflow Clarity

'Claude's Workflow' gives a clear numbered 5-step sequence (run validation, optionally read the file, look up unknown plugins, report results with line numbers/severity, provide inline fixes) with validation up front and error-handling direction in step 5. It stops short of anchor 5 because there is no explicit re-validate-after-fix feedback loop; the operations are read-only validation, so the destructive/batch cap does not apply.

4 / 5

Progressive Disclosure

A lean overview that pushes detail into six one-level-deep, well-signaled reference files, every one of which exists in the bundle (references/validation_rules.md, common_plugins.md, declarative_syntax.md, scripted_syntax.md, best_practices.md, troubleshooting.md), plus six documented scripts that all exist on disk. Inline content stays at overview altitude and links are explicit (e.g., 'See [references/validation_rules.md](references/validation_rules.md) for detailed rules'), matching the anchor-5 structure.

5 / 5

Total

17

/

20

Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description with explicit what-and-when structure, natural trigger phrases, and a clear Jenkins pipeline niche. Its only weaknesses are slight over-claiming ('testing', 'automating'), a few missing trigger synonyms, and the broadly-worded 'custom plugins' trigger that could over-fire.

DimensionReasoningScore

Specificity

The description lists several concrete actions ("validating, linting, testing, and automating Jenkinsfile pipelines (both Declarative and Scripted)") with named pipeline types, matching the 'several specific actions; minor gaps' anchor. It falls short of 5 because 'testing' and 'automating' are less concrete than the validation/linting the skill actually delivers, and it is a touch above 3 since it goes well beyond naming just 1-2 actions.

4 / 5

Completeness

It clearly answers both questions: the 'what' ("Comprehensive toolkit for validating, linting, testing, and automating Jenkinsfile pipelines") and an explicit 'when' clause ("Use this skill when working with Jenkins pipeline files, validating pipeline syntax, checking best practices, debugging pipeline issues, or working with custom plugins") with multiple concrete trigger phrases, exactly matching the anchor-5 example pattern. Not 4 because the 'when' is already fully explicit and specific.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "Jenkins pipeline files", "validating pipeline syntax", "checking best practices", "debugging pipeline issues", and "custom plugins" are phrases users would plausibly say. It misses common variations like "Groovy", "shared library", "lint", or the .Jenkinsfile file extension, so it fits anchor 4 rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The Jenkinsfile/Jenkins-pipeline niche is distinct with pipeline-specific triggers, but the unqualified trailing trigger "or working with custom plugins" could pull the skill in for non-Jenkins plugin work, giving minor overlap risk consistent with anchor 4. It is well above anchor 3 because the core triggers (Jenkinsfile, Jenkins pipeline syntax) are unambiguous.

4 / 5

Total

17

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
pantheon-org/tekhne
Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.