Skip to content
Skills Library
AI & agents · Conversion & formats

skill-standardization

/skill-standardization

Standardize and validate SKILL.md files to match the project specification. Use when creating new skills, converting existing skills to standard format, or validating skill file structure. Handles section heading conversion, frontmatter standardization, and missing section detection.

Licence
Apache-2.0
Last repository change
15.07.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 15.07.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

Standardize and validate SKILL.md files to match the project specification. Use when creating new skills, converting existing skills to standard format, or validating skill file structure. Handles section heading conversion, frontmatter standardization, and missing section detection.

Original author description

Standardize and validate SKILL.md files to match the project specification. Use when creating new skills, converting existing skills to standard format, or validating skill file structure. Handles section heading conversion, frontmatter standardization, and missing section detection.

How it works

  1. When to use this skill
  2. Instructions
  3. Available Scripts
  4. Section Heading Conversions
  5. Standard SKILL.md Structure
  6. Examples
  7. Best practices
  8. References
Original SKILL.md headings · 142 lines, 490 words
SKILL.md preview
---
name: skill-standardization
description: Standardize and validate SKILL.md files to match the project specification. Use when creating new skills, converting existing skills to standard format, or validating skill file structure. Handles section heading conversion, frontmatter standardization, and missing section detection.
allowed-tools: Bash Read Write Edit Glob Grep
metadata:
  tags: skill-management, standardization, validation, automation, scripting
  platforms: Claude, ChatGPT, Gemini
---


# 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:

```bash
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:

```bash
python3 scripts/remove_duplicates.py
```

### Step 3: Final cleanup

For any remaining non-standard headings:

```bash
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

```markdown
---
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

```python
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

```bash
# 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

- [README.md](../../README.md) - Repository overview and SKILL.md conventions
- [.agent-skills/README.md](../README.md) - Skill repository structure and examples

Versions

RepositoryScoreLicence
This page · autohandai/community-skills100Apache-2.0
akillness/jeo-skills95MIT

Identical content appears in 1 other GitHub folders. We show one copy with the highest score.

Database snapshot: 13.11.2026 · package version a29ee6aa471e (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100skill-creation
    Create or refactor Agent Skills following the agentskills.io specification. Use when creating new skills, converting prompts to skills, or validating skill structure. Triggers: "create skill", "new skill", "SKILL.md", "agent skill", "convert prompt".
  • 100skill-writer
    Guide users through creating Agent Skills for Claude Code. Use when the user wants to create, write, author, or design a new Skill, or needs help with SKILL.md files, frontmatter, or skill structure.
  • 100create-skill
    Scaffolds new agent skills for the dotnet/skills repository. Use when creating a new skill, generating SKILL.md files, writing a skill description that the runtime will actually route to, or setting up skill directory structures. Handles frontmatter generation, section…
  • 100skill-creator
    How to create new skills for this HQ — format, frontmatter, content structure. Use when you need to add a new skill to this repository, or when reviewing whether an existing skill is well-formed.
  • 95creating-agent-skills
    Use when creating Agent Skills packages (SKILL.md format) for Codex CLI, GitHub Copilot, or Amp - provides the agentskills.io specification with frontmatter constraints, directory structure, and validation rules
  • 100skill-writer
    Guide users through creating Agent Skills for Claude Code. Use when the user wants to create, write, author, or design a new Skill, or needs help with SKILL.md files, frontmatter, or skill structure.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.