Skill Standardization

When to use this skill

• Creating new SKILL.md files following the standard template
• Converting existing skills with non-standard section headings
• Validating skill files against the project specification
• Batch processing multiple skill files for consistency
• Ensuring all skills have required sections (Examples, Best practices, References)

Instructions

Step 1: Run the conversion script

Execute the main conversion script to standardize all SKILL.md files:

cd /path/to/.agent-skills
python3 scripts/convert_skills.py

This script will:

• Convert Korean section headings to English
• Standardize frontmatter (add missing tags, platforms)
• Add missing required sections with templates

Step 2: Remove duplicate sections

If files have duplicate sections after conversion:

python3 scripts/remove_duplicates.py

Step 3: Final cleanup

For any remaining non-standard headings:

python3 scripts/final_cleanup.py

Available Scripts

Script	Purpose
convert_skills.py	Main conversion script - handles section headings, frontmatter, missing sections
remove_duplicates.py	Removes duplicate Examples, Best practices, References sections
final_cleanup.py	Direct string replacement for remaining Korean headings

Section Heading Conversions

Korean	English
## 목적 (Purpose)	## Purpose
## 사용 시점 (When to Use)	## When to use this skill
## 작업 절차 (Procedure)	## Instructions
## 작업 예시 (Examples)	## Examples
## 베스트 프랙티스	## Best practices
## 참고 자료	## References
## 출력 포맷 (Output Format)	## Output format
## 제약사항 (Constraints)	## Constraints
## 메타데이터	## Metadata
### N단계:	### Step N:

Standard SKILL.md Structure

---
name: skill-name
description: Clear description (max 1024 chars)
tags: [tag1, tag2]
platforms: [Claude, ChatGPT, Gemini]
---

# Skill Title

## When to use this skill
- Scenario 1
- Scenario 2

## Instructions

### Step 1: [Action]
Content...

### Step 2: [Action]
Content...

## Examples

### Example 1: [Scenario]
Content...

## Best practices
1. Practice 1
2. Practice 2

## References
- [Link](url)

Examples

Example 1: Convert a single file manually

from pathlib import Path
import re

filepath = Path('backend/new-skill/SKILL.md')
content = filepath.read_text()

# Convert Korean to English
content = content.replace('## 베스트 프랙티스', '## Best practices')
content = content.replace('## 참고 자료', '## References')
content = re.sub(r'### (\d+)단계:', r'### Step \1:', content)

filepath.write_text(content)

Example 2: Validate a skill file

# Check for required sections
grep -E "^## (When to use|Instructions|Examples|Best practices|References)" SKILL.md

Best practices

1. Run all three scripts in sequence for complete standardization
2. Review changes before committing to ensure content wasn't lost
3. Keep section content - only headings are converted, not content
4. Test with one file first when making script modifications

References

• CONTRIBUTING.md - Full specification for SKILL.md files
• templates/basic-skill-template/SKILL.md - Standard template