> ## Documentation Index
> Fetch the complete documentation index at: https://chatcli.edilsonfreitas.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills Embutidas

> Um pacote de skills de produtividade/pesquisa/dev embarcado no binário e semeado no startup — presente em qualquer instalação (go install, brew, release).

O ChatCLI agora **embarca um conjunto de skills essenciais dentro do binário** e as semeia em `~/.chatcli/skills/` no startup. Antes, skills só existiam no `.agent/skills/` do projeto (visível apenas dentro do checkout do repo) ou via [skills.sh](/pt/features/skill-registry) (instalação remota opt-in) — um usuário que instalava por `go install`/brew ficava **sem nenhuma skill**. Agora elas vêm por padrão.

<Info>
  Inspirado no espectro de skills do hermes-agent, mas cada skill foi **reescrita para as ferramentas do próprio ChatCLI** (`@coder`/Bash, `@webfetch`/`@websearch`, `@send`, `@scheduler`, `@read`/`@search`) — nada de infra fechada de terceiros. Keyless-first e **agnóstico de SO** (ramos para macOS, Linux e Windows).
</Info>

***

## Como o seeding funciona

No startup, `pkg/persona/builtin` materializa cada `SKILL.md` embutido em `~/.chatcli/skills/<nome>/`. É **idempotente e seguro contra edição**, via um manifesto de hash (`.builtin-manifest.json`):

| Situação                                     | Ação                             |
| -------------------------------------------- | -------------------------------- |
| Skill ausente                                | instala                          |
| Sem edição, mas desatualizada (release novo) | atualiza                         |
| **Editada pelo usuário**                     | **preserva** (nunca sobrescreve) |
| Já em dia                                    | nada                             |

Funciona em **todo método de instalação** (go install, Homebrew, release baixado), não só checkout do repo. As skills ficam visíveis e editáveis em disco.

***

## Skills incluídas

**Produtividade & sistema**
`send-message` · `email` · `calendar` · `reminders` · `notes` · `imessage`

**Pesquisa & conhecimento**
`web-research` · `arxiv` · `obsidian` · `huggingface`

**Documentos & mídia**
`pdf-tools` · `ocr` · `youtube` · `presentations` · `paper-writing` · `mermaid-diagrams` · `ascii-art`

**Localização & casa**
`maps` (OpenStreetMap/OSRM, keyless) · `hue-lights` (bridge local, keyless)

**Dev & dados**
`github` (gh CLI) · `jupyter` · `webhooks`

**Serviços (token do próprio usuário)**
`notion` · `linear` · `airtable`

**Meta**
`skill-authoring` — ensina o agente a [criar e evoluir suas próprias skills](/pt/features/skill-authoring)

***

## Auto-ativação

Cada skill declara `triggers:` no frontmatter; quando uma frase do usuário casa com um trigger, a skill é injetada no contexto automaticamente (`FindAutoActivatedSkills`). Você também pode invocar manualmente via `/<nome-da-skill>`.

<Tip>
  As skills priorizam os tools **agnósticos de SO** (`@send`, `@scheduler`) e detectam a CLI nativa disponível (himalaya/gcalcli/osascript/PowerShell), degradando com uma dica de instalação em vez de chutar.
</Tip>

***

## Relacionado

* [Auto-autoria de Skills (@skill)](/pt/features/skill-authoring) — criar, evoluir, stats e packs
* [Skill Registry (skills.sh)](/pt/features/skill-registry) — instalar skills da comunidade
* [Agentes Customizáveis](/pt/features/customizable-agents)