coin-plan

Metodologia de pesquisa para criar listas completas de séries de moedas a partir de uma exportação CSV do Numista. Ative sempre que o usuário pedir para cruzar sua coleção com uma série, encontrar lacunas, planejar próximas aquisições, sugerir novas séries ou analisar um arquivo de exportação Numista. Também ative para listas de compras em feiras de moedas ou planejamento de conclusão de séries. Esta skill cobre todo o pipeline, desde a análise do CSV até a pesquisa de séries, análise de lacunas e classificação de prioridades.

O que é coin-plan?

A skill **coin-plan** é uma metodologia completa para colecionadores de moedas que desejam organizar, analisar e expandir suas coleções de forma sistemática. Ela automatiza o processo de transformar uma exportação CSV do Numista (plataforma de catálogo numismático) em um plano de ação: desde a importação e limpeza dos dados, passando pela identificação das séries de moedas presentes na coleção, até a geração de uma lista de lacunas (gap analysis) e sugestões de novas séries para colecionar. A skill suporta séries de diversos países — como os quarters dos EUA (50 States, America the Beautiful, American Women), as libras britânicas (Round Pound e 12-Sided), as séries chinesas (Zodíaco Lunar, Patrimônio Mundial, Ópera de Pequim, etc.) e as moedas dos estados principescos da Índia. Ela também gera listas de compras otimizadas para feiras de moedas e saídas em PDF (com a skill `a5-coin`) ou Excel. O usuário pode personalizar um perfil de colecionador para refinar as sugestões, e a skill prioriza séries completáveis, acessíveis e que combinem com o formato e país já colecionados. É ideal para colecionadores que usam o Numista como catálogo principal e desejam planejar seus próximos passos de forma inteligente.

Funciona com~Claude Code~Codex CLI~Cursor
Part ofMobile
npx skills add https://github.com/cercit/AI-Skills/tree/main/coin-plan

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Metodologia de Planejamento de Coleção de Moedas

Quando usar

  • O usuário envia uma exportação CSV do Numista e deseja análise de lacunas
  • O usuário pergunta "o que está faltando na série [série]"
  • O usuário quer iniciar uma nova série e precisa da lista completa
  • O usuário pede uma lista de compras para feira de moedas ou prioridades de aquisição
  • O usuário quer sugestões de séries baseadas nos padrões da coleção existente

Etapa 1: Analisar Exportação Numista

As colunas do CSV que importam:

Country, Issuer, Ruling authority, Title, Type, Face value,
Reference, N# number, Gregorian year, Mintmark, Composition,
Grade, Collection, Comment

Padrões de análise principais:

Extração do nome do design — os nomes estão entre parênteses após informações de retrato:

import re
m = re.search(r'\((.*?)\)', title)
design_name = m.group(1) if m else title

Para séries com múltiplos retratos (Reino Unido) — remover prefixo do retrato:

m = re.search(r'portrait;\s*(.+?)\)', title)

Filtrar não-circulantes (se o colecionador exclui provas em prata/ouro):

if 'silver' in comp.lower() and 'clad' not in comp.lower():
    continue  # pular prata pura

Dedup por (design, ano, casa da moeda) — mesmo design+ano+casa = uma entrada, rastrear quantidade.

Etapa 2: Construir Lista Mestra da Série

Fontes de pesquisa (em ordem de confiabilidade):

  1. Páginas de catálogo Numista — autoritativas para KM#, datas, composições
  2. Pesquisa na web para visões gerais de séries (artigos PCGS, NGC, Baidu Baike para China)
  3. Cruzamento dos números N# da exportação Numista do usuário com séries conhecidas

Identificação de séries a partir de padrões da coleção:

  • Verifique o campo Type: "Circulating commemorative" vs "Standard circulation"
  • Agrupe por denominação + composição para identificar séries
  • Verifique intervalos de anos para sequências contínuas (lacunas = moedas faltando)

Estruturas de séries comuns:

PaísSérieDenominaçãoFormatoAnos
EUA50 State Quarters25¢Cu-Ni clad1999-2008
EUADC & Territories25¢Cu-Ni clad2009
EUAAmerica the Beautiful25¢Cu-Ni clad2010-2021
EUAAmerican Women25¢Cu-Ni clad2022-2025
Reino UnidoRound Pound Emblems£1Ni-Brass1983-2015
Reino Unido12-Sided Pound£1Bimetálica2016-presente
ChinaZodíaco Lunar10 YuanBimetálica2015-2026
ChinaPatrimônio Mundial5 YuanBronze2002-2006
ChinaMontanhas Patrimônio Mundial5 YuanBronze (quadrada)2019-presente
ChinaÓpera de Pequim5 YuanBronze2023-2027
ChinaParques Nacionais10 YuanBimetálica2023-presente
ChinaCaligrafia "He"5 YuanBronze2013-2022
ChinaPontos Turísticos de Taiwan5 YuanBronze2003-2005
ChinaAnimais do Livro Vermelho5 YuanCobre1995-1998
ÍndiaEstados PrincipadosVáriasVáriasVárias

Etapa 3: Análise de Lacunas

Construir conjunto coletado:

collected = {}  # (design_name, year) -> conjunto de casas da moeda ou quantidade

Cruzar com a lista mestra:

for year, name in master_list:
    if (name, year) in collected:
        status = "TENHO"
    else:
        status = "FALTA"

Para séries com variantes de casa da moeda (quarters dos EUA):

Rastrear P e D separadamente. Mostrar ambas como colunas — negrito se coletado, cinza claro se não.

Para séries com única variante (libras do Reino Unido, China):

Checkbox simples sim/não.

Etapa 4: Sugerir Novas Séries

Quando o usuário pergunta "o que mais devo colecionar", aplique estes filtros:

Critérios de compatibilidade:

  1. Mesma denominação/formato da coleção existente (se o usuário coleciona 5 Yuan bronze, sugerir outras séries de 5 Yuan bronze)
  2. Mesma faixa de preço — comemorativas circulantes, não provas/barras
  3. Completável — série finita com número total conhecido
  4. Disponível — moedas ainda obtíveis de revendedores a preços razoáveis
  5. Ajuste temático — interesses declarados do colecionador (veja perfil do colecionador abaixo)

Classificação de prioridade para sugestões:

  • Alta: Mesmo formato, mesmo país, <20 moedas, baratas, disponíveis
  • Média: Mesmo país, formato diferente mas acessível
  • Baixa: País diferente mas ajuste temático

Etapa 5: Lista de Compras

Para feiras de moedas:

  • Priorizar por geografia (feiras locais estocam melhor moedas locais e regionais; ex.: uma feira no sul da Índia é o melhor lugar para estados principados do sul da Índia)
  • Agrupar por prioridade: ALTA (provavelmente presente), MÉDIA (perguntar aos revendedores), ESPECIALISTA (apenas revendedores dedicados)
  • Incluir nomes específicos de denominações que os revendedores reconheceriam
  • Adicionar checkboxes vazios para marcar na feira

Para compras online:

  • Anotar quais moedas são de circulação comum (baratas) vs comemorativas (com prêmio)
  • Sinalizar moedas escassas ou com alta demanda de colecionadores

Etapa 6: Saída

Gere a saída usando a skill a5-coin para PDFs prontos para fichário, ou Excel com openpyxl para rastreamento digital.

Colunas da saída Excel:

Nº, Nome Oficial, Ano, Denominação, Estado/País Atual, Região, Era Britânica (para Índia), Na Coleção?, Moedas Possuídas, Prioridade

Saída PDF:

Use a skill a5-coin — fonte Carlito, tons de cinza, furacão de 6 furos, layout de fluxo contínuo.

Perfil do colecionador (preencha o seu)

Mantenha esta seção curta e atualize-a conforme a coleção muda. A skill a utiliza para sugestões e listas de compras.

  • Nome de usuário Numista: <seu_nome>
  • Tamanho aproximado da coleção: <número>
  • Subcoleções ativas: <ex.: Libras Redondas Britânicas, Zodíaco Lunar Chinês, Quarters dos EUA>
  • Impressão: <colorida / tons de cinza>, fichário: <A5 Filofax / outro>
  • Cidade natal (para listas de feiras):
  • Exclusões: <ex.: sem provas em prata/ouro>

Lacunas conhecidas (data)

  • <série>: /, faltando

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas