Skip to content

Migrate to skillsaw 0.15.0 - #599

Open
not-stbenjam wants to merge 3 commits into
openshift-eng:mainfrom
not-stbenjam:migrate-skillsaw-0.15.0
Open

Migrate to skillsaw 0.15.0#599
not-stbenjam wants to merge 3 commits into
openshift-eng:mainfrom
not-stbenjam:migrate-skillsaw-0.15.0

Conversation

@not-stbenjam

@not-stbenjam not-stbenjam commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

Summary

Migrates skillsaw from 0.14.1 to 0.15.0 — Action pins (lint + review), container image, and .skillsaw.yaml config version.

The config version bump activates the new agentskill-unreferenced-files rule (dead-file detection in skills). It flagged 11 tracked files; each was investigated individually:

Skill Files Resolution
payload-autodl-json, payload-results-yaml scripts/validate.py ×2 Added a Validation section to each SKILL.md — the canonical schema validators were undiscoverable
prow-job-analyze-resource SCRIPTS.md Linked from SKILL.md (detailed docs for every script)
prow-job-analyze-resource create_inline_html_files.py Deleted — dead legacy code superseded by create_context_html_files.py (which generate_html_report.py invokes); nothing references it
jira/status-analysis summarize_issue.py, triage_issues.py, validate_feature_updates.py Documented in the skill's module table — all three are actively used by the update-weekly-status / generate-feature-updates commands
must-gather-analyzer analyze_ovn_dbs.py, analyze_windows_logs.py Added the missing OVN database and Windows node log analysis sections to SKILL.md
k8s-ocp-olm-expert config-template.json, config-example.json Referenced from the configuration setup steps

Also excludes **/__pycache__/** so local build artifacts don't trip strict lints for contributors.

Verification

skillsaw lint @ 0.15.0: 44 rules run, 0 errors, 0 warnings, grade A, exit 0 (strict mode).

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features
    • Added “Validation” guidance to multiple CI skills, including exact commands to validate generated artifacts against canonical schemas.
    • Expanded must-gather documentation with OVN database analysis and Windows node log analysis.
  • Documentation
    • Added links to detailed script documentation for one skill.
    • Updated Jira status-analysis docs with additional related scripts and clarified agent configuration file expectations.
  • Chores
    • Updated Skillsaw tooling and container image to 0.15.0, including CI workflow action pin updates and rule settings.
    • Bumped the ci plugin version to 0.0.56 in marketplace metadata and the site index; added __pycache__ exclusions.
  • Refactor
    • Removed an obsolete log-to-HTML helper script/entrypoint.

Bump the skillsaw Action pin, review Action pin, container image, and
config version to 0.15.0. The config version bump activates the new
agentskill-unreferenced-files rule (dead-file detection), which flagged
11 tracked files; each was investigated and resolved:

- payload-autodl-json, payload-results-yaml: reference scripts/validate.py
  from SKILL.md — agents can now find the canonical schema validators.
- prow-job-analyze-resource: link SCRIPTS.md (detailed script docs) from
  SKILL.md; delete create_inline_html_files.py, dead legacy superseded by
  create_context_html_files.py (nothing references it).
- jira/status-analysis: document summarize_issue.py, triage_issues.py,
  and validate_feature_updates.py in the skill's module table — all three
  are used by the update-weekly-status / generate-feature-updates commands.
- must-gather-analyzer: add missing OVN database and Windows node log
  analysis sections for analyze_ovn_dbs.py and analyze_windows_logs.py.
- k8s-ocp-olm-expert: reference the bundled config-template.json and
  config-example.json from the configuration setup instructions.

Also exclude **/__pycache__/** so local build artifacts don't trip
strict lints for contributors.

skillsaw 0.15.0 lint: 44 rules, 0 errors, 0 warnings, grade A.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@openshift-ci
openshift-ci Bot requested review from bentito and dgoodwin July 3, 2026 01:09
@openshift-ci

openshift-ci Bot commented Jul 3, 2026

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: not-stbenjam
Once this PR has been reviewed and has the lgtm label, please assign cblecker for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@openshift-ci openshift-ci Bot added the needs-ok-to-test Indicates a PR that requires an org member to verify it is safe to test. label Jul 3, 2026
@openshift-ci

openshift-ci Bot commented Jul 3, 2026

Copy link
Copy Markdown

Hi @not-stbenjam. Thanks for your PR.

I'm waiting for a openshift-eng member to verify that this patch is reasonable to test. If it is, they should reply with /ok-to-test on its own line. Until that is done, I will not automatically test new commits in this PR, but the usual testing commands by org members will still work.

Tip

We noticed you've done this a few times! Consider joining the org to skip this step and gain /lgtm and other bot rights. We recommend asking approvers on your previous PRs to sponsor you.

Once the patch is verified, the new status will be reflected by the ok-to-test label.

I understand the commands that are listed here.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

@coderabbitai

coderabbitai Bot commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: b974558f-0e7e-40c0-b813-eda72d35265e

📥 Commits

Reviewing files that changed from the base of the PR and between aca5d6e and 862a19e.

📒 Files selected for processing (1)
  • .github/workflows/lint-plugins.yml
🚧 Files skipped from review as they are similar to previous changes (1)
  • .github/workflows/lint-plugins.yml

Walkthrough

This PR updates Skillsaw references to 0.15.0, adds a __pycache__ exclusion, removes one helper script, and expands several skill documentation pages.

Changes

Skillsaw and skill documentation

Layer / File(s) Summary
Skillsaw version and workflow pins
.github/workflows/lint-plugins.yml, .github/workflows/lint-review.yml, .skillsaw.yaml, Makefile
Updates the pinned Skillsaw action references and container image from 0.14.1 to 0.15.0, and adds a **/__pycache__/** exclude entry.
Skill documentation updates
plugins/ci/skills/payload-autodl-json/SKILL.md, plugins/ci/skills/payload-results-yaml/SKILL.md, plugins/ci/skills/prow-job-analyze-resource/SKILL.md, plugins/jira/skills/status-analysis/SKILL.md, plugins/must-gather/skills/must-gather-analyzer/SKILL.md, plugins/olm-team/skills/k8s-ocp-olm-expert/SKILL.md
Adds validation instructions, script references, new Jira sub-module entries, additional must-gather analysis notes, and OLM configuration file guidance.
Inline HTML generator removal
plugins/ci/skills/prow-job-analyze-resource/create_inline_html_files.py
Deletes the script that generated inline HTML log pages and JSON path mappings.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

Suggested labels: approved, lgtm

Suggested reviewers: bryan-cox, cblecker

🚥 Pre-merge checks | ✅ 10
✅ Passed checks (10 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly matches the main change: upgrading skillsaw from 0.14.1 to 0.15.0 across workflows and config.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
No Real People Names In Style References ✅ Passed Scanned the changed workflows, skills, and docs; no real-person names appear as style refs or example prompts.
No Assumed Git Remote Names ✅ Passed The PR only changes docs/config and workflow pins; it adds no git push/fetch/remote commands or assumptions about origin/upstream remotes.
Git Push Safety Rules ✅ Passed No changed file adds git push, main/master pushes, or any force-push; the PR only updates Skillsaw pins/config and docs.
No Untrusted Mcp Servers ✅ Passed Changed files only bump skillsaw/version docs and add a lint flag; no new MCP server installs, npm/npx MCP packages, or repo-based MCP deps were added.
Ai-Helpers Overlap Detection ✅ Passed PASS: No semantically similar open PRs overlap these paths, and nearest existing skills score only ~36% similarity (below 60%).
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@stbenjam

stbenjam commented Jul 3, 2026

Copy link
Copy Markdown
Member

/ok-to-test

@openshift-ci openshift-ci Bot added ok-to-test Indicates a non-member PR verified by an org member that is safe to test. and removed needs-ok-to-test Indicates a PR that requires an org member to verify it is safe to test. labels Jul 3, 2026

@coderabbitai coderabbitai Bot left a comment

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.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@plugins/jira/skills/status-analysis/SKILL.md`:
- Around line 105-107: The status-analysis SKILL.md intro still કહે the skill
has four sub-modules, but the table now lists more entries. Update the opening
sentence in this document to match the expanded count and keep it consistent
with the sub-module list, using the surrounding section that describes the
skill’s components as the place to adjust the wording.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: 0ced5440-e593-4312-9a0e-1c60b3c7be73

📥 Commits

Reviewing files that changed from the base of the PR and between e8a963f and 7b944d1.

📒 Files selected for processing (11)
  • .github/workflows/lint-plugins.yml
  • .github/workflows/lint-review.yml
  • .skillsaw.yaml
  • Makefile
  • plugins/ci/skills/payload-autodl-json/SKILL.md
  • plugins/ci/skills/payload-results-yaml/SKILL.md
  • plugins/ci/skills/prow-job-analyze-resource/SKILL.md
  • plugins/ci/skills/prow-job-analyze-resource/create_inline_html_files.py
  • plugins/jira/skills/status-analysis/SKILL.md
  • plugins/must-gather/skills/must-gather-analyzer/SKILL.md
  • plugins/olm-team/skills/k8s-ocp-olm-expert/SKILL.md
💤 Files with no reviewable changes (1)
  • plugins/ci/skills/prow-job-analyze-resource/create_inline_html_files.py

Comment thread plugins/jira/skills/status-analysis/SKILL.md
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@stbenjam

stbenjam commented Jul 3, 2026

Copy link
Copy Markdown
Member

/ok-to-test

The skillsaw 0.15.0 action defaults no-custom-rules to true,
which skips the custom rules in .skillsaw/. Set it to false so
CI continues to enforce them.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@openshift-ci openshift-ci Bot added the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label Jul 9, 2026
@openshift-ci

openshift-ci Bot commented Jul 9, 2026

Copy link
Copy Markdown

PR needs rebase.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

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

Labels

needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. ok-to-test Indicates a non-member PR verified by an org member that is safe to test.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants