Submit a skill

Skills are submitted via GitHub pull request. There's no web form yet — that lands in v1.1. The workflow is intentionally simple: fork, add a folder, validate, open a PR.

1. Read the docs

Skim the skill author guide and the moderation policy. Five minutes. It saves both of us a back-and-forth.

2. Fork the skills repo

https://github.com/localskills-ai/skills

3. Add your skill folder

# Country-scoped (most common)
skills/nz/<your-slug>/
  skill.json
  README.md
  SKILL.md
  LICENSE
  CHANGELOG.md

# Sub-region scoped (state, city, province)
skills/nz-akl/<your-slug>/
  ...

# Global (rare)
skills/global/<your-slug>/
  ...

Use whatever country code applies to your skill — every ISO 3166-1 country is supported.

4. Validate locally

cd skills
node scripts/validate.mjs nz/<your-slug>

This must pass before opening a PR. CI runs the same checks.

5. Open a PR

Title: add: <your-slug> — <one-line description>

Body:

• Who the skill is for
• What it does
• A worked example (input → output)
• What it does not do (scope limits matter)
• Anything reviewers should know about its permissions

6. Review

• Automated review runs immediately on PR open and on every push.
• AI review (Claude) scores the skill across six dimensions.
• A moderator reviews the AI scores and your PR.
• For high-safety skills (anything that moves money or authenticates against real services) we run a sandbox test before merging.

We aim for first contact within 48 hours. Approved skills publish automatically.