Skip to content

Add lint workflow claude skill#75

Closed
michalchecinski wants to merge 3 commits intomainfrom
add-lint-workflow-claude-skill
Closed

Add lint workflow claude skill#75
michalchecinski wants to merge 3 commits intomainfrom
add-lint-workflow-claude-skill

Conversation

@michalchecinski
Copy link
Copy Markdown

@michalchecinski michalchecinski commented Mar 30, 2026

🎟️ Tracking

📔 Objective

Add the bitwarden-github-workflows plugin, which provides a lint-workflows skill that runs Bitwarden's bwwl linter against GitHub Actions workflow files and automatically fixes detected errors.

@michalchecinski michalchecinski requested a review from a team as a code owner March 30, 2026 12:48
@github-actions
Copy link
Copy Markdown

github-actions bot commented Mar 30, 2026

Logo
Checkmarx One – Scan Summary & Detailsb0f79635-2309-4a34-95ef-08f808d7d62c

Great job! No new security vulnerabilities introduced in this pull request

@theMickster
Copy link
Copy Markdown
Contributor

Hi @michalchecinski 👋🏼
Will you please fill out the PR description with a Jira story and details on the work being submitted for review? If you don't have a Jira story yet, then will you please write up a good story under Epic PM-33452. Thank you very much!


### Step 3: Fix Detected Errors

Use the Read tool to examine workflow files with errors, then use the Edit tool to fix them. Fix only errors, not warnings or other findings.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤔 I almost missed "Fix only errors, not warnings or other findings." What do you think about moving this to Step 2? In my head it makes sense to filter non-errors when parsing the output.

🌱 Along those same lines, would there be value in adding a flag to bwwl so it only returns errors? That would reduce the amount of "thinking" Claude must do before starting the real work we want it do.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Moved the ask to filter the results. Also, I've added the error only option to the workflow linter here.

@theMickster theMickster added the ai-review-vnext Request a Claude code review using the vNext workflow label Mar 31, 2026
@theMickster theMickster marked this pull request as draft March 31, 2026 08:30
@theMickster theMickster marked this pull request as ready for review March 31, 2026 08:30
@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 1, 2026

Bitwarden Claude Code Review

Overall Assessment: APPROVE

This PR adds a new bitwarden-github-workflows plugin with a lint-workflows skill that drives Bitwarden's bwwl linter to detect and auto-fix errors in GitHub Actions workflow files. The plugin structure is complete with plugin.json, marketplace entry, CHANGELOG, and README. The SKILL.md provides clear step-by-step execution instructions with appropriate error handling guidance and reporting templates.

No new findings. The previously identified critical issue (missing plugin.json) has been resolved.

Copy link
Copy Markdown
Contributor

@theMickster theMickster left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems like we addressed some of these things in another PR. I'm a little confused though, Is this one supposed to be still opened?

- **Verification**: Re-runs the linter after fixes to confirm all errors are resolved
- **Structured Reporting**: Summarizes what was changed and any remaining issues requiring manual attention

## Skills
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Please trim down the skill description to something more along the lines of what we have done here. We are intentionally keeping these details out of the README.md because we intend to have the SKILL.md speak for itself. Also, too much detail like the following become overly burdensome to maintain overtime.


## Maintainers

- @team-ai-sme
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

❌ We need to consider changing this to the actual engineering team that will maintain the plugin overtime.

Please consider adding the BRE team as a co-owner to the plugin in the code owners file.


## Overview

This plugin provides a skill that runs Bitwarden's internal workflow linter (`bwwl`) against GitHub Actions workflow files, parses the results, and automatically fixes detected errors.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

♻️ Please make this more generic to describe the vision for what the plugin will contain over time.


## Features

- **Automated Linting**: Runs `bwwl lint` on `.github/workflows/` and captures all errors
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⛏️ Let's try to trim this down as well to only 2-bullets. Adding four bullets per skill is going to become a pain to maintain over time.

"description": "Application security engineering assistant for vulnerability triage, threat modeling, and secure code analysis."
},
{
"name": "bitwarden-github-workflows",
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤔 I don't like that we have introduced the github name here specifically because it ties us into a specific platform plugin (we do have a couple of these, but I am strongly considering removing the atlassian-reader skill altogether now that we have the MCP in place).

We have followed the pattern of either persona plugins or very specific utility plugins.
How about one of these instead?

  1. bitwarden-devops-engineer
    • a neutral, broad, well-known name
    • allows us to group all sorts of skills independent of how we name internal teams
    • does not refer to a specific bitwarden team/role per-sey
  2. bitwarden-build-release-engineer
    • a more targeted name to a bitwarden role
    • could set a implied/perceived division that encourages someone to build a bitwarden-shot-engineer that has too many cross-applicable skills

My advice and preference is the first. Thoughts?

@michalchecinski
Copy link
Copy Markdown
Author

@theMickster @SaintPatrck I'm going to close this PR, as @vgrassia added a refined skill in his PR as a part of broader BRE skills initiative. Let's work on those there.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ai-review-vnext Request a Claude code review using the vNext workflow

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants