pdf-capa-code

Original：🇺🇸 English

Translated

1 scriptsChecked / no sensitive code detected

Monta PDFs finalizados com capa para o VDE Concursos via Claude Code (terminal). Use esta skill sempre que o usuário fornecer um link de pasta do Google Drive de uma disciplina e pedir para montar, gerar, processar ou exportar os PDFs com capa — mesmo que não use essas palavras exatas. Frases como "monta os PDFs da disciplina X", "processa a pasta de Direito Civil", "gera os materiais finalizados" ou "coloca a capa nos docs" devem sempre acionar esta skill. Requer gws CLI autenticado e pypdf. Versão para Claude Code: usa bash puro, sem osascript.

2installs

Sourcecristianoponte/skills-cristiano

Added on2026-04-10

NPX Install

npx skill4agent add cristianoponte/skills-cristiano pdf-capa-code

SKILL.md Content

View Translation Comparison →

Skill: Montagem de PDFs com Capa — VDE Concursos (Claude Code)

Referência completa (casos extremos, troubleshooting, decisões de design):
references/complete-skill.md

Configuração

yaml

SECOES: ["Teoria Sistematizada", "Caderno de Lei"]
RADICAL_FINALIZADOS: "FINALIZADO"   # matching case-insensitive, sem 's'
RADICAL_DESTINO: "VERSÃO FINAL"     # ou "versao final"
PREFIXO_CAPA: "#CAPA"               # PDF nativo no Drive

Pré-requisitos

bash

gws --version && gws auth status 2>&1

token_valid

deve ser

true

. Se não estiver, ver

references/complete-skill.md

.

Sempre incluir nos params do gws:

"supportsAllDrives": true, "includeItemsFromAllDrives": true, "corpora": "allDrives"

Execução

1 — Extrair folder ID da URL

https://drive.google.com/drive/u/1/folders/ABC123 → ID = ABC123

2 — Listar subpastas da disciplina

bash

gws drive files list --params '{"q": "\"FOLDER_ID\" in parents and mimeType=\"application/vnd.google-apps.folder\"", "supportsAllDrives": true, "includeItemsFromAllDrives": true, "corpora": "allDrives", "fields": "files(id,name)"}' 2>&1

Filtrar por

"teoria sistematizada"

e

"caderno de lei"

(case-insensitive).

3 — Por seção: coletar IDs (repetir para cada seção)

a) Subpastas internas:

bash

gws drive files list --params '{"q": "\"SECAO_ID\" in parents and mimeType=\"application/vnd.google-apps.folder\"", "supportsAllDrives": true, "includeItemsFromAllDrives": true, "corpora": "allDrives", "fields": "files(id,name)"}' 2>&1

```
FINALIZADO_ID
```
→
```
name.lower()
```
contém
```
"finalizado"
```

VERSAO_FINAL_ID

→

name.lower()

contém

"versão final"

ou

"versao final"

b) Capa (buscar na raiz da seção; se o usuário indicou que está no FINALIZADO, usar

capa_id: null

):

bash

gws drive files list --params '{"q": "\"SECAO_ID\" in parents and name contains \"#CAPA\" and mimeType=\"application/pdf\"", "supportsAllDrives": true, "includeItemsFromAllDrives": true, "corpora": "allDrives", "fields": "files(id,name)"}' 2>&1

c) Documentos em FINALIZADO:

bash

gws drive files list --params '{"q": "\"FINALIZADO_ID\" in parents and (mimeType=\"application/vnd.google-apps.document\" or mimeType=\"application/vnd.openxmlformats-officedocument.wordprocessingml.document\")", "supportsAllDrives": true, "includeItemsFromAllDrives": true, "corpora": "allDrives", "fields": "files(id,name,mimeType)"}' 2>&1

d) Arquivos já na VERSÃO FINAL:

bash

gws drive files list --params '{"q": "\"VERSAO_FINAL_ID\" in parents", "supportsAllDrives": true, "includeItemsFromAllDrives": true, "corpora": "allDrives", "fields": "files(id,name)"}' 2>&1

4 — Executar o script (repetir para cada seção)

Copiar o script (só na primeira seção):

bash

cp '<SKILL_DIR>/scripts/process_batch.py' /tmp/process_batch.py

Escrever o config e executar:

bash

python3 -c "
import json
config = {
  'capa_id': 'ID_DA_CAPA',                   # null → script busca #CAPA em capa_fallback_folder_id
  'capa_fallback_folder_id': 'FINALIZADO_ID',
  'versao_final_id': 'ID_DA_VERSAO_FINAL',
  'existing_files': ['arquivo1.pdf'],
  'docs': [
    {'id': 'DOC_ID', 'name': '1. Nome', 'mimeType': 'application/vnd.google-apps.document'}
  ]
}
open('/tmp/batch_config_SECAO_ID.json', 'w').write(json.dumps(config, ensure_ascii=False, indent=2))
"
python3 /tmp/process_batch.py /tmp/batch_config_SECAO_ID.json 2>&1

5 — Resultado consolidado

Disciplina · DD/MM/AAAA

📚 Teoria Sistematizada  (N docs)
  ✓ X enviados · ○ Y já existiam

📚 Caderno de Lei  (N docs)
  ✓ X enviados

Erros (

✗

): listar causa e oferecer reprocessar apenas os que falharam.

Erros frequentes

Sintoma	Ação rápida
`gws: command not found`	`npm install -g @googleworkspace/cli`
`token_valid: false`	`gws auth login`
`ModuleNotFoundError: pypdf`	`pip3 install pypdf`
Capa não encontrada	Nome começa com `#CAPA` ? É PDF nativo?
`insufficientFilePermissions`	Verificar acesso de Editor no Drive

Ver

references/troubleshooting.md

e

references/complete-skill.md

para casos avançados.

pdf-capa-code

NPX Install

Tags

SKILL.md Content

Skill: Montagem de PDFs com Capa — VDE Concursos (Claude Code)

Configuração

Pré-requisitos

Execução

1 — Extrair folder ID da URL

2 — Listar subpastas da disciplina

3 — Por seção: coletar IDs (repetir para cada seção)

4 — Executar o script (repetir para cada seção)

5 — Resultado consolidado

Erros frequentes