Summary
scripts/validate-skill-structure.py reports 2 errors for plugins/agenticops/skills/audit-trail/SKILL.md because it checks for English-only section headings, but audit-trail uses Korean headings.
Reproduction
python3 scripts/validate-skill-structure.py
Output:
[1/4] Section Structure Validation
--------------------------------------------------
❌ audit-trail
Missing required section: '## When to Use'
Missing required section: '## Prerequisites'
Root Cause
validate-skill-structure.py defines required sections as:
REQUIRED_SECTIONS = [
"When to Use",
"Prerequisites",
"참고 자료",
]
But audit-trail/SKILL.md uses Korean equivalents:
| Expected (English) |
Actual (Korean) |
## When to Use |
## 언제 사용하나요 |
## Prerequisites |
## 전제 조건 |
## 참고 자료 |
## 참고 자료 ✅ |
All other 10 agenticops skills use English section headings and pass validation.
Possible Fixes
Option A — Update validate-skill-structure.py to accept both English and Korean section names:
REQUIRED_SECTIONS = [
("When to Use", "언제 사용하나요"),
("Prerequisites", "전제 조건"),
("참고 자료",),
]
Option B — Rename audit-trail's section headings to English to match the other 10 skills.
Impact
- No functional impact — this is a documentation structure check only.
Summary
scripts/validate-skill-structure.pyreports 2 errors forplugins/agenticops/skills/audit-trail/SKILL.mdbecause it checks for English-only section headings, butaudit-trailuses Korean headings.Reproduction
Output:
Root Cause
validate-skill-structure.pydefines required sections as:But
audit-trail/SKILL.mduses Korean equivalents:## When to Use## 언제 사용하나요## Prerequisites## 전제 조건## 참고 자료## 참고 자료✅All other 10 agenticops skills use English section headings and pass validation.
Possible Fixes
Option A — Update
validate-skill-structure.pyto accept both English and Korean section names:Option B — Rename
audit-trail's section headings to English to match the other 10 skills.Impact