SkillShelf

SkillShelf is an open-source catalog of production-ready AI workflows for ecommerce teams. Use proven skills for audits, writing, merchandising, and research in Claude, ChatGPT, and other tools that support the SKILL.md / Agent Skills format.

• For: ecommerce operators, marketers, merchandisers, and consultants
• Use it to: run repeatable workflows instead of rewriting prompts from scratch
• Works with: Claude, ChatGPT, and tools that support Agent Skills

Browse the catalog on skillshelf.ai

What is a skill?

A skill is a set of instructions that tells an AI model what to do, what format to follow, and what good output looks like. Instead of writing a detailed prompt from scratch each time, you load a skill and get consistent, production-ready results.

Each skill is a folder containing a SKILL.md file (the core instructions) and optionally a skillshelf.yaml sidecar file (catalog metadata), examples, and supporting files.

Using a skill

1. Browse the skill catalog or look through the skills/ directory in this repo
2. Open the skill's SKILL.md file
3. Copy the contents into Claude, ChatGPT, or your preferred AI tool
4. Follow the skill's instructions with your own input data

You can also install skills via the CLI:

npx skills add timctfl/skillshelf -s brand-voice-extractor

Skill directory structure

skills/
  brand-voice-extractor/
    SKILL.md              # Core instructions (required)
    skillshelf.yaml       # SkillShelf catalog metadata
    references/           # Example outputs, glossaries, supporting docs
      example-output.md
      glossary.md
  write-positioning-overview/
    SKILL.md
    skillshelf.yaml
    references/
      example-positioning-brief.md

See the existing skills in skills/ for complete examples of what a finished skill looks like.

Creating a skill

There are two paths:

Use the Skill Writer (recommended). The Skill Writer is a skill that builds other skills. It is purpose-built for ecommerce workflows and walks you through the entire process in conversation. Upload it to Claude or ChatGPT, describe the task you want to automate, and it produces a complete skill directory with all the right files and documentation. See the full guide on skillshelf.ai for a step-by-step walkthrough.

Write by hand. If you want full control, write a SKILL.md file by hand following the SKILL.md specification. The Skill Authoring Guide covers input design, output structure, example conventions, and quality standards.

Submitting a skill

Website. Go to skillshelf.ai/submit and upload your .skill or .zip file. The site opens a pull request on your behalf.

GitHub. Fork this repo, add your skill under skills/your-skill-name/, and open a pull request. See CONTRIBUTING.md for the full process and requirements.

Every skill on SkillShelf goes through a certification review before it is published. All accepted skills are published under the Apache 2.0 license.

Reference

• SKILL.md Specification: format, frontmatter fields, validation rules
• Skill Authoring Guide: best practices for writing effective skills
• Glossary Specification: how to write glossaries for downstream skill consumption
• Contributing Guide: submission process, PR requirements, metadata reference
• Agent Skills open standard: the cross-platform format SkillShelf skills are built on

License

Skills and documentation are published under the Apache 2.0 license.

Built and maintained by Cartful.