mastra-ai/skills: skills oficiais para desenvolvimento Mastra em TypeScript

Para quem

Serve a quem vai escrever apps ou agents de IA com o framework Mastra e quer que um assistente de código siga skills oficiais. Texto oficial: são skills formais para agents que usam o framework Mastra. Mastra é um framework para construir apps e agents de IA numa stack TypeScript moderna. Sítio do framework:

https://mastra.ai/

Melhor encaixe: quem já tem um projeto TypeScript / Mastra, ou se prepara para desenvolver com a skill oficial de conjunto. A fonte descreve o conteúdo como uma «skill de conjunto única» que cobre temas posteriores com progressive disclosure e ficheiros de referência; este troço não nomeia esses ficheiros.

Antes de começar, é preciso conseguir executar npx skills add. Não trocar o caminho principal por outro instalador não verificado.

Concluir uma primeira tentativa em 3 minutos

Seguir só o comando principal de instalação do repositório. A primeira tentativa é um confronto só de leitura; ainda não gerar um agent de produção novo.

Pré-condição: esta máquina já tem npm/npx e tens o teu projeto TypeScript ou código Mastra prestes a inicializar. Não inventar um URL de repositório de exemplo.

Local de instalação: executar no espaço de trabalho:

npx skills add mastra-ai/skills

Repositório oficial:

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

Gatilho de baixo risco: depois de instalar, fazer o assistente verificar a estrutura Mastra existente contra esta skill de conjunto, só dizer que linhas oficiais vai consultar e ainda não alterar ficheiros. Se começar a criar um agent novo ou a escrever chamadas de rede, confirmar primeiro os efeitos.

Sucesso: a skill está adicionada, o assistente fala do desenvolvimento Mastra como «skill de conjunto única» e nenhum ficheiro não confirmado foi escrito. Se a skill não aparecer, primeiro confirmar que o comando de instalação está completo; não mudar para um nome de pacote não citado.

Casos de uso

Caso 1: verificação de desenvolvimento Mastra num projeto TypeScript existente. Usar a skill oficial de conjunto. Serve a quem já tem um esqueleto de app e quer completar capacidades de agent segundo a skill formal. A evidência só fala de progressive disclosure e ficheiros de referência; não nomeia ficheiros. Verificar primeiro e depois decidir se altera código.

Caso 2: descoberta via .well-known. O Mastra também suporta essa norma de descoberta; o comando oficial extra é o seguinte.

npx skills add https://mastra.ai/

O repositório serve skills através de uma RFC 8615 Well-Known URI:

https://mastra.ai/.well-known/skills/

Notas da norma:

https://github.com/cloudflare/agent-skills-discovery-rfc

Serve a quem quer descobrir skills a partir do sítio do framework. É um segundo caminho de instalação; não o misturar com o comando principal na mesma operação. A evidência não escreve que ficheiros ficam após a descoberta.

Limites de uso

O comando principal de instalação é npx skills add mastra-ai/skills. O caminho .well-known é extra, não a primeira tentativa por omissão.

A fonte só descreve uma «skill de conjunto única» e não nomeia uma pasta de skill. Não inventar um caminho skills/ nem nomes de ficheiros de referência.

São skills oficiais num framework TypeScript; não há passos de instalação para outras linguagens nem um conjunto exclusivo de assistentes.

Não inventar URL fora da documentação extra; fora do sítio do framework e da página do repositório, usar só o endereço de descoberta e a ligação RFC da fonte.