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

スコア

総合スコア

60/100

リポジトリの品質指標に基づく評価

✓SKILL.md

SKILL.mdファイルが含まれている

+20

✓LICENSE

ライセンスが設定されている

+10

○説明文

100文字以上の説明がある

0/10

○人気

GitHub Stars 100以上

0/15

○最近の活動

3ヶ月以内に更新がある

0/10

○フォーク

10回以上フォークされている

0/5

✓Issue管理

オープンIssueが50未満

+5

✓言語

プログラミング言語が設定されている

+5

○タグ

1つ以上のタグが設定されている

0/5

レビュー

💬

レビュー機能は近日公開予定です