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

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

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

Step 2: Remove duplicate sections

python3 scripts/remove_duplicates.py

Step 3: Final cleanup

python3 scripts/final_cleanup.py

Available Scripts

convert_skills.py

remove_duplicates.py

final_cleanup.py

Section Heading Conversions

## 목적 (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