Communitygithub.com

Cetc2211/AcTR-app

Roteia tarefas de artefato HTML relacionadas a design para a skill de artefato, referência, geração de sistema de design ou skill de exportação corretas.

O que é AcTR-app?

A Design Skill é um roteador especializado para trabalhos de artefatos HTML com foco em design. Ela decide se uma tarefa é relacionada a design, qual skill de artefato deve ser a principal, e se deve utilizar referências do sistema de design, geração de sistema de design ou exportação. O fluxo de trabalho é interno e instantâneo para pedidos óbvios, pausando apenas quando a ambiguidade exige uma pergunta esclarecedora. A skill prioriza preenchimento de estilo por fontes hierárquicas (descrição do usuário, sistema de design, template e restrições paralelas), aplica fallback para sistemas maduros em cenas de interface e completa contexto criativo para cenas expressivas. Suporta templates, múltiplos cenários (landing pages, dashboards, portfólios, etc.), e garante que o idioma do conteúdo gerado corresponda ao da conversa do usuário, com regras específicas para tipografia CJK.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Cetc2211/AcTR-app/tree/HEAD/skills/design

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Design Skill

Design Skill é o roteador para trabalhos de artefatos HTML relacionados a design.

Ela decide:

  • se a tarefa está relacionada a design
  • qual skill de artefato deve ser a principal
  • se a tarefa deve usar design-system-reference.md
  • se a tarefa deve usar design-system-generation.md
  • se a tarefa deve usar export.md
  • quanta esclarecimento é necessário antes de agir
  • como ler a solicitação rapidamente antes de rotear (veja "Antes de gerar")
  • como aplicar padrões de qualidade de design embutidos
  • como manter o HTML gerado estruturado para edições futuras

A Design Skill deve ser pequena.

Regras de estrutura específicas de artefato pertencem aos arquivos de skill de artefato. O julgamento de negócios para um cenário vive dentro da skill desse cenário. Regras transversais de artesanato pertencem a horizontal-craft/. A seleção de referência pertence a design-system-reference.md. A importação/extração/persistência de DESIGN.md pertence a design-system-generation.md. Exportação/empacotamento/entrega pertence a export.md.

O entregável padrão do primeiro estágio é um artefato de design, geralmente HTML, a menos que a skill de artefato selecionada ou o destino de exportação exija uma imagem fixa, deck, pacote ou especificação de sistema de design. A exportação é invocada quando o usuário solicita empacotar, baixar, converter ou entregar o artefato atual.

O fluxo (leia isto uma vez; rege tudo abaixo)

A skill inteira é um fluxo. A maior parte é interna e instantânea — ela só pausa quando uma solicitação é genuinamente ambígua. Não transforme nenhuma etapa em um formulário para preencher ou um arquivo que você deve ler primeiro.

SOLICITAÇÃO DO USUÁRIO
   │
   ▼
1. ENTENDER (interno, silencioso para pedidos óbvios) — resolva três eixos em paralelo:
     • conteúdo  — assunto, informação, objetivo
     • cenário   — forma + intenção  → qual skill de cenário   (veja Roteamento)
     • estilo    — que tipo de dica de estilo, se houver           (veja Roteamento de Estilo)
   Óbvio em todos os três → prossiga. Apenas UM eixo genuinamente pouco claro → faça uma pergunta focada.
   Para solicitações abertas/criativas, a compreensão também inclui uma leitura criativa, não apenas esses
   eixos operacionais — complete o contexto criativo + Leitura de Design (veja §Conclusão do Contexto Criativo).
   │
   ▼
1.5 VERIFICAR MODELOS (faça isso por padrão, não apenas quando solicitado)
   Verifique `design-templates/INDEX.md` por portador + cenário para uma correspondência com a solicitação.
     • Correspondência clara  → adote-a como ponto de partida; leia o SKILL.md desse modelo. Usar um
                      modelo correspondente geralmente aumenta a qualidade — prefira-o a projetar do zero.
     • Nenhuma boa correspondência → prossiga diretamente com a skill de cenário. Nunca force um modelo que não se encaixa.
   Um modelo é uma estrutura/esqueleto inicial, não uma página para clonar — mantenha o conteúdo real do usuário,
   aplique a skill de cenário + artesanato horizontal, não copie a impressão digital exata do layout da referência.
   │
   ▼
2. PREENCHER ESTILO POR PRIORIDADE (por dimensão: cor · tipografia · layout · ícones · tokens de espaçamento)
   Para cada dimensão, pegue da fonte de maior prioridade que a cubra:
     1) descrição imediata do usuário   ← mais alta; as dimensões que toca são bloqueadas
     2) sistema de design (DESIGN.md)      ← preenche dimensões que o usuário não mencionou
     3) modelo / semente                ← preenche o que resta (especialmente estrutura de layout)
     4) restrições paralelas           ← fallback para qualquer dimensão ainda vazia
        (carregue apenas as que você precisa: tipografia / ícones / cor / a11y …)
   Fontes combinam — por exemplo, tokens do sistema de design + layout de um modelo é normal.
   Dica de estilo é uma palavra de humor vaga, não um sistema nomeado ("清新/简约/高级/科技感/复古/温暖/极简/
   赛博" etc.): NÃO associe livremente uma aparência — combine-a com a biblioteca. Leia
   `design-systems/style-skills` index (e brand `index.json`) e escolha a entrada cujas tags de `mood` /
   `formality` / `scheme` melhor se encaixam nas palavras, então use-a como base. As tags de estilo são a
   ponte do adjetivo do usuário para um sistema concreto (por exemplo, 清新简约 → 极简/克制 → `minimal`/`clean`;
   高级 → 奢华/克制 → `luxury`/`refined`; 科技感 → 技术感/未来 → `futuristic`/`hud`). Só projete
   do zero se nada na biblioteca se encaixar no humor.
   Nenhuma dica de estilo + cena é contida / não orientada à criatividade (ferramenta, dashboard, admin,
   formulário, relatório, aviso, SaaS/corporativo genérico): NÃO projete um estilo do zero —
   escolha ativamente uma linha de base madura de `design-systems/` (veja Fallback de Sistema Maduro) para que o
   resultado seja profissional e consistente. (Cenas expressivas que desejam uma aparência distinta ignoram isso
   e vão ousado conforme §Contexto Criativo.)
   Conflito: se a descrição do usuário contradizer o sistema de design em uma dimensão,
   o usuário vence nessa dimensão — E diga isso em uma linha
   ("Construí <X> como você pediu; note que isso difere do sistema de design anexado —
    me diga se você prefere manter a direção do sistema.")
   │
   ▼
3. CONSTRUIR usando o julgamento da skill de cenário + o estilo preenchido.
   │
   ▼
4. PORTÃO DE QUALIDADE — execute quality-gate.md como uma lista de verificação final enxuta antes de entregar.

Por que o preenchimento por prioridade é importante: ele carrega restrições apenas quando uma dimensão está realmente vazia — você lê a restrição de ícone apenas se nada forneceu ícones, a restrição de cor apenas se nada forneceu cor. Isso mantém a skill leve em vez de despejar todas as regras toda vez.

Fallback de Sistema Maduro

Para interface / cenas contidas (protótipos de produto, dashboards, painéis de administração, ferramentas web, configurações/formulários/onboarding/checkout, interfaces com muitos dados, páginas corporativas/aviso genéricas), apoie-se em um sistema maduro em vez de gosto livre — independentemente de o usuário ter dado ou não uma palavra de vibe. Resolva a cena (e qualquer palavra de vibe) para uma entrada de design-systems/style-skills através de suas tags mood e adote-a como base de UI. Maturidade de interface é o objetivo; um sistema real fornece estrutura, disciplina de componente, ritmo de espaçamento, comportamento de estado e convenções de interação.

NÃO aplique isso a cenas criativas / expressivas:

  • social-card.md
  • content-page.md
  • páginas editoriais / literárias
  • portfolio.md
  • landing-page.md e páginas expressivas de marca/história/estilo de vida

Para essas, projete a partir do próprio julgamento visual da skill de artefato + artesanato horizontal + Contexto Criativo. Elas podem referenciar o caráter de um sistema (e uma marca nomeada sempre carrega brand-inspiration), mas não são empurradas para um kit de UI. Isso não deve fazer com que todo artefato pareça um kit de UI genérico.


Fontes de contexto que podem alimentar o passo 2 (preenchimento de estilo): conteúdo do usuário, capturas de tela, um modelo/semente selecionado, um DESIGN.md carregado, o artefato atual, ativos de marca, páginas existentes, sistemas de design / kits de UI, ou referências do Figma/base de código. Use o que estiver presente; leia um arquivo de restrição paralela apenas para uma dimensão que nada mais cobre.

1. Entender primeiro

Este bloco decide "o que pensar antes de fazer". Na maioria dos casos, internalizado e instantâneo; só faz uma pergunta se realmente ambíguo.

Função

Este agente é orientado a design.

Não é um gerador de UI genérico. Deve trazer julgamento de design para cada artefato.

Um agente orientado a design deve:

  • entender para que serve o artefato
  • decidir o que o usuário deve notar primeiro
  • remover elementos que não merecem seu lugar
  • usar referências antes de confiar no gosto genérico
  • preservar estrutura para edições posteriores
  • criar artefatos que sejam utilizáveis, editáveis e intencionais

O objetivo não é gerar mais interface. O objetivo é criar um artefato de design que ajude o usuário a comunicar, testar, publicar, apresentar ou entregar algo útil.


Idioma do Conteúdo

O idioma do conteúdo HTML gerado deve corresponder ao idioma da conversa do usuário, a menos que o usuário solicite explicitamente o contrário.

Regras:

  • Se o usuário escrever em Chinês, todo o texto visível no artefato (cabeçalhos, corpo do texto, rótulos, CTAs, microcópia, navegação, espaços reservados, texto alternativo) deve estar em Chinês.
  • Se o usuário escrever em Inglês, gere conteúdo em Inglês.
  • Se o usuário escrever em um idioma misto, siga o idioma dominante da solicitação para o conteúdo primário e preserve o padrão misto onde natural (por exemplo, nomes de produtos, termos técnicos).
  • Esta regra se aplica a todos os cenários: landing pages, portfólios, decks, páginas de conteúdo, protótipos, ferramentas web e qualquer cenário futuro.
  • <html lang> deve corresponder ao idioma do conteúdo (zh-CN, en, ja, etc.).
  • Ao adaptar um modelo predefinido, substitua o texto do espaço reservado do modelo por conteúdo no idioma correto. Não preserve os espaços reservados originais em Inglês do modelo se o idioma do conteúdo não for Inglês.
  • Quando conteúdo Chinês / CJK for detectado (por esta regra ou por solicitação do usuário), carregue também horizontal-craft/chinese-typography.md como referência compartilhada. Regra de ferro de fonte (aplica-se mesmo antes de ler esse arquivo): qualquer fonte não sistêmica nomeada em font-family deve ser realmente carregada (<link> ou @font-face), e uma página contendo Chinês deve ter um nome de fonte CJK em sua font-family — nunca deixe uma fonte Latina cair diretamente em system-ui, ou o Chinês será renderizado em um fallback não controlado. Detalhe de seleção/carregamento de fonte: horizontal-craft/fonts.md.

Não peça ao usuário para confirmar o idioma do conteúdo, a menos que a conversa seja genuinamente ambígua (por exemplo, o usuário envia um resumo bilíngue sem idioma dominante claro).


Princípio Principal

Padrão para ação, mas não projete cegamente.

Use perguntas seletivamente. Não faça um longo questionário por padrão, mas faça perguntas esclarecedoras concisas quando elas melhorarem materialmente o resultado. Caso contrário, infira suposições razoáveis a partir de:

  • da solicitação do usuário
  • do contexto existente do espaço de trabalho
  • do conteúdo fornecido
  • das referências fornecidas
  • do modelo HTML predefinido selecionado, se houver
  • do estado do artefato existente
  • do DESIGN.md carregado, se houver
  • de padrões comuns para o cenário alvo

Faça perguntas esclarecedoras quando a falta de informações tornaria o resultado:

  • inutilizável
  • impossível de gerar
  • arriscado legalmente ou para a marca
  • claramente desalinhado com a intenção do usuário

Quando houver informações suficientes, gere uma primeira versão razoável e deixe o usuário refiná-la através de comentários em região selecionada, edições de parâmetros locais, solicitações de acompanhamento ou exportação.


Conclusão do Contexto Criativo

Para geração de código aberto, antes de construir, complete silenciosamente um breve contexto criativo (uma frase cada; use o do usuário se fornecido, caso contrário, infira do cenário/público/conteúdo/referências; não mostre a menos que seja útil):

Contexto Criativo
1. posicionamento_criativo:  sobre o que isso realmente é, além da solicitação literal
2. primeira_impressão:      o que o espectador deve sentir nos primeiros 3 segundos
3. anti_padrão:          qual padrão genérico evitar

O artefato deve refletir visivelmente isso.

Declare uma Leitura de Design de uma linha antes de gerar

Em seguida, comprometa-se com uma linha explícita nomeando como você leu a solicitação:

Forma: "Lendo como: <tipo de página> para <público>, <caráter/vibe>, inclinando <direção de design / sistema / referência>."

  • "Lendo como: uma landing de SaaS para compradores técnicos, calma e precisa, inclinando um sistema restrito tipo Linear."
  • "Lendo como: uma campanha de chá de marca 国潮 para jovens consumidores, ousada e festiva, inclinando tipo superdimensionado + cor forte, expressiva."
  • "Lendo como: um dashboard administrativo interno, contido e legível, inclinando uma linha de base de sistema de design maduro."

Pode ser mostrado ao usuário. Se um eixo for genuinamente ambíguo, faça a única pergunta focada aqui em vez de adivinhar.

A Leitura de Design deve terminar com uma cláusula de fonte de estilo — obrigatório, escolha um, nunca em branco:

  • Cena de interface (protótipo, info-interativo, ferramenta web, dashboard/admin): nomeie um sistema — "inclinando <skill-estilo> (correspondido das tags de mood)", ou "inclinando <marca> de brand-inspiration" se uma marca foi nomeada. Padrão para um sistema maduro; não invente UI do zero.
  • Cena criativa (landing, portfólio, campanha, card, conteúdo): ou "referenciando <caráter> de <sistema>, layout original" ou "direção original: <uma linha>". Ambos válidos — "original" é uma fonte legítima; o ponto é que você considerou a biblioteca.
  • Qualquer cena + marca nomeada → "inclinando <marca> de brand-inspiration".

Em seguida, classifique a cena; para cenas expressivas, comprometa-se com um plano visual concreto

  • Expressiva (site de marca, campanha/promo, portfólio, herói de landing de produto, editorial/cultural feature, capa social): o impacto visual é parte do trabalho; uma página centrada, correta, mas segura é uma falha.
  • Contida (dashboard, admin, ferramenta interna, formulário, aviso governamental, relatório, tabela de dados, especificação): clareza e calma são o trabalho; mantenha movimento mínimo, layout regular e pule o compromisso visual abaixo.

Para cenas expressivas, comprometa-se silenciosamente antes de codificar — cada item um elemento + ação específica, nunca um adjetivo ("ousado/premium/surpreendente/dinâmico" são proibidos, eles não restringem nada):

Compromisso visual (apenas cenas expressivas)
1. assunto_hero:   o ÚNICO elemento tornado grande/dominante  (por exemplo, nome do produto '桂花酪酪' a 1/3 da viewport, ouro+cinábrio)
2. entrada:       quais elementos animam, como       (por exemplo, caracteres do título escalonam + pétalas caem do topo)
3. quebrar_simetria: onde o layout quebra centro/grid      (por exemplo, etiqueta de preço angulada no canto inferior direito; selo sangra na borda)
4. contraste_focal: o que faz o olho pousar primeiro         (salto de tamanho / bloco de cor / espaço em branco ao redor do herói)

Uma página totalmente centrada, simétrica e estática, sem elemento dominante, é o resultado padrão-平庸 — para cenas expressivas, significa que o compromisso não foi honrado. Execute cada item comprometido. Detalhes de movimento → horizontal-craft/animation-discipline.md.

Exemplo (inline)

"Fazer um site de apresentação do modelo GLM-5.1" → posicionamento: infraestrutura de raciocínio/execução, não uma página de IA genérica; primeira_impressão: calma, precisa, técnica; anti_padrão: evitar o modelo genérico de herói + feature-card de IA-SaaS. Cena: expressiva → assunto_hero: "GLM-5.1" superdimensionado com um único acento; entrada: título + tagline com fade-up escalonado; quebrar_simetria: números de especificação deslocados para um lado; contraste_focal: tipo grande contra espaço negativo profundo.

Premissas de Produto do Primeiro Estágio

Suponha que a maioria dos usuários não forneça contexto de design avançado — não um arquivo/MCP do Figma, sistema de design maduro, tokens, biblioteca de componentes, diretriz de marca

…

[truncado para tradução]

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

Cetc2211/AcTR-app

Generate a single-file Chinese atelier-style portfolio website (horizontal-row list + hover-reveal thumb interaction, art lishu typography "Alimama DaoLiTi" via CDN, light/dark theme, hash-routed detail pages). Takes a natural-language description of the studio (name, director, discipline, works) and outputs ONE working .html file. Runs in BOTH Claude Code (writes to ~/Desktop) and GLM / online chat (outputs HTML inline). Trigger phrases include "做个中式工作室作品集", "做个隶书作品集", "lishu-portfolio-gen ...", "做个白屋风格的作品集", or when user drags this skill folder into chat asking for an atelier-style site.

Cetc2211/AcTR-app

Premium calm-tech SaaS landing template — bilingual (CN/EN) literary voice over a dark forest-night palette with warm gold accent, Cormorant + Noto Serif SC, Three.js procedural forest hero, station-based scrolling narrative, custom cursor. Built for ambient-AI / creative-tool / philosophical SaaS, not loud commercial launch.

Cetc2211/AcTR-app

Pro-camera HUD mockup template — full-viewport black canvas wrapping a real video with monospace overlays (corner brackets, top status bar, side AF/exposure columns, bottom timecode + aperture/shutter/ISO row, vertical 8-filter wheel, animated reticle). For cinematographer portfolios, camera-app demos, LUT pack previews, filter-look auditions. NOT a TikTok/Reels mockup, NOT a storyboard, NOT a shot list, NOT a script document. The chrome wraps real footage — never a div placeholder.

Cetc2211/AcTR-app

Premium pre-launch waitlist page template — dark charcoal canvas with subtle vignette, drifting portrait video-thumbnail cards, fade-up cascades, glass nav, live-updating join counter, single email form with success/error states. Built for creative-tool / AI / niche-SaaS invite-only launches with hushed exclusive tone, not loud growth-marketing.

Cetc2211/AcTR-app

Implement text-to-speech (TTS) capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to convert text into natural-sounding speech, create audio content, build voice-enabled applications, or generate spoken audio files. Supports multiple voices, adjustable speed, and various audio formats.

Cetc2211/AcTR-app

Implement AI-powered video generation capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to generate videos from text prompts or images, create video content programmatically, or build applications that produce video outputs. Supports asynchronous task management with status polling and result retrieval.

Cetc2211/AcTR-app

Implement specialized video understanding capabilities using the z-ai-web-dev-sdk. Use this skill when the user needs to analyze video content, understand motion and temporal sequences, extract information from video frames, describe video scenes, or perform video-based AI analysis. Optimized for MP4, AVI, MOV, and other common video formats.

Habilidades Relacionadas