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 Legacy heading Standard heading

Purpose (legacy)

Purpose

When to Use (legacy)

When to use this skill

Procedure (legacy)

Instructions

Examples (legacy)

Examples

Best Practices (legacy)

Best practices

References (legacy)

References

Output Format (legacy)

Output format

Constraints (legacy)

Constraints

Metadata (legacy)

Metadata

Step N (legacy):

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 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 ( )

Normalize legacy headings to standard

content

content . replace ( '## Best Practices' , '## Best practices' ) content = content . replace ( '## Reference' , '## References' ) content = re . sub ( r'### Step (\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 Run all three scripts in sequence for complete standardization Review changes before committing to ensure content wasn't lost Keep section content - only headings are converted, not content Test with one file first when making script modifications References README.md - Repository overview and SKILL.md conventions .agent-skills/README.md - Skill repository structure and examples