NLPM Audit: 5 bugs found in DevOps/observability skill files (NL score 89/100)
Automated audit: This issue was generated by NLPM, a natural language programming linter, running via claude-code-action. Please evaluate the findings on their merits.
Overview
NLPM (Natural Language Programming Manager) audited the skills/ directory of this repository and found an overall NL score of 89/100 across 21 skill files — an excellent baseline that reflects careful documentation work. Five bugs were identified that could cause incorrect behavior when agents follow the skill files.
Methodology
NLPM applies a 50-rule rubric to natural language programming artifacts (skill files, agent definitions, hooks). The 100-point scale starts at 100 and applies deterministic penalties for structural issues. Findings in the "Bugs" category are issues where the documented behavior contradicts itself or produces incorrect output — distinct from style/quality issues.
Bugs Found (5 total)
| # | File | Issue | PR |
|---|---|---|---|
| 1 | skills/kubesphere-devops-credentials/SKILL.md |
API examples use "type": "Opaque" but the file's own warning (lines 56–70) says Opaque breaks Jenkins credential sync — credentials will silently never sync |
#6626 |
| 2 | skills/kubesphere-fluid/SKILL.md |
YAML template at line 410: low: "{{low}} missing closing ", producing invalid YAML that fails to parse |
#6627 |
| 3 | skills/whizard-logging/SKILL.md |
Version placeholder comments say From Step 3 but only Step 1 and Step 2 are defined; correct reference is From Step 2 |
#6628 |
| 4 | skills/kubesphere-devops-pipeline/SKILL.md |
Bold heading **Step 3b: For Private Repository (with credential): is missing its closing **, breaking Markdown rendering |
#6629 |
| 5 | skills/kubesphere-devops-overview/SKILL.md |
Project Components ASCII diagram block duplicated verbatim — identical content appears twice consecutively |
#6630 |
Pull Requests
- Fix credential type bug: https://github.com/kubesphere/kubesphere/pull/6626
- Fix fluid YAML syntax error: https://github.com/kubesphere/kubesphere/pull/6627
- Fix logging step reference: https://github.com/kubesphere/kubesphere/pull/6628
- Fix pipeline markdown: https://github.com/kubesphere/kubesphere/pull/6629
- Remove duplicate overview diagram: https://github.com/kubesphere/kubesphere/pull/6630
Priority
Bug #1 (credential type) is the highest priority: agents following those examples will create credentials that silently fail Jenkins sync, causing pipeline builds to fail with "CredentialId could not be found". The remaining bugs are lower-impact formatting/reference issues.
Notes
- All PRs contain only minimal, targeted fixes — no style changes, no refactoring
- The overall quality of these skill files is high; this audit found no systemic issues
- Security findings were also identified but none reached PR-worthy threshold for the Medium/Low category in this audit pass
Thank you for maintaining such thorough documentation for the KubeSphere extension ecosystem.
Source: kubesphere/kubesphere