skill-manager

Files (1)

• SKILL.md

SKILL.md (first lines)

# Skill Manager

Permite que o NewClaw se auto-expanda instalando novas skills de forma segura.

## Fluxo Completo de Instalação

### Etapa 1 — Buscar skills disponíveis

Se o usuário mencionar skills.sh ou quiser explorar:

```
web_navigate action=open url=https://www.skills.sh
```

Para buscar skills por tipo:
```
web_navigate action=open url=https://www.skills.sh/?q=TERMO_DE_BUSCA
```

Para ver detalhes de uma skill específica, seguir os links da página.

### Etapa 2 — Obter o comando de instalação

O skills.sh mostra comandos no formato:
```
npx skills add <URL_DO_REPOSITORIO> --skill <nome>
```

Anotar a URL do repositório GitHub para a próxima etapa.

### Etapa 3 — Estágio e auditoria (OBRIGATÓRIO antes de ativar)

**Nunca instalar diretamente na pasta `./skills/` sem auditar antes.**

Identifique o SO do ambiente atual antes de escolher o bloco abaixo — `git clone` é o mesmo nos
três sistemas, só o restante muda.

Linux/macOS:
```bash
# Criar diretório de staging se não existir
mkdir -p /tmp/skill_staging

# Clonar o repositório
git clone "<URL_REPO>" /tmp/skill_staging/<NOME_SKILL>

# Verificar estrutura básica e frontmatter obrigatório (name: e description:)
ls /tmp/skill_staging/<NOME_SKILL>/
cat /tmp/skill_staging/<NOME_SKILL>/SKILL.md 2>/dev/null || echo "Sem SKILL.md"
# O SKILL.md DEVE começar com frontmatter YAML delimitado por --- contendo 'name:' e 'description:'. Sem 'name:', o SkillLoader não carrega a skill.
```

Windows (PowerShell):
```powershell
# Criar diretório de staging se não existir
New-Item -ItemType Directory -Force -Path "$env:TEMP\skill_staging" | Out-Null

# Clonar o repositório
git clone "<URL_REPO>" "$env:TEMP\skill_staging\<NOME_SKILL>"

# Verificar estrutura básica e frontmatter obrigatório
Get-ChildItem "$env:TEMP\skill_staging\<NOME_SKILL>"
if (Test-Path "$env:TEMP\skill_staging\<NOME_SKILL>\SKILL.md") {
    Get-Content "$env:TEMP\skill_staging\<NOME_SKILL>\SKILL.md" -TotalCount 10
} else {
    "Sem SKILL.md"
}
# O SKILL.md DEVE conter frontmatter YAML delimitado por --- com 'name:' e 'description:'. Sem isso, o SkillLoader registrará 'SKILL.md sem nome' e ignorará a skill.
```

### Etapa 4 — Executar auditoria de segurança

Seguir o protocolo completo da skill **skill-auditor**. Identifique o SO do ambiente atual antes
de escolher o bloco — a lógica dos 7 padrões é a mesma, só a ferramenta de busca muda.

Linux/macOS:
```bash
SKILL_PATH="/tmp/skill_staging/<NOME_SKILL>"

# 3.1 Prompt Injection
grep -rniE "ignore (previous|all|above|prior) instructions|disregard|override (your|all)|forget (you are|your role)|new persona|act as (an? )?(unrestricted|DAN|jailbreak)|you are now|system prompt" "$SKILL_PATH" --include="*.md" --include="*.txt"

# 3.2 Acesso a arquivos sensíveis
grep -rniE "/etc/(passwd|shadow|sudoers)|~/.ssh|~/.aws|\.env|id_rsa|\.pem|authorized_keys|credentials|secret" "$SKILL_PATH"

# 3.3 Variáveis de ambiente sensíveis
grep -rniE "(API_KEY|SECRET_KEY|ACCESS_TOKEN|PASSWORD|PRIVATE_KEY|DATABASE_URL|OPENAI_API|ANTHROPIC_API|AWS_SECRET)\s*[=:]" "$SKILL_PATH"

# 3.4 Exfiltração
grep -rniE "(curl|wget|fetch)\s.*(http|https)://" "$SKILL_PATH"

# 3.5 Comandos perigosos
grep -rniE "rm\s+-rf\s+/|chmod\s+777|eval\s*\(|exec\s*\(|shell=True|\$\(.*\)" "$SKILL_PATH"

# 3.6 Downloads ocultos
grep -rniE "npm install|pip install|apt(-get)? install|wget .* -O|curl .* \|" "$SKILL_PATH"

# 3.7 Ofuscação
grep -rniE "base64|atob|btoa|eval\(atob|fromCharCode" "$SKILL_PATH"
```

Windows (PowerShell — `Select-String` é o equivalente de `grep`, `-Pattern` já é case-insensitive
por padrão):
```powershell
$SkillPath = "$env:TEMP\skill_staging\<NOME_SKILL>"

# 3.1 Prompt Injection
Get-ChildItem $SkillPath -Recurse -Include *.md,*.txt | Select-String -Pattern "ignore (previous|all|above|prior) instructions|disregard|override (your|all)|forget (you are|your role)|new persona|act as (an? )?(unrestricted|DAN|jailbreak)|you are now|system prompt"

# 3.2 Acesso a arquivos sensíveis
Get-ChildItem $SkillPath -Recurse -File | Select-String -Pattern "/etc/(passwd|shadow|sudoers)|~/.ssh|~/.aws|\.env|id_rsa|\.pem|authorized_keys|credentials|secret"

# 3.3 Variáveis de ambiente sensíveis
Get-ChildItem $SkillPath -Recurse -File | Select-String -Pattern "(API_KEY|SECRET_KEY|ACCESS_TOKEN|PASSWORD|PRIVATE_KEY|DATABASE_URL|OPENAI_API|ANTHROPIC_API|AWS_SECRET)\s*[=:]"

# 3.4 Exfiltração
Get-ChildItem $SkillPath -Recurse -File | Select-String -Pattern "(curl|wget|fetch)\s.*(http|https)://"

# 3.5 Comandos perigosos
Get-ChildItem $SkillPath -Recurse -File | Select-String -Pattern "rm\s+-rf\s+/|chmod\s+777|eval\s*\(|exec\s*\(|shell=True|\$\(.*\)"

From rovanni/NewClaw, MIT.

More from rovanni/NewClaw