Submit a Skill

Get your e-commerce AI skill listed on ecSKILLS.

Three Ways to Get Listed

Skills appear on ecSKILLS through different channels:

Automatic Discovery

We continuously crawl skill registries and GitHub for e-commerce related skills. If your skill has a SKILL.md file or is published on a skill registry, we'll likely find it automatically.

Submit Manually

Have a skill for Shopify, Stripe, Medusa, WooCommerce, or another e-commerce tool? Submit it directly and we'll review it for the catalog.

Use the CLI

When users install your skill via the CLI, skill registries pick up the activity. We discover skills from these registries over time — but submitting directly above is the fastest way to get listed.

$npx skills add owner/repo

Creating a SKILL.md

Every skill needs a SKILL.md file in your GitHub repository. This file contains the instructions your AI agent will follow.

Example SKILL.md with frontmatter:

---
name: shopify-hydrogen
description: Build Shopify storefronts with Hydrogen
---

# Shopify Hydrogen Development

When building with Hydrogen, follow these patterns for optimal performance.

## Project Setup

1. Use the official Hydrogen template
2. Configure environment variables for Storefront API
3. Set up proper caching strategies

## Component Patterns

- Use server components for data fetching
- Keep client components minimal for hydration
- Leverage Remix's loader pattern for queries

## Common Tasks

### Adding a Product Page
When creating product pages, ensure you:
- Fetch product data with proper error handling
- Implement variant selection with URL state
- Add structured data for SEO

Frontmatter Fields

name — Unique identifier for your skill (required)
description — What the skill does and when to use it (required, max 1024 chars)

Skill Name Requirements

1–64 characters long
Lowercase alphanumeric characters and hyphens only
Cannot start or end with a hyphen
Cannot contain consecutive hyphens
Must match the parent directory name

Repository Structure

A minimal skill repository only needs a SKILL.md file. Here's a more complete structure:

your-skill/
├── SKILL.md          # Required: Skill definition
├── scripts/          # Optional: Executable scripts
├── references/       # Optional: Supporting docs
└── assets/           # Optional: Templates, schemas, data files

After Submission

Once we receive your skill, here's what happens:

AI Classification — We automatically analyze your skill and suggest relevant categories and tools
Admin Review — Our team reviews the skill to ensure it fits the e-commerce focus
Catalog Listing — Once approved, your skill appears in search results and category pages

Most skills are reviewed within a few days. The review process helps maintain quality and relevance across the catalog.

Verification

Once your skill is listed, you can request verification:

Skill verification — Marks your skill as the official skill from your organization
Publisher verification — Marks your organization as a verified vendor