Documentation

Quick Start

Submitting Skills

Requirements

To submit a skill, your GitHub repository must meet the following requirements:

• Public repository (private repositories are not supported)
• A SKILL.md file in the root directory with proper YAML frontmatter
• Valid markdown content following the official Claude skills format

SKILL.md Format

Your SKILL.md file must include YAML frontmatter with required metadata fields:

---
name: my-skill-name
description: Brief description of what this skill does and when to use it
---

# Skill Instructions

Detailed instructions for Claude on how to use this skill.

## Key Capabilities

- Feature 1
- Feature 2

## Usage Guidelines

Step-by-step procedural guidance...

## Examples

Practical examples and use cases...

Submission Process

1. Prepare Your Repository: Ensure your GitHub repository is public and contains a SKILL.md file.
2. Submit: Navigate to the Submit Skill page and enter your repository URL.
3. Preview: Review the parsed content from your SKILL.md file.
4. Publish: Click Submit to make your skill available in the directory.

Using Skills

Finding Skills

The Browse Skills page provides several ways to discover skills:

• Search by name or description
• Filter by tags and categories
• Sort by trending, newest, or highest rated

Skill Details

Each skill page includes:

• Complete documentation from the SKILL.md file
• Installation and usage instructions
• Link to the source GitHub repository
• Author information and metadata
• Tags and categories

Managing Your Skills

Access your dashboard to:

• View all skills you've submitted
• Track views and engagement metrics
• Update skill information
• Remove skills from the directory

CLI Tool

The LMSkills CLI tool makes it easy to install skills directly to your .claude directory from GitHub repositories.

Installation

You can use the CLI without installing it globally via npx, or install it globally for the lmskills command:

# Use with npx (no installation required)
npx lmskills-cli <command>

# Or install globally
npm install -g lmskills-cli

Commands

# Install locally (project-specific)
npx lmskills-cli install https://github.com/owner/repo/tree/main/path/to/skill

# Install globally (user-wide)
npx lmskills-cli install https://github.com/owner/repo/tree/main/path/to/skill --global

# List local skills
npx lmskills-cli list

# List global skills
npx lmskills-cli list --global

# Remove local skill
npx lmskills-cli remove <skill-name>

# Remove global skill
npx lmskills-cli remove <skill-name> --global

Installation Locations

• Local: ./claude/skills/ in your current project directory
• Global: ~/.claude/skills/ in your home directory

Best Practices

Documentation

• Write clear, concise descriptions
• Include practical examples with code snippets
• Document all prerequisites and dependencies
• Provide troubleshooting guidance for common issues

Code Quality

• Follow coding best practices and conventions
• Include inline comments for complex logic
• Test thoroughly before submitting
• Keep dependencies minimal and well-documented

Maintenance

• Keep your skills updated with the latest changes
• Respond to issues and questions from users
• Update documentation when making changes
• Use versioning for major updates

API Reference

SKILL.md Architecture

Claude skills use a progressive disclosure architecture with three levels:

• Level 1 (Metadata): YAML frontmatter always loads (~100 tokens), containing name and description
• Level 2 (Instructions): Main SKILL.md content loads when triggered (<5k tokens)
• Level 3 (Resources): Additional files (scripts, templates) load on-demand

Learn more about the progressive disclosure architecture in the official documentation.

FAQ