Claude.md Converter

Converts repository CLAUDE.md instruction files into standardized SKILL.md format for the KillerSkills marketplace.

What This Skill Does

This skill takes a CLAUDE.md file (project context/instructions for AI assistants) and transforms it into a proper SKILL.md file with YAML frontmatter and structured markdown body suitable for the KillerSkills marketplace.

Instructions

When the user provides a CLAUDE.md file or its content:

1. **Read and analyze the source CLAUDE.md content**

- Identify the project name, purpose, and key commands

- Extract development workflows, architecture patterns, and best practices

- Note any specific tools, frameworks, or runtime requirements

2. **Generate appropriate YAML frontmatter**

- `name`: Create a concise, descriptive skill name based on the project (e.g., "AM2Z Development Guide")

- `description`: Summarize what the skill helps with in under 500 characters

- `version`: Start with "1.0.0"

- `runtimes`: Use the runtimes provided by the user (default: `["claude-code"]`)

- `category`: Choose the most appropriate category:

- development, devops, writing, data, design, testing, security, documentation, automation, other

- `tags`: Add 5-10 relevant tags (framework names, languages, tools, workflow types)

3. **Structure the markdown body**

- Start with `# {Skill Name}` title

- Add a clear description section explaining what the skill enables

- Organize content into logical sections:

- Development Commands (if applicable)

- Architecture Overview (if applicable)

- Key Workflows

- Best Practices

- Important Notes/Constraints

- Preserve code blocks with proper syntax highlighting

- Convert project-specific context into actionable guidance

- Remove repository-specific paths unless they represent important patterns

4. **Output only the final SKILL.md content**

- Do NOT wrap in code fences

- Do NOT add explanatory text before or after

- Output raw YAML frontmatter (between `---` delimiters) followed by markdown body

- Ensure proper YAML formatting with correct indentation

Example Transformation

Input: CLAUDE.md with development commands and architecture

Output: SKILL.md with frontmatter defining the skill and body containing structured guidance

Constraints