You are a workflow automation expert specializing in creating efficient CI/CD pipelines, GitHub Actions workflows, and automated development processes. Design and implement automation that reduces manual work, improves consistency, and accelerates delivery while maintaining quality and security.
46
33%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/cicd-automation-workflow-automate/SKILL.mdQuality
Discovery
32%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 reads more like a persona/role definition ('You are a workflow automation expert') than a skill description, using second person which violates the third-person voice requirement. It provides a reasonable domain scope around CI/CD and GitHub Actions but lacks specific concrete actions, natural trigger terms users would say, and any explicit 'Use when...' guidance for skill selection.
Suggestions
Add an explicit 'Use when...' clause with trigger scenarios, e.g., 'Use when the user asks about GitHub Actions, CI/CD pipelines, deployment automation, .github/workflows files, or build/test/deploy workflows.'
Replace the persona framing ('You are a workflow automation expert') with third-person action verbs listing concrete capabilities, e.g., 'Creates and configures GitHub Actions workflows, sets up CI/CD pipelines, defines build/test/deploy stages, manages workflow triggers and secrets.'
Include common natural language trigger terms users would say, such as 'deploy', 'build pipeline', 'YAML workflow', 'GitHub Actions', '.yml', 'automated testing', 'continuous integration'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (CI/CD pipelines, GitHub Actions workflows, automated development processes) and mentions some goals (reduces manual work, improves consistency), but doesn't list specific concrete actions like 'create YAML workflow files', 'configure deployment steps', or 'set up test runners'. | 2 / 3 |
Completeness | Describes what it does at a high level but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per the rubric, a missing 'Use when...' clause caps completeness at 2, and the 'what' is also fairly vague, so this scores a 1. | 1 / 3 |
Trigger Term Quality | Includes some relevant keywords like 'CI/CD pipelines', 'GitHub Actions workflows', and 'automation', but misses common user terms like '.github/workflows', 'deploy', 'build pipeline', 'YAML', 'actions', or file extensions. The phrase 'workflow automation expert' is more of a role description than a trigger term. | 2 / 3 |
Distinctiveness Conflict Risk | The mention of 'CI/CD pipelines' and 'GitHub Actions' provides some distinctiveness, but the broad framing as 'workflow automation' and 'automated development processes' could easily overlap with general DevOps, deployment, or scripting skills. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
35%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill reads more like a high-level project brief than actionable automation guidance. It lacks any concrete code examples (e.g., sample GitHub Actions YAML), specific commands, or executable patterns that Claude could directly apply. The workflow steps are abstract directives rather than precise instructions, and nearly all substantive content is deferred to an external playbook file.
Suggestions
Add at least one concrete, executable GitHub Actions workflow YAML example (e.g., a basic CI pipeline with build/test/deploy stages) to make the skill immediately actionable.
Replace abstract instructions like 'Define pipeline stages with caching, artifacts, and quality gates' with specific, copy-paste-ready patterns showing how to implement caching, artifact handling, and quality gates.
Add explicit validation checkpoints in the workflow (e.g., 'Run `act` locally to validate workflow syntax before pushing', 'Verify secrets are configured: `gh secret list`') to improve workflow clarity.
Remove the redundant role description and 'Context' section that restate information already conveyed elsewhere, and use that space for concrete examples instead.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill has some unnecessary sections like the role description repeated from frontmatter, and the 'Context' section restates what's already implied. The 'Use this skill when' / 'Do not use this skill when' sections add moderate value but are somewhat verbose for what they convey. | 2 / 3 |
Actionability | The instructions are entirely abstract and high-level ('Inventory current build, test, and deploy steps', 'Define pipeline stages with caching'). There are no concrete code examples, no sample GitHub Actions YAML, no executable commands — just vague directives that describe rather than instruct. | 1 / 3 |
Workflow Clarity | There is a sequential list of steps in the Instructions section, and the output format provides some structure. However, there are no explicit validation checkpoints, no feedback loops for error recovery, and the steps lack specificity about when to verify or how to handle failures. | 2 / 3 |
Progressive Disclosure | There is a reference to `resources/implementation-playbook.md` for detailed patterns, which is good one-level-deep disclosure. However, the main content itself is too thin to serve as a useful overview — it delegates almost all substance to the external file without providing enough actionable content inline. | 2 / 3 |
Total | 7 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
6a07b83
Table of Contents
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.