CLAUDE.md Converter

Convert GitHub repository CLAUDE.md files (AI assistant guides) into properly formatted SKILL.md files for the KillerSkills marketplace.

What This Skill Does

This skill takes CLAUDE.md files from GitHub repositories—which provide context and guidelines for AI assistants working on those projects—and transforms them into standardized SKILL.md format. The resulting skill helps other AI assistants understand repository structure, conventions, and best practices when working on similar projects.

Instructions

When a user provides a CLAUDE.md file or GitHub repository containing one:

1. **Analyze the CLAUDE.md content**

- Identify the repository type and purpose

- Extract key conventions (commit messages, branching, code style)

- Note technology stack and dependencies

- Identify common tasks and workflows

- Capture important constraints and preferences

2. **Structure the SKILL.md frontmatter**

- `name`: Create a clear, descriptive name based on repository type (e.g., "GitHub Profile README Manager", "React Component Library Guide")

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

- `version`: "1.0.0"

- `runtimes`: Use the provided runtimes array (typically `["claude-code"]`)

- `category`: Select the most appropriate category from: development, devops, writing, data, design, testing, security, documentation, automation, other

- `tags`: Extract 5-10 relevant tags from the content (languages, frameworks, tools, practices)

3. **Write clear, actionable instructions**

Your instructions should enable an AI assistant to:

- Understand the repository's purpose and structure

- Follow established conventions and patterns

- Complete common tasks correctly

- Avoid known pitfalls and anti-patterns

- Make appropriate decisions when working on the codebase

**Structure the body with:**

- Title and brief overview

- Repository context (type, tech stack, structure)

- Key conventions (commit messages, branching, code style, formatting)

- Step-by-step workflows for common tasks

- Important constraints and preferences (DO/DON'T lists work well)

- Troubleshooting tips if applicable

4. **Preserve critical details**

- Specific formatting requirements (emoji usage, badge formats, etc.)

- Security considerations

- External resource links

- File-specific notes

- Recent change history context

5. **Output format requirements**

- Output ONLY the SKILL.md content (frontmatter + body)

- NO code fences (```markdown)

- NO explanatory text before or after

- Properly formatted YAML frontmatter between `---` delimiters

- Clean markdown body with proper heading hierarchy

Examples

Example Input

```

CLAUDE.md - AI Assistant Guide

Repository Overview

**Repository Type**: GitHub Profile README

**Purpose**: Personal profile showcasing AI/MCP stack

...

```

Example Output Structure

```

---

name: "GitHub Profile README Manager"

description: "Manage GitHub profile READMEs with shields.io badges, clean formatting, and technology stack documentation following established conventions"

version: "1.0.0"

runtimes: ["claude-code"]

category: "documentation"

tags: ["github", "profile", "readme", "markdown", "badges", "shields-io", "git"]

---

GitHub Profile README Manager

[Clear instructions following the structure outlined above...]

```

Important Constraints

Validation Checklist

Before outputting, verify: