figma-create-new-file

Visão geral do skill figma-create-new-file

O que o figma-create-new-file faz

O skill figma-create-new-file cria um novo arquivo em branco no Figma, nos rascunhos do usuário, com suporte tanto para um arquivo de design padrão quanto para um quadro do FigJam. Ele é mais útil quando você já sabe que precisa de uma tela nova antes de outras ações no Figma, especialmente antes de use_figma ou de outras etapas de fluxo posteriores.

Quem deve instalar

Instale o figma-create-new-file se você trabalha em um fluxo com agente em que o modelo precisa abrir o tipo certo de arquivo de forma confiável, em vez de pedir para o usuário fazer isso manualmente. É uma boa escolha para implementação de design, prototipação rápida, preparação de workshops e qualquer prompt em que a criação de arquivo seja a primeira etapa repetível.

Por que este skill é mais do que um prompt genérico

O principal valor do skill figma-create-new-file não é só “criar um arquivo”, mas lidar com os detalhes operacionais pequenos que costumam travar a automação: escolher design ou figjam, definir um nome padrão de forma sensata e resolver o planKey obrigatório quando necessário. Isso o torna mais seguro do que uma instrução pontual quando você quer uma passagem previsível para o fluxo de trabalho do Figma.

Como usar o skill figma-create-new-file

Instale e localize a fonte

Para instalar, use o fluxo normal de adição de skills do diretório para figma/mcp-server-guide e, em seguida, abra primeiro skills/figma-create-new-file/SKILL.md. Não há arquivos auxiliares extras neste skill, então o comportamento que você precisa entender está concentrado nesse único documento. Ler o skill diretamente importa porque o caminho figma-create-new-file install é simples, mas a chamada correta ainda depende das regras de argumentos.

Passe a entrada certa no prompt

O padrão de uso do figma-create-new-file é:

/figma-create-new-file [editorType] [fileName]

Use design para um arquivo de design em branco do Figma e figjam para um arquivo no estilo quadro branco. Se você omitir editorType, o padrão será design. Se você omitir o nome, o padrão será Untitled. Prompts fortes são explícitos, por exemplo: “Crie um arquivo FigJam chamado Q3 workshop notes e depois continue com o fluxo de planejamento.”

Resolva o planKey de forma limpa

O skill pode exigir um planKey antes de conseguir chamar create_new_file. Se você já tiver um vindo de whoami ou de uma etapa anterior, inclua-o no contexto do fluxo e evite resolvê-lo de novo. Se não tiver, espere que o skill consulte whoami primeiro. Isso importa porque falhas de prompt geralmente vêm de pular o contexto de identidade ou de plano, e não da ação de criação do arquivo em si.

Leia o fluxo na ordem certa

Comece pela seção de argumentos, depois vá para a seção Workflow e, em seguida, para as instruções de Step 1: Resolve the planKey e Step 2: Call create_new_file. Essa ordem mostra o caminho real de execução: interpretar o comando, confirmar o contexto de acesso e só então criar o arquivo. Se você estiver usando figma-create-new-file for Design Implementation, esse é o caminho que leva de um briefing de design a um rascunho útil no Figma sem configuração manual extra.

Perguntas frequentes sobre o skill figma-create-new-file

O figma-create-new-file é só para arquivos de design?

Não. O skill figma-create-new-file suporta tanto design quanto figjam. Use arquivos de design para trabalho de interface e FigJam para planejamento, workshops e diagramas mais soltos.

Preciso informar um nome de arquivo toda vez?

Não. O skill usa Untitled quando nenhum nome é informado. Ainda assim, nomear o arquivo no prompt melhora a organização depois, especialmente se vários rascunhos puderem ser criados em uma única sessão.

Isso é diferente de só pedir um novo arquivo no Figma?

Sim. Um prompt comum pode descrever a intenção, mas o skill codifica os detalhes operacionais: sintaxe do comando, tipo padrão de editor, padrão de nomenclatura e comportamento de busca do plano. Isso o torna mais confiável quando o agente realmente precisa disparar a etapa de criação do arquivo.

Quando eu não devo usar?

Não use se você já tiver o arquivo alvo no Figma, se a tarefa for apenas editar um quadro existente ou se você não conseguir fornecer o contexto de acesso necessário para resolver planKey. Nesses casos, outro skill do Figma ou um fluxo de edição direta é uma opção melhor.

Como melhorar o skill figma-create-new-file

Dê ao agente a intenção exata do arquivo

A melhor forma de melhorar os resultados do figma-create-new-file é especificar o tipo de arquivo, o objetivo e o nome desejado em uma única frase. Melhor: “Crie um arquivo FigJam chamado Sprint retro para uma retrospectiva de equipe.” Pior: “Faça um arquivo no Figma.” A primeira versão reduz a ambiguidade e evita que o skill caia em um tipo de arquivo menos útil.

Mantenha o contexto do fluxo disponível

Se o seu ambiente já tiver um planKey, passe esse valor adiante em vez de forçar uma busca. Isso remove uma dependência e diminui a chance de uma execução travar. Se você não tiver esse valor, garanta que o prompt ao redor ou a sessão permitam que whoami seja executado com sucesso.

Itere a partir do primeiro arquivo em branco

Este skill só cria o arquivo; ele não resolve o problema de design. Depois que o arquivo existir, continue com a próxima ação no Figma usando o mesmo nome e o mesmo escopo que você pediu aqui. Se a primeira saída não for o que você queria, ajuste o tipo de editor, o nome do arquivo ou o contexto de acesso antes de tentar de novo, em vez de empilhar mais instruções sobre a etapa de criação.