Skip to main content
Welcome to the ASO Skills contributing guide. This documentation covers how to add new skills, improve existing ones, and follow the project’s guidelines.

​
Ways to Contribute

​
Add a New Skill

Create specialized skills for ASO and app marketing tasks. See Adding Skills for detailed instructions. Good skill candidates:
  • Keyword research workflows
  • Metadata optimization strategies
  • A/B testing frameworks
  • Competitor analysis methods
  • App Store or Google Play specific features

​
Improve Existing Skills

Good contributions include:
  • Fix outdated App Store guidelines or character limits
  • Add missing frameworks or scoring rubrics
  • Improve output templates
  • Add real-world examples
  • Update for new Apple/Google features (In-App Events, Custom Product Pages, etc.)

​
Submission Process

1

Fork and Branch

Fork the repository and create a feature branch:
# For new skills
git checkout -b feature/skill-name

# For fixes
git checkout -b fix/skill-name-desc

# For documentation
git checkout -b docs/desc
2

Make Changes

Add or modify skills following the skill structure requirements.
3

Validate

Run the validation script to ensure your skill meets all requirements:
bash validate-skills.sh
Must pass with 0 errors before submitting.
4

Open Pull Request

Submit a PR with a clear description of your changes.Use conventional commit format:
  • feat(skill-name): add new capability
  • fix(skill-name): correct metadata limits
  • docs: update contributing guide

​
Validation

The validation script (validate-skills.sh) checks:
  • Frontmatter exists and is valid YAML
  • name field matches directory name
  • description includes trigger phrases
  • Name format follows pattern: ^[a-z0-9]([a-z0-9-]{0,62}[a-z0-9])?$
  • No consecutive hyphens in name
  • Description length is 1-1024 characters
  • SKILL.md file is under 500 lines (warning)
Run validation locally before submitting: 
bash validate-skills.sh

​
Repository Structure

skills/<name>/SKILL.md     — Skill instructions (required, <500 lines)
skills/<name>/references/  — Detailed docs loaded on demand (optional)
tools/integrations/        — API integration guides (Appeeky, Firebase, etc.)
tools/REGISTRY.md          — Capability matrix: which skill uses which tool

​
Compatible Directories

Skills work with multiple agent systems:
  • .cursor/skills/
  • .agents/skills/
  • .claude/skills/
  • .codex/skills/

​
Next Steps

Adding Skills

Learn the skill structure and requirements

Agent Guidelines

Understand writing style and formatting

Build docs developers (and LLMs) love

Get started for freeTalk to us