comprehensive-validation

chkim-su 的头像作者 chkim-su

插件内容的语言、风格和注释质量指南。

📖 中文导读:插件内容的语言、风格和注释质量指南。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: comprehensive-validation description: Language, style, and comment quality guidelines for plugin content category: quality tools: []

Comprehensive Validation

Guidelines for content quality: language usage, emoji placement, and comment hygiene.

Core Principle

English for LLM consumption, localized text only for user-facing output.

When to Use

  • Before plugin_publish workflow
  • When W037 (Korean) or W038 (emoji) warnings appear
  • Reviewing documentation quality
  • Cleaning up debug artifacts

Quick Reference

Content Type Rule Example
Skill/Agent descriptions English only description: "Analyze code quality"
Code comments English only # Check file existence
CLI output (print/console.log) OK to localize print("Success") or print("OK")
Error messages in exceptions English preferred raise ValueError("Invalid input")
Frontmatter fields English only Never use emoji/Korean in YAML
Markdown headers English preferred ## Process not ## 프로세스

Validation Codes

Code Check Enforcement
W037 Korean in non-localized content Warning (BLOCKING for publish)
W038 Emoji in inappropriate locations Warning (BLOCKING for publish)

Enforcement Levels

Workflow W037/W038
skill_creation WARNING
agent_creation WARNING
command_creation WARNING
plugin_publish BLOCKING
quick_fix WARNING
analyze_only WARNING

Cleanup Commands

# Run validation to detect issues
python3 scripts/validate_all.py . --content-quality

# Detailed semantic analysis (uses content-quality-analyzer agent)
# Requires Task tool invocation with form-selection-auditor

References

  • references/language-guidelines.md - When Korean vs English
  • references/style-guidelines.md - Emoji and formatting rules
  • references/comment-hygiene.md - TODO/FIXME/debug code rules