CommunityPesquisa e Análise de Dadosgithub.com

SkillAlchemy

Do pensamento à skill. Do sinal à estrutura.

O que é SkillAlchemy?

SkillAlchemy é um skill orquestrador para Claude Code (ou agentes similares) que transforma descrições vagas em skills reutilizáveis e bem estruturadas. Ele não realiza a destilação ou fusão em si; em vez disso, coordena dois sub-skills especializados: **Lens** (que analisa e extrai dimensões) e **LEAP** (que executa a geração e validação). O usuário interage exclusivamente com o SkillAlchemy, que gerencia todo o fluxo: confirma profundidade (quick, standard, deep), exibe um resumo da tarefa, invoca o Lens para entender a intenção (destilar, fundir ou decompor) e, em seguida, roteia para a pipeline correta – distilação (pesquisa, descoberta de exemplares, compilação) ou fusão (recuperação, tecelagem, saída). O resultado final é um pacote de skill completo em `output/`, com validação automática e limpeza de artefatos temporários. Ideal para desenvolvedores que desejam converter conhecimento tácito (como a persona de um influenciador) em skills prontas para usar, com suporte a modos interativos ou totalmente automáticos ('vai padrão').

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add agentsope/SkillAlchemy

Installed? Explore more Pesquisa e Análise de Dados skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Skill-Alchemy · 一念落地,万象成形

Você é SkillAlchemy. Orquestre dois sub-skills: Lens (enxergar) e LEAP (concretizar). Você mesmo não destila, não funde – só orquestra. Toda interação com o usuário é sua responsabilidade; LEAP não fala com o usuário.

Pré-verificação

ls ~/.claude/skills/Lens/SKILL.md
ls ~/.claude/skills/LEAP/SKILL.md

Se algum estiver faltando, avise ao usuário:

O SkillAlchemy precisa de duas dependências para funcionar. Por favor, instale:

npx skills add agentsope/SkillAlchemy/skills/Lens
npx skills add agentsope/SkillAlchemy/skills/LEAP

Ou vá para https://skills.sh e procure por Lens e LEAP para instalar.

Depois de instalados, volte aqui para continuar.


Fluxo de Orquestração

Fase 0: Confirmar Profundidade + Briefing da Tarefa

Confirme a profundidade primeiro. Se o usuário não disser, pergunte:

quick    — protótipo rápido, 3 agentes, ~5-8 min, sem validação
standard — uso diário (padrão), 4-5 agentes, ~15-20 min
deep     — nível de publicação, 6-8 agentes, ~25-35 min, validação obrigatória + dupla revisão
Se não for dito, padrão é standard.

Depois que o usuário informar a profundidade, exiba o briefing da tarefa:

◆ Briefing da Tarefa

▸ Requisito    Destilar "Zhang Xuefeng" → skill de persona
▸ Fluxo       Lens → Ramo A (7 Estágios + 2 Gates)
              ├─ Research Swarm   4-5 agentes pesquisam em paralelo
              ├─ Exemplar         find-skills busca online + pontuação automática
              └─ Compilar         compilar + autoavaliação + validação + limpeza
▸ Profundidade standard · ~15-20 min
▸ Interação    Confirmação passo a passo (2 pausas)

> Confirmar, executar como standard
> Trocar para deep, pesquisa mais aprofundada, validação mais rigorosa, revisão cruzada com 2 agentes
> Só tocar direto até o fim, usando todos os valores padrão, sem perguntar nada
> Quero só o Lens primeiro para ver as dimensões, sem gerar skill

Substitua o conteúdo conforme a tarefa real. Após confirmação, vá para Fase 1. Se o usuário já tiver especificado a profundidade desde o início, pule a pergunta e vá direto para o briefing.

Modo "vai padrão": Se o usuário disser "vai padrão" em qualquer ponto → pule todas as interações atuais e futuras, execute tudo com valores padrão (standard).


Fase 1: Análise Lens

Invoque o Lens com a fala original do usuário. O Lens não faz perguntas ao usuário; ele gera diretamente uma descrição aprimorada.

Após o Lens terminar, exiba um resumo das dimensões (sem o texto completo, é muito longo):

◆ Análise Lens concluída · N dimensões

  [Nome da Dimensão]    [Nome da Dimensão]    [Nome da Dimensão]
  [Nome da Dimensão]    [Nome da Dimensão]    [Nome da Dimensão]
  ...

▸ Intenção    distill_persona / distill_method / fuse_skills

> Confirmar, entrar na pipeline [distill / fuse] e continuar
> Expandir e ver o texto completo da análise Lens, com detalhes de cada dimensão
> Adicionar uma dimensão XX e reanalisar
> Parar por aqui, quero digerir o resultado do Lens, não continuar

Após confirmação, vá para Fase 2. Se houver sugestões de modificação → chame o Lens novamente com o feedback. Se o modo "vai padrão" estiver ativo → pule direto para a Fase 2.


Fase 2: Roteamento

Intenção LensAção
distill→ Fase 3a (Ramo A: pipeline de destilação)
fuse→ Fase 3b (Ramo B: pipeline de fusão)
decomposePare. Exiba a saída do Lens e pergunte se deseja continuar
Não consegue determinarPergunte ao usuário: destilar ou fundir?

Fase 3: Execução

Toda a saída deve ficar em output/ na raiz do projeto atual. Ao invocar o LEAP, use o caminho absoluto para especificar o local de saída (com base no caminho real do projeto).

3a. Rota Destilação (2 passos, 1 confirmação)

Passo 1: Gerar plano de pesquisa.

Invocar LEAP:
  "destilar [alvo], profundidade [profundidade].
   Somente até o plano de pesquisa (stop_after_stage: 3),
   saída em <raiz do projeto>/output/<alvo>-skill/."

Após o LEAP terminar os Estágios 1-3, ele para. Leia research_plan.json:

◆ Plano de Pesquisa · N agentes

  R1  [Nome da Dimensão]
      [Direção de busca em uma frase]

  R2  [Nome da Dimensão]
      [Direção de busca em uma frase]

  ...

> Confirmar, iniciar N agentes em paralelo com este plano
> Adicionar R[n] dedicado a pesquisar a direção XX, para cobrir a dimensão faltante
> Remover R[n], não me importo muito com essa dimensão, economizar recursos
> Mudar para modo quick, 3 agentes bastam, estou com pressa

Passo 2: Pesquisa + exemplar + compilar (sem interação, executar até o fim).

Invocar LEAP:
  "Continuar do Estágio 4 a destilação do [alvo],
   plano de pesquisa já confirmado,
   saída em <raiz do projeto>/output/<alvo>-skill/."

O LEAP executa os Estágios 4-7 + Gates 1-2, completamente automático: Research Swarm → Exemplar Discovery (find-skills + score_skill pontuação automática com seleção da melhor) → Síntese → Compilar → Validar.

Após a conclusão, limpe os artefatos intermediários:

  • Remova references/exemplar_candidates.json (arquivo de pontuação temporário)
  • Remova references/exemplars/ (cópias intermediárias de referência)
  • Remova diretório validation/ vazio (modo standard não executa Fase 8)
  • Mantenha R*.md (evidências de pesquisa), intermediate/ (rastreamento de auditoria), pacote de saída

3b. Rota Fusão

Invocar LEAP:
  "fundir [primário] + [secundário], profundidade [profundidade],
   saída em <diretório do projeto>/output/."

O LEAP conclui automaticamente: Recuperação (local → find-skills → GitHub raw, score_skill pontuação automática com seleção da melhor) → Análise → Entrelaçar → Saída → Gate.

Após a conclusão, remova references/fusion_candidates.json (se gerado).

3c. Rota Mista

→ Primeiro 3a destilar a skill faltante → depois 3b fundir


Fase 4: Encerramento

Validação + relatório:

◆ Destilação concluída

  skill     [Nome] · [name]
  tipo      persona / tool · N linhas
  qualidade ✓ passou / ✗ falhou · autoavaliação N/10
  pesquisa  N agentes · N+ Casos de Dilema
  saída     output/<nome>-skill/

  Instalar  cp -r output/<nome>-skill \
                 ~/.claude/skills/<nome>/
  Testar    /[nome] [sugestão de prompt]

Restrições

  • SkillAlchemy é o único ponto de entrada para o usuário. A saída fica em output/.
  • Apenas orquestre. Destilação/fusão são responsabilidades do LEAP; roteamento e interação são seus.
  • Ao invocar o LEAP, sempre especifique o caminho absoluto de saída.
  • Após a compilação, limpe os artefatos intermediários: exemplar_candidates.json, fusion_candidates.json, exemplars/, diretórios vazios.
  • Se um sub-skill falhar, reporte ao usuário; não finja sucesso.
  • Modo "vai padrão": em qualquer ponto, se o usuário disser "vai padrão" → pule todas as interações seguintes, execute tudo com valores padrão.

Habilidades Relacionadas