---
title: "Xcode 27: exportar as skills de agente da Apple para usar na CLI"
description: "O Xcode 27 traz skills de desenvolvimento escritas pela própria Apple e um comando que as exporta como Markdown para Codex, Claude, Cursor ou qualquer agente de linha de comando."
canonical: "https://ronanrodrigo.dev/notes/xcode-27-skills-agente-cli"
markdown: "https://ronanrodrigo.dev/notes/xcode-27-skills-agente-cli.md"
last-updated: "2026-09-17"
---
## Exportar as skills de agente que acompanham o Xcode 27

O Xcode 27 integra os agentes de IA ao editor — Codex, Claude e Gemini — e já vem com várias skills de desenvolvimento embutidas. Quem prefere continuar na linha de comando pode exportá-las em um passo e levá-las para o provedor de agente favorito. O comando é:

```bash
xcrun agent skills export --output-dir ~/.agents/skills
```

A exportação gera bundles `SKILL.md` — `references/` e `scripts/` incluídos — que qualquer ferramenta que leia o formato Agent Skills consome. O ganho é usar orientação escrita pela própria Apple em vez de documentação raspada, especialmente em APIs recentes que o treino do modelo não cobre.

O conjunto exportado nesta versão traz dez skills:

- `swiftui-whats-new-27` — o que mudou no SwiftUI nas releases 27
- `swiftui-specialist` — padrões, fluxo de dados, modificadores e desempenho em SwiftUI
- `building-document-based-swiftui-applications` — apps baseados em documentos com SwiftUI
- `app-intents-whats-new-27` — novidades de App Intents
- `app-intents-specialist` — implementação de App Intents
- `uikit-app-modernization` — modernizar apps UIKit para múltiplas janelas e cenas
- `modernize-tests` — migrar suítes XCTest para Swift Testing
- `adopt-c-bounds-safety` — adoção da extensão de bounds safety do C
- `audit-xcode-security-settings` — endurecer build settings de segurança do projeto
- `device-interaction` — verificar o app em dispositivo ou simulador

## Como a Apple descreve skills e expertise dentro do Xcode

A documentação oficial explica que o Xcode usa esse conhecimento automaticamente conforme o prompt e também permite invocar uma skill pelo comando de barra (`/plan`, por exemplo), listando todas ao digitar `/` no campo de mensagem. Skills próprias e MCPs adicionais entram por arquivos de configuração em `~/Library/Developer/Xcode/CodingAssistant/` ou por plug-ins instalados nas configurações de Intelligence.

[Leia a documentação da Apple](https://developer.apple.com/documentation/xcode/extending-and-customizing-agents)

## Opções do comando e o que fazer quando o `agent` não é encontrado

O `--output-dir` escolhe o destino e o `--replace-existing` sobrescreve skills já exportadas, o que importa porque a exportação é um snapshot e não se atualiza sozinha. Se o `xcrun` reclamar que não conhece o subcomando `agent`, o diretório de developer ativo pertence a um Xcode anterior ao 27: vale checar com `xcode-select -p`, trocar em Settings → Locations → Command Line Tools ou apontar só para aquele comando via `DEVELOPER_DIR`.

[Veja o passo a passo do Sarunw](https://sarunw.com/posts/export-xcode-agent-skills/)

## Nem toda skill funciona fora do Xcode

Skills que apenas leem e editam código-fonte viajam bem: `swiftui-specialist`, `swiftui-whats-new-27` e as de teste são usadas sem o Xcode aberto. Já as que dependem das ferramentas internas do agente do Xcode degradam — `audit-xcode-security-settings` cai para edição manual do `.pbxproj` e `device-interaction` não tem o que chamar do lado de fora. A regra prática: se a skill só toca arquivos do projeto, funciona em qualquer agente; se depende da configuração do projeto ou de um dispositivo ligado, é melhor rodar dentro do Xcode.

[Leia a análise na SwiftLee](https://www.avanderlee.com/ai-development/using-xcode-27s-agent-skills-in-claude-codex-and-cursor/)

## Snapshot por release para acompanhar o que muda

Como as skills são contribuídas pelos plugins internos do Xcode e o conteúdo muda a cada versão, um repositório mantém o snapshot de cada release e regenera com um script de exportação — útil para ver em diffs o que a Apple alterou e para reexportar depois de atualizar o Xcode. O snapshot da release 27.0 registra 13 skills no total, sendo 10 as "globalmente disponíveis" que o comando exporta.

[Consulte o repositório](https://github.com/raven/xcode-agent-skills)