✍️ Manual de Operação: Editor Editorial Artes do Sul (aswriter)

Documento de Referência: EDITOR.md
Skill Instalada: C:\Users\aragu\.gemini\config\skills\aswriter\SKILL.md
Status: Ativo & Integrado Globalmente
Data de Criação: 18 de Agosto de 2026

📌 Visão Geral

O aswriter (Editor Artes do Sul) é uma skill global concebida para automatizar a ingestão, formatação de alta performance editorial (Score > 95), geração e conversão de assets de mídia (.webp) e sincronização de artigos e xartigos criados em qualquer workspace ou projeto externo diretamente para o repositório central D:\artesdosul\artesdosul.

🔄 Fluxo de Automação (Cross-Workspace Pipeline)

Ao trabalhar em outros projetos (como Observatório Civil BR, JusMonitor, Lawfare Timeline, Sabor Brazil, etc.), você não precisa copiar textos e imagens manualmente.

graph TD
    A[Projeto / Workspace de Origem] -->|Artigo Bruto / Estudo / X-Article| B[Skill aswriter]
    B --> C[Auditoria Semântica: Score > 95]
    B --> D[Pipeline de Mídia Automatizado]
    
    subgraph D [Processamento de Assets]
        D1[Geração ou Captura do Hero] --> D2[Conversão para WebP Otimizado]
        D2 --> D3[Cópia para D:\artesdosul\artesdosul\assets\img]
    end

    subgraph C [Padronização Editorial]
        C1[Injeção de Frontmatter Jekyll]
        C2[Hierarquia Tipográfica H1/H2/H3]
        C3[Tabelas, Callouts e Alertas]
    end

    D3 & C1 & C2 & C3 --> E[Roteamento Automático de Destino]
    
    E --> F[d:\artesdosul\artesdosul\_posts\estudos\]
    E --> G[d:\artesdosul\artesdosul\_posts\devops\]
    E --> H[d:\artesdosul\artesdosul\_posts\tools\]
    E --> I[d:\artesdosul\artesdosul\_posts\showcase\]
    E --> J[d:\artesdosul\artesdosul\artigos\]

🚀 Como Acionar em Qualquer Workspace

Você pode ativar o pipeline no prompt de qualquer agente com comandos simples como:

  • “Crie um xartigo sobre esse tema e envie para o Artes do Sul com aswriter”
  • “Use o aswriter para publicar este documento no Artes do Sul”
  • “Traga este estudo para o artesdosul garantindo Score > 95 e Hero WebP”

📋 Critérios Editoriais & Checklist de Qualidade (Score > 95)

Toda publicação processada pelo aswriter segue os seguintes parâmetros:

1. Frontmatter Padronizado

---
title: "Título Semântico e Impactante"
description: "Descrição rica e persuasiva entre 120 e 160 caracteres otimizada para SEO."
date: YYYY-MM-DD
publishdate: YYYY-MM-DD
authors: "Artes do Sul"
category: [estudos | devops | tools | showcase]
categories: [categoria_primaria, categoria_secundaria]
tags: [tag1, tag2, tag3, tag4]
image:
  path: /assets/img/nome-do-artigo.webp
layout: post
---

2. Higiene de Conteúdo e Tipografia

  • H1 Único: Exatamente um # Título principal.
  • Hierarquia Balanceada: Divisão clara em ## H2 (seções) e ### H3 (subseções).
  • Densidade Textual: Foco em substância técnica, clareza conceitual e frameworks práticos.
  • Elementos Ricos: Presença de tabelas markdown, blocos de código com linguagem definida, citações (>) e callouts ([!NOTE], [!TIP]).
  • Links Semânticos: Ausência de URLs expostas; conversão para links contextuais markdown [texto](url).

3. Gestão Automática de Mídia

  • O agente salva a imagem em D:\artesdosul\artesdosul\assets\img/[slug].webp.
  • Não são utilizados caminhos temporários ou links quebrados.

🗂️ Roteamento de Coleções do Portal

Coleção Tipo de Conteúdo Caminho no Repositório
Estudos Gestão de Produto, Estratégia, Liderança, Agilidade, OKRs _posts/estudos/YYYY-MM-DD-[slug].md
DevOps Tutoriais Técnicos, Frontend, Backend, Infraestrutura, Linux _posts/devops/YYYY-MM-DD-[slug].md
Tools Diretórios de Ferramentas, Recursos Web, Guias de IA _posts/tools/YYYY-MM-DD-[slug].md
Showcase Dossiês de Projetos, Observatórios, Estudos de Caso _posts/showcase/YYYY-MM-DD-[slug].md
X-Articles Artigos preparados para publicação no X.com artigos/[slug]-xarticle.md

🛠️ Manutenção da Skill

A definição canônica da skill está disponível e pode ser customizada em: