app-listing
SKILL.md
App Listing Skill
Generate complete, high-quality Shopify App Store listing content that follows Shopify's official best practices.
Workflow
1. Understand the App
Before writing any listing content, gather deep understanding of the app:
- Read README.md, package.json, CHANGELOG.md
- Explore core source files to understand features and functionality
- Identify the target audience (merchants, developers, agencies)
- Note key differentiators vs competitors
2. Generate All Listing Sections
Produce content for each section below. Provide 2-3 options for short-form sections (Introduction, Subtitle) so the user can choose.
See references/shopify-listing-guide.md for detailed character limits, formatting rules, DOs/DON'Ts, and examples for each section.
Sections to generate:
| # | Section | Limit |
|---|---|---|
| 1 | App Introduction | 100 chars |
| 2 | App Details | 500 chars |
| 3 | Features | 80 chars each, up to 8 |
| 4 | App Card Subtitle | ~80 chars |
| 5 | App Store Search Terms | 5 terms, one idea per term |
| 6 | Web Search Content (SEO) | Title <60 chars, Meta <155 chars |
| 7 | Testing Instructions | Step-by-step, bullet points |
3. Quality Checklist
Before delivering, verify:
- All character limits respected (use count-characters.sh)
- Review Prohibited Words & Phrases - NO outcome guarantees, superlatives, or unverifiable claims
- No keyword stuffing
- Benefits-focused language (not feature-focused)
- Testing instructions are clear, step-by-step, and include prerequisites
- SEO title follows Google's title tag best practices
- Search terms use complete words, one idea per term
3.1. Character Counting
Use the provided script to verify character counts:
# Count characters for a specific section
./count-characters.sh introduction "Your app introduction text"
./count-characters.sh details "Your app details description"
./count-characters.sh feature "Real-time sales analytics"
./count-characters.sh subtitle "Better order management tools"
./count-characters.sh seo_title "My App - Order Management"
./count-characters.sh seo_meta "Description for search results"
# Show help for all options
./count-characters.sh --help
4. Output Format
Present the final listing as a structured markdown document with clear section headers, character counts, and multiple options where applicable. Use blockquotes for the actual copy.
Weekly Installs
4
Repository
toilahuongg/sho…ents-kitGitHub Stars
6
First Seen
11 days ago
Security Audits
Installed on
claude-code4
opencode3
github-copilot3
codex3
kimi-cli3
gemini-cli3