Agent Skills: Comprehensive Validation

Language, style, and comment quality guidelines for plugin content

UncategorizedID: chkim-su/forge-editor/comprehensive-validation

Install this agent skill to your local

pnpm dlx add-skill https://github.com/chkim-su/forge-editor/tree/HEAD/skills/comprehensive-validation

Skill Files

Browse the full folder contents for comprehensive-validation.

Download Skill

Loading file tree…

skills/comprehensive-validation/SKILL.md

Skill Metadata

Name
comprehensive-validation
Description
Language, style, and comment quality guidelines for plugin content

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