CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

source-command-setup-ci-cd

Implement pre-commit hooks and GitHub Actions for quality assurance

Quality

79%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/source-command-setup-ci-cd/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

86%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.

The content is a lean, well-structured command template with concrete tool names, a clear four-step sequence, and an explicit verification step. Its only meaningful gap is the lack of any example configuration snippet or an error-recovery loop for when pipeline checks fail.

DimensionReasoningScore

Conciseness

The body is lean and directive throughout — "Use this skill when the user asks to run the migrated source command `setup-ci-cd`", compact tool lists, and closing directives ("Use free/open-source tools. Respect existing configs. Keep execution fast."). It assumes Claude's competence with no explanations of known concepts, matching the anchor where every token earns its place rather than leaving over-explanation to trim.

5 / 5

Actionability

As an instruction-only skill the absence of code is not penalized, and the guidance is concrete: named tools per category ("Prettier/Black/gofmt/rustfmt", "ESLint/Ruff/golangci-lint/Clippy", "Bandit/gosec/cargo-audit/npm audit"), a concrete path (".github/workflows/"), and specific behaviors ("Mirror pre-commit checks on push/PR"). It is not 5 because no example .pre-commit-config.yaml or workflow snippet covers the common case, and not 3 because it is far more specific than pseudocode-level guidance.

4 / 5

Workflow Clarity

Four clearly sequenced numbered steps end with an explicit verification checkpoint: "**Verify pipeline**: Test locally, create test PR, confirm all checks pass". It is not 5 because there is no error-recovery feedback loop (what to do when a check fails), and not 3 because validation is explicitly present rather than missing or implicit.

4 / 5

Progressive Disclosure

The skill is under 50 lines, single-purpose, has no bundle files, and is well-organized into a short intro plus a Command Template section, so the simple-skill exception applies and well-organized sections alone justify a 5. It is not 4 because no content exists that would belong in separate reference files.

5 / 5

Total

18

/

20

Passed

Description

61%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.

The description is concise and names two concrete, specific technologies, giving it a clear niche and decent trigger terms. Its main weaknesses are the complete absence of a "when to use" clause and missing natural synonyms like "CI/CD" and "pipeline", which limit completeness and trigger-term coverage.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to set up CI/CD, pre-commit hooks, GitHub Actions workflows, or quality checks for a repository."

Include the natural synonyms "CI/CD", "pipeline", and "continuous integration" as trigger terms, since the skill name itself is setup-ci-cd but none of these words appear in the description.

Enumerate the concrete actions more fully (e.g. "configure formatting, linting, security, and type-checking hooks; create workflow files in .github/workflows/") to lift specificity from 1-2 actions to comprehensive coverage.

DimensionReasoningScore

Specificity

"Implement pre-commit hooks and GitHub Actions" names two concrete, specific deliverables, matching the anchor for naming a domain plus 1-2 concrete actions without comprehensive coverage. It is not 4 because coverage has real gaps (no mention of linting, formatting, security scanning, or pipeline verification), and not 2 because it is far more concrete than the generic "Processes PDF files" example.

3 / 5

Completeness

The "what" is clear ("Implement pre-commit hooks and GitHub Actions for quality assurance") but there is no "Use when..." clause or equivalent trigger guidance, which caps completeness at 3 per the judging guidelines. It is not 4 because the "when" is entirely absent rather than merely imprecise.

3 / 5

Trigger Term Quality

"pre-commit hooks" and "GitHub Actions" are natural phrases users would say when they need this skill, giving good keyword coverage. It is not 5 because common synonyms like "CI/CD", "pipeline", or "continuous integration" are missing (despite the skill name being setup-ci-cd), and not 3 because coverage clearly exceeds the single-keyword anchor example.

4 / 5

Distinctiveness Conflict Risk

"pre-commit hooks and GitHub Actions" carves out a specific DevOps niche with only minor overlap risk against general GitHub or linting skills. It is not 5 because no trigger phrases further distinguish it, and not 3 because it names specific technologies rather than a broad domain.

4 / 5

Total

14

/

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

tonykay/transcriber

Path

.agents/skills/source-command-setup-ci-cd/SKILL.md

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.