diff --git a/README.md b/README.md
index 064cc5d..3549350 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,22 @@
-# pulse-skills
+# Pulse Skills 🛠
 
-Pulse Agent — pulse-skills
\ No newline at end of file
+Coleção de skills extraídas de fontes externas, organizadas por domínio.
+
+## Estrutura
+
+```
+devops/    — gitea-api, docker-deploy, openclaw-config, security-audit
+testing/   — e2e-testing-patterns, vitest-setup
+frontend/  — react, vue, nextjs, typescript
+backend/   — node, fastapi, python-script
+ai/        — nova-self-improver, multi-search-engine, agent-browser
+infra/     — linux-system, redis-labs, xcloud-docker
+```
+
+## Convenção
+
+Cada skill é um arquivo `.md` com:
+- **O que faz** — capacidade principal
+- **Comandos/padrões** — snippets prontos para usar
+- **Gotchas** — armadilhas documentadas
+- **Padrões recomendados** — do AGENTS.md / MEMORY.md