Przejdź do treści
Biblioteka skilli
Marketing i treści · Planowanie

github-discoverability

/github-discoverability

Pomaga, by repozytorium lub skill było łatwiej znaleźć: tematy GitHub, ścieżki SKILL.md, katalogi i rejestr MCP.

Licencja
MIT
Ostatnia zmiana repozytorium
31.08.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
3
Przestarzałość

Brak sygnałów. Repozytorium zmienione 31.08.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Pomaga, by repozytorium lub skill było łatwiej znaleźć: tematy GitHub, ścieżki SKILL.md, katalogi i rejestr MCP.

Wyzwalacze z opisu

found
Oryginalny opis (EN)

Make a GitHub repo or Agent Skill discoverable across the skill-aggregator ecosystem — GitHub topics, scraper-visible SKILL.md paths, instant directories (awesomeskills.dev / SkillsMP), gh skill + agentskills.io conformance, and the MCP registry. Use when someone wants their skill or repo to be "found", indexed, listed in registries/directories, surfaced by skill scrapers, or asks how aggregators discover projects on GitHub.

Jak działa

  1. How discovery actually works (three lanes)
  2. Playbook — run in this order
  3. Gotchas (hard-won)
  4. Verify
Sekcje z nagłówków SKILL.md, w oryginale · 73 linii, 605 słów
Podgląd SKILL.md
---
name: github-discoverability
description: Make a GitHub repo or Agent Skill discoverable across the skill-aggregator ecosystem — GitHub topics, scraper-visible SKILL.md paths, instant directories (awesomeskills.dev / SkillsMP), gh skill + agentskills.io conformance, and the MCP registry. Use when someone wants their skill or repo to be "found", indexed, listed in registries/directories, surfaced by skill scrapers, or asks how aggregators discover projects on GitHub.
allowed-tools: Bash, Read, Edit, WebFetch
---

# GitHub discoverability for Agent Skills

Get a repo or skill **found** by the tools people actually use to discover skills:
automated scrapers, curated lists, and registries. This is a distribution playbook,
not generic SEO — it targets the specific signals the skill ecosystem keys on.

> **Do it honestly.** Real project, real value, one accurate entry per destination.
> Topics must be genuinely relevant; descriptions come from the actual `SKILL.md`.
> Keyword-stuffing topics or spraying low-effort PRs across many lists gets a project
> **removed** from curated lists — it's negative-sum. When a curator declines, that's
> their call; don't re-submit.

## How discovery actually works (three lanes)

1. **Automated scrapers** (SkillsMP/awesomeskills.dev, GitHub `/topics` pages, `gh skill`).
   They key on **GitHub topics** and on **`SKILL.md` files at conventional paths**. Zero
   human in the loop — conform to the convention and you're indexed.
2. **Curated "awesome" lists** (VoltAgent, travisvn, ComposioHQ, tech-leads-club).
   Manual PRs, human review. Higher trust, but most **reject brand-new skills** and
   require social proof / real usage.
3. **Registries** (agentskills.io spec, `registry.modelcontextprotocol.io` for MCP
   servers). Conformance + being on GitHub is the entry condition.

## Playbook — run in this order

**1. Put `SKILL.md` where scrapers look.** The single most common miss: the skill lives
at a nested path (e.g. `integrations/foo/skills/x/SKILL.md`) that naive tree-walkers never
reach. Scrapers expect **root `SKILL.md`** or **`skills/<name>/SKILL.md`**. If your
canonical source lives elsewhere, mirror a *committed* copy to `skills/<name>/` and guard
it in CI so it can never drift (see [reference.md](reference.md) → "Mirror + drift guard").

**2. Set GitHub topics** — the highest-leverage free signal; topic-scrapers and GitHub's
own `/topics/*` pages both index them. Use the accurate core set (see reference.md). Set
via `gh repo edit --add-topic ...` or the REST `PUT /repos/{o}/{r}/topics`.

**3. Submit to instant directories.** awesomeskills.dev/SkillsMP has a no-moderation
[submit form](https://www.awesomeskills.dev/en/submit) that auto-parses your `SKILL.md`.
**Paste the repo-root URL, not a subfolder deep-link** — the auto-detector walks the tree,
and deep-links can error while the root URL succeeds.

**4. Conform to the open spec** so `gh skill search` and agentskills.io index you: valid
frontmatter (`name` + `description` minimum) and the `SKILL.md`-in-a-folder layout. No
separate submission needed — conformance + public GitHub is the entry condition.

**5. Publish to the MCP registry** *if* you ship an MCP server: keep `server.json` in
lockstep with the published npm version and run `mcp-publisher`. See reference.md.

**6. Curated lists LAST, and only when mature.** VoltAgent and travisvn explicitly reject
just-created skills ("give your skill time to mature and gain users"). Submitting a day-old
repo wastes goodwill and gets declined. Wait for stars/usage, then open **one** honest PR
per list after reading its `CONTRIBUTING.md` and checking its interaction limits.

## Gotchas (hard-won)

- **Nested `SKILL.md` is invisible** to convention scrapers → always expose a root-level path.
- **awesomeskills.dev**: submit the **repo-root URL** — its per-skill subfolder deep-link is
  unreliable (it errors, or silently accepts and never saves). Root URL indexes the repo's
  primary skill; extra skills in the same repo get picked up on their next crawl, not on submit.
- **Curated lists gate on maturity** — brand-new self-submissions are rejected by rule.
- **Over-optimizing backfires** — irrelevant topics and duplicate PRs get you delisted.
- **A generated/mirrored copy will drift** unless a CI check regenerates it and fails on diff.

## Verify

- Topics: open `https://github.com/topics/<topic>` and confirm the repo appears.
- Directory: search the directory's site/API for the repo name.
- MCP registry: `curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=<name>"`.
- Spec: `gh skill search <name>` (once the root `SKILL.md` is on the default branch).

See [reference.md](reference.md) for exact commands, endpoints, the recommended topic set,
the mirror + drift-guard pattern, and the per-destination checklist.
Pliki w paczce (2)
  • SKILL.md 5 KB
  • reference.md 4 KB

Wersje

W bazie nie ma innych skilli o nazwie github-discoverability.

Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

Migawka bazy z 13.11.2026 · wersja paczki f99e88e82d1c (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100github-better-outreach
    Przygotowuje polecenie gh z dwudziestoma tematami i nowym opisem repozytorium, żeby łatwiej je znaleźć.
  • 100github-seo
    Sprawdza nazwę, opis, tematy i README otwartego repozytorium GitHub pod kątem wyszukiwania, przed publikacją i rejestracją w katalogach MCP.
  • 100github-presence
    Optymalizuje profil GitHub, README i wykrywalność projektu, w tym gwiazdki, listy awesome i marketing na GitHubie.
  • 100github-presence
    Optymalizuje profil GitHub, README i wykrywalność projektu, w tym gwiazdki, listy awesome i marketing na GitHubie.
  • 100obsidian-plugin-seo
    Poprawia opis manifest.json, package.json i repozytorium GitHub wtyczki Obsidian, by łatwiej ją znaleźć w katalogu.
  • 100repo-readme-optimizer
    Pisze lub audytuje README i wizytówkę repozytorium GitHub tak, by lepiej pozycjonowało się w Google i było cytowane przez asystentów AI.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.