Kuraterte lister vs. testet katalog: hvor de feiler

Kuraterte lister vs. testet katalog: hvor de feiler

Hvorfor 'Awesome'-lister ikke er nok: En datadrevet kikk på påliteligheten til Claude-ferdigheter

Enhver utvikler kjenner mønsteret. Du utforsker et nytt økosystem – i dette tilfellet Claude-ferdigheter – og ditt første stopp er en liste kuratert av fellesskapet, sannsynligvis et GitHub-repository med tittelen 'awesome-claude-skills'. Disse listene er verdifulle for å oppdage nye verktøy. De samler hundrevis av verktøy på ett sted og gir deg en bred oversikt over hva som er mulig. Men oppdagelse er ikke det samme som validering. Et høyt antall stjerner og en velskrevet README.md er dårlige indikatorer på om en ferdighet faktisk vil fungere når du prøver å kjøre den på en reell oppgave.

Kjerneproblemet er at kuratering ofte er et mål på popularitet, ikke pålitelighet. En ferdighet blir lagt til en liste fordi den har en interessant idé eller er laget av en kjent utvikler. Den får stjerner fra folk som synes ideen er god. Svært få av disse stjernene representerer en bruker som har installert ferdigheten, integrert den i en arbeidsflyt og bekreftet at den fungerer som annonsert. Dette gapet mellom opplevd kvalitet og testet virkelighet er der utviklere mister timer på feilsøking og frustrasjon. Jakten på en virkelig 'awesome claude skills'-liste som er pålitelig nok for produksjonsbruk, ender ofte med skuffelse.

Denne artikkelen undersøker forskjellen mellom kuraterte utvalg og en katalog bygget på streng, uavhengig testing. Vi vil se på data fra vår egen prosess for å vise hvorfor du ikke kan stole på en liste som ikke publiserer sine feil.

Kurateringsfeilen: Popularitet vs. ytelse

Når vi snakker om kuraterte Claude-ferdigheter versus testede, snakker vi om to fundamentalt forskjellige verifiseringsmodeller. Kuratering baserer seg på sosialt bevis og overfladiske indikatorer:

  • GitHub Stars: Et mål på interesse, ikke funksjon.
  • Utviklerens omdømme: En god utvikler kan fortsatt publisere en ødelagt eller dårlig vedlikeholdt ferdighet.
  • Påstander i README.md: Markedsføringstekst for et verktøy. Den beskriver den ideelle tilstanden, ikke den nåværende, potensielt feilfylte.
  • Dato for siste commit: Et nyttig, men ufullstendig signal. En ferdighet kan være nylig oppdatert og likevel feile på komplekse input.

Disse signalene er nyttige for å filtrere ut fullstendig forlatte prosjekter, men de forteller deg ingenting om en ferdighets faktiske ytelse. Håndterer den 'edge cases'? Krever den tre udokumenterte miljøvariabler for å kjøre? Feiler den stille og returnerer et plausibelt, men feilaktig resultat? Kuratering svarer ikke på disse spørsmålene. Det gjør testing.

Hos SkillProof kuraterer vi ikke. Vi tester. Vi installerer hver ferdighet i et rent miljø og kjører den mot en standardisert, reell oppgave som er relevant for dens formål. Vi dokumenterer prosessen, registrerer resultatet og tildeler en poengsum. Våre funn avslører en betydelig forskjell mellom ferdighetene folk deler og de ferdighetene som faktisk fungerer.

En katalog bygget på feil

Hele vår forutsetning er bygget på en enkel, transparent prosess: vi kjører koden. Vi publiserer resultatene, enten de er gode eller dårlige. Dette gir en nøyaktighet for 'best claude skills'-lister som er umulig å oppnå kun gjennom kuratering. Du kan lese alle detaljene om prosessen vår på siden /methodology, men hovedstatistikken gir et tydelig bilde.

Per i dag har vi installert og testet 1576 unike Claude-ferdigheter. Her er en oversikt over resultatene:

  • 992 (63 %) besto testene våre og fikk en poengsum på 5/10 eller høyere. Disse ferdighetene utfører sin annonserte funksjon korrekt i vårt testtilfelle.
  • 518 krevde ikke-trivielt, ofte udokumentert, manuelt oppsett for i det hele tatt å kunne kjøre. Vi flagger disse som Needs Setup slik at utviklere vet hva de går til.
  • 66 ferdigheter scoret under basislinjen. Dette er det mest kritiske funnet: å bruke disse ferdighetene gir et dårligere resultat enn å ikke installere noen ferdighet i det hele tatt og bare bruke ren Claude. En kuratert liste vil aldri fortelle deg dette.

Den bestått-raten på 63 % er nøkkeltallet. Det betyr at hvis du velger en tilfeldig ferdighet fra en typisk, uverifisert liste, har du mer enn 1 av 3 sjanse for at den enten vil feile, kreve komplekst oppsett eller aktivt gjøre resultatet ditt dårligere. Dette er en uakseptabel feilrate for alle som prøver å bygge pålitelige applikasjoner.

Anatomien til en mislykket 'Awesome'-ferdighet

La oss se på et vanlig eksempel vi har sett dusinvis av ganger. En ferdighet for å analysere og refaktorere kode er fremtredende på en kuratert liste. Den har hundrevis av stjerner. README.md-filen viser et rent, enkelt eksempel der den transformerer en rotete funksjon til en elegant en.

Da vi testet den, var virkeligheten en annen:

  1. Installasjon: requirements.txt-filen spesifiserte en avhengighet med en versjon som er utdatert og i konflikt med moderne biblioteker.
  2. Kjøring: Å kjøre ferdigheten på vår testfil – et middels komplekst skript på 200 linjer – førte til at den hang på ubestemt tid. Den fungerte bare på det forenklede 10-linjers eksempelet fra sin egen dokumentasjon.
  3. Resultat: Da vi endelig fikk den til å kjøre på en enklere fil, hadde den refaktorerte koden den produserte syntaksfeil og besto ikke en grunnleggende linter-sjekk.

Denne ferdigheten ville vært en hyllet oppføring på en 'awesome'-liste. I vår testede katalog ville den fått en 'ikke bestått'-vurdering og en detaljert kjøringslogg som forklarer nøyaktig hvorfor den presterte dårligere enn ren Claude på oppgaven. Tabellen nedenfor oppsummerer forskjellen i perspektiv:

Måleparameter Kuratert listes syn SkillProof testet vurdering
Signal GitHub Stars, påstander i README.md Bestått/Ikke bestått på reell oppgave, poengsum /10
Oppsett Antatt pip install Dokumenterte oppsettstrinn, eller Needs Setup-flagg
Ytelse Utviklerens beskrivelse Målt mot basislinjen til ren Claude
Feil Ikke synlig eller anerkjent Publisert som en 'ikke bestått'-vurdering med kjøringslogg

En annen ferdighet vi testet, designet for å interagere med et populært API, besto kjernetesten. Den krevde imidlertid at brukeren manuelt opprettet en konfigurasjonsfil i et spesifikt format som ikke var nevnt noe sted i SKILL.md eller det tilknyttede repository-et. Det tok 45 minutter med graving i kildekoden for å finne ut av det. En kuratert liste ville bare ha lenket til den. Vi flagger den som Needs Setup og legger ved den nøyaktige konfigurasjonsfilen vi brukte for å få den til å fungere, noe som sparer neste utvikler for 45 minutter.

Det sammensatte problemet med uverifiserte ferdigheter

For en utvikler som bruker en enkelt ferdighet for en engangsoppgave, er en 37 % sjanse for feil en irritasjon. For alle som bygger systemer som setter sammen flere ferdigheter, er det en kritisk feil. Påliteligheten til en kjede av verktøy er produktet av påliteligheten til hver enkelt komponent.

Se for deg at du bygger en agent som bruker tre ferdigheter: en for å lese en fil, en for å analysere innholdet, og en for å oppsummere funnene. Hvis vi bruker vår katalogs gjennomsnittlige bestått-rate på 63 % som en proxy for påliteligheten til en hvilken som helst tilfeldig valgt ferdighet, er sannsynligheten for at alle tre lykkes i kjeden:

0.63 * 0.63 * 0.63 = 0.25

En 25 % sjanse for å lykkes. Dette er grunnen til at en skikkelig 'composio awesome claude skills review' eller enhver analyse av verktøy-sammensettende systemer må starte med den verifiserte påliteligheten til de individuelle komponentene. Uten det bygger du på sandgrunn. Å kjede sammen 'awesome'-ferdigheter som ikke er uavhengig testet, er en øvelse i å bygge komplekse, skjøre systemer som garantert vil feile.

Den eneste måten å bygge robuste agenter med flere ferdigheter på, er å bruke komponenter som er verifisert til å fungere. Du må kjenne til oppsettskravene, forventede input og ytelses-basislinjen for hver del av stakken din. En enkel lenke i en markdown-fil gir ikke den informasjonen.

Hvordan vurdere en ferdighet utover README-filen

Hvis du evaluerer en ferdighet fra en uverifisert kilde, må du bli din egen tester. Dette er tidkrevende, men nødvendig hvis du ikke har tilgang til en forhåndstestet katalog. Her er trinnene vi anbefaler, som speiler vår egen interne prosess:

  1. Isoler og installer: Installer aldri en ny ferdighet direkte i ditt primære utviklingsmiljø. Opprett et rent, virtuelt miljø (venv, conda, etc.) og installer den der. Sjekk avhengighetene den trekker inn. Er de eldgamle, eller har de kjente sårbarheter?
  2. Analyser SKILL.md: Se etter mer enn bare en beskrivelse. Finnes det et tydelig skjema for argumenter? Definerer den verktøyets funksjonssignatur, input og output-format? Mangel på et tydelig grensesnitt er et stort rødt flagg. Vi diskuterer dette mer detaljert i vårt innlegg om hva som kjennetegner en god ferdighetsdefinisjon.
  3. Design et reelt testtilfelle: Ikke bare bruk eksempelet fra utvikleren. Finn eller lag en realistisk databit eller et scenario som representerer ditt faktiske bruksområde. Hvis det er en ferdighet for koderefaktorering, gi den en rotete fil fra et av dine egne prosjekter. Hvis det er en dataanalyseferdighet, bruk et reelt datasett, ikke en perfekt 5-raders CSV-fil.
  4. Kjør og mål: Utfør ferdigheten og sjekk resultatet. Fungerer den? Er resultatet korrekt? Hvordan er ytelsen og kvaliteten sammenlignet med hva du ville fått ved å bare prompte grunnmodellen direkte? Denne sammenligningen med basislinjen er avgjørende. Hvis ferdigheten ikke gir en betydelig forbedring over ren Claude, legger den bare til kompleksitet uten noen fordel.

Denne prosessen er effektiv, men den er også en betydelig tidsinvestering for hver eneste ferdighet du vil prøve. Målet med en testet katalog er å utføre dette arbeidet én gang, for hele fellesskapet, og gjøre resultatene offentlige.

Finne ferdigheter som faktisk fungerer

Kuraterte lister er et flott utgangspunkt for å se hva fellesskapet er begeistret for. Men begeistring kjører ikke kode. For å bygge reelle applikasjoner trenger du verktøy som beviselig fungerer under realistiske forhold. Gapet mellom en stjerne på GitHub og en bestått test på en reell fil er der de fleste prosjekter snubler.

Våre data viser at en betydelig andel av offentlig tilgjengelige ferdigheter, i sin nåværende tilstand, er ødelagte, vanskelige å sette opp, eller rett og slett ikke bedre enn å bruke grunnmodellen. Å publisere disse dataene handler ikke om å kritisere utviklere; det handler om å gi den grunnleggende sannheten som trengs for å ta informerte ingeniørbeslutninger. De 66 ferdighetene vi fant som presterer dårligere enn ren Claude er ikke 'dårlige' verktøy, men de er verktøy som utviklere bør unngå til de er forbedret. Du vil ikke finne denne advarselen på en 'awesome'-liste.

I stedet for å manuelt vurdere hvert lovende verktøy fra en fellesskapsliste, kan du bruke en katalog der det arbeidet allerede er gjort. Hver ferdighet som er listet inkluderer poengsum, en kjøringsvurdering og det nøyaktige oppsettet vi brukte.

Relatert lesning: For mer om hvorfor popularitet i fellesskapet og reell kvalitet skiller seg, se popular vs. good Claude skills. Og for å forstå den grunnleggende sannheten bak hver vurdering i vår katalog, les how we test Claude skills.

Bla gjennom vår katalog med over 900 beståtte ferdigheter, sorterbare etter poengsum og kategori, for å finne verktøy du kan stole på til ditt neste prosjekt. Start med de mest pålitelige ferdighetene for koding vi har testet så langt.

★ 9.6/10 × 3

Den gratis startpakken

De 3 skillsene med våre høyeste testscorer pluss installasjonssjekklisten — oppsettet vi selv ville lagt på en fersk maskin. Gratis, på e-post.

Én e-post med pakken + en kort ukentlig oppsummering av nye testresultater. Meld deg av når du vil.