Communitygithub.com

customer-billing-ops

Operar fluxos de faturamento de clientes, como assinaturas, reembolsos, triagem de churn, recuperação de portal de faturamento e análise de planos, usando ferramentas de faturamento conectadas como Stripe. Use quando o usuário precisar ajudar um cliente, inspecionar o estado da assinatura ou gerenciar operações de faturamento que impactam a receita.

O que é customer-billing-ops?

Esta skill é projetada para auxiliar operadores de suporte e engenheiros a lidar com operações reais de faturamento de clientes, focando em ações seguras e reversíveis. Ela se integra diretamente com ferramentas de faturamento como Stripe, permitindo identificar o cliente, classificar o problema (como duplicatas acidentais ou falhas de pagamento) e executar a correção mais adequada. A skill oferece um workflow estruturado em 5 etapas: identificação do cliente, classificação do caso, ação reversível, verificação de lacunas no produto e produção de um resumo para transferência. Ela inclui guardrails importantes, como nunca expor chaves secretas ou dados pessoais desnecessários do cliente, e orienta a distinguir entre diferentes tipos de problemas antes de agir. Além de reembolsos e cancelamentos, a skill promove o uso de portais de faturamento e a documentação de lacunas no produto para o backlog, garantindo uma abordagem completa e segura para operações de faturamento que impactam a receita.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/affaan-m/everything-claude-code/tree/main/skills/customer-billing-ops

Perguntar na sua IA favorita

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

Documentação

Operações de Faturamento de Clientes

Use esta skill para operações reais com clientes, não para design genérico de API de pagamento.

O objetivo é ajudar o operador a responder: quem é este cliente, o que aconteceu, qual é a correção mais segura e qual follow-up devemos enviar?

Quando Usar

  • Cliente diz que o faturamento está quebrado, quer um reembolso ou não consegue cancelar
  • Investigando assinaturas duplicadas, cobranças acidentais, renovações falhadas ou risco de churn
  • Revisando mix de planos, assinaturas ativas, conversão anual vs mensal ou confusão com assentos de equipe
  • Criando ou validando um fluxo de portal de faturamento
  • Auditando reclamações de suporte que envolvem assinaturas, faturas, reembolsos ou métodos de pagamento

Superfície de Ferramenta Preferida

  • Use ferramentas de faturamento conectadas como Stripe primeiro
  • Use e-mail, GitHub ou rastreadores de problemas apenas como evidência de suporte
  • Prefira portais de faturamento/ cliente hospedados a código personalizado de gerenciamento de conta quando a plataforma já oferecer os controles necessários

Diretrizes

  • Nunca exponha chaves secretas, detalhes completos de cartão ou PII desnecessária do cliente na resposta
  • Não reembolse cegamente; primeiro classifique o problema
  • Distinguir entre:
    • compra duplicada acidental
    • compra deliberada de múltiplos assentos ou equipe
    • produto quebrado / valor não entregue
    • checkout falhado ou incompleto
    • cancelamento devido à falta de controles de autoatendimento
  • Para planos anuais, planos de equipe e estados rateados, verifique a forma do contrato antes de tomar qualquer ação

Fluxo de Trabalho

1. Identifique o cliente claramente

Comece pelo identificador mais forte disponível:

  • e-mail do cliente
  • ID do cliente no Stripe
  • ID da assinatura
  • ID da fatura
  • nome de usuário do GitHub ou e-mail de suporte se souber que mapeia para faturamento

Retorne um resumo conciso da identidade:

  • cliente
  • assinaturas ativas
  • assinaturas canceladas
  • faturas
  • anomalias óbvias, como assinaturas ativas duplicadas

2. Classifique o problema

Coloque o caso em um bucket antes de agir:

CasoAção típica
Assinatura pessoal duplicadacancelar extras, considerar reembolso
Intenção real de múltiplos assentos/equipepreservar assentos, esclarecer modelo de faturamento
Pagamento falhado / checkout incompletorecuperar via portal ou atualizar método de pagamento
Controles de autoatendimento ausentesfornecer portal, caminho de cancelamento ou acesso a faturas
Falha do produto ou quebra de confiançareembolsar, pedir desculpas, registrar problema do produto

3. Tome a ação reversível mais segura primeiro

Ordem preferida:

  1. restaurar o gerenciamento de autoatendimento
  2. corrigir estado de faturamento duplicado ou quebrado
  3. reembolsar apenas a cobrança afetada ou duplicata
  4. documentar o motivo
  5. enviar um breve follow-up ao cliente

Se a correção exigir trabalho no produto, separe:

  • remediação do cliente agora
  • bug do produto / lacuna no fluxo de trabalho para o backlog

4. Verifique lacunas no lado do operador

Se a dor do cliente vier de uma superfície de operador ausente, destaque-a explicitamente. Exemplos comuns:

  • nenhum portal de faturamento
  • nenhuma visibilidade de uso/limite de taxa
  • nenhuma explicação de plano/assento
  • nenhum fluxo de cancelamento
  • nenhuma proteção contra assinatura duplicada

Trate-os como itens de follow-up do ECC ou do site, não apenas como incidentes de suporte.

5. Produza a transferência do operador

Termine com:

  • resumo do estado do cliente
  • ação tomada
  • impacto na receita
  • texto de follow-up para enviar
  • problema do produto ou backlog para criar

Formato de Saída

Use esta estrutura:

CLIENTE
- nome / e-mail
- identificadores de conta relevantes

ESTADO DE FATURAMENTO
- assinaturas ativas
- estado da fatura ou renovação
- anomalias

DECISÃO
- classificação do problema
- por que esta ação está correta

AÇÃO TOMADA
- reembolso / cancelamento / portal / sem ação

FOLLOW-UP
- mensagem curta para o cliente

LACUNA NO PRODUTO
- o que deve ser corrigido no produto ou site

Exemplos de Boas Recomendações

  • "A correção certa é um portal de faturamento, não um painel personalizado ainda"
  • "Parece um checkout pessoal duplicado, não uma compra real de assentos de equipe"
  • "Reembolsar uma cobrança duplicada, manter a assinatura ativa restante e depois converter o cliente para faturamento organizacional mais tarde, se necessário"

Individual skills in this repo

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

accessibility

Design, implement, and audit inclusive digital products using WCAG 2.2 Level AA. Use when building or auditing UI that must meet WCAG 2.2 Level AA, or when reviewing a change for keyboard, contrast, or screen-reader support.

affaan-m/claude-api

Anthropic Claude API patterns for Python and TypeScript. Covers Messages API, streaming, tool use, vision, extended thinking, batches, prompt caching, and Claude Agent SDK. Use when building applications with the Claude API or Anthropic SDKs.

affaan-m/everything-claude-code

End-to-end marketing campaign planning and execution. Covers audience research, positioning, campaign angle definition, landing page copy, email sequences, social posts, ad copy, short-form video scripts, and content calendars. Use as the orchestration layer for multi-channel product launches. Use when planning or executing a multi-channel product launch, or producing landing page, email, social, or ad copy.

affaan-m/everything-claude-code

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/everything-claude-code-conventions

Development conventions and patterns for everything-claude-code. JavaScript project with conventional commits.

affaan-m/frontend-design

Create distinctive, production-grade frontend interfaces with high design quality. Use when the user asks to build web components, pages, or applications and the visual direction matters as much as the code quality.

affaan-m/gget

gget CLI and Python workflow for quick genomic database queries, sequence lookup, BLAST-style searches, enrichment checks, and reproducible bioinformatics evidence logs.

affaan-m/literature-review

Systematic literature-review workflow for academic, biomedical, technical, and scientific topics, including search planning, source screening, synthesis, citation checks, and evidence logging.

affaan-m/motion-ui

Production-ready UI motion system for React/Next.js. Use when implementing animations, transitions, or motion patterns.

affaan-m/project-guidelines-example

Example project-specific skill template based on a real production application.

affaan-m/pubmed-database

Direct PubMed and NCBI E-utilities search workflows for biomedical literature, MeSH queries, PMID lookup, citation retrieval, and API-backed literature monitoring.

affaan-m/scholar-evaluation

Structured scholarly-work evaluation for papers, proposals, literature reviews, methods sections, evidence quality, citation support, and research-writing feedback.

affaan-m/uspto-database

USPTO patent and trademark data workflow for official record lookup, PatentSearch queries, TSDR checks, assignment data, and reproducible IP research logs.

agent-architecture-audit

Full-stack diagnostic for agent and LLM applications. Audits the 12-layer agent stack for wrapper regression, memory pollution, tool discipline failures, hidden repair loops, and rendering corruption. Produces severity-ranked findings with code-first fixes. Essential for developers building agent applications, autonomous loops, or any LLM-powered feature. Use when an agent or LLM feature misbehaves and the failing layer is unknown, or before shipping an agent stack.

agent-eval

Head-to-head comparison of coding agents (Claude Code, Aider, Codex, etc.) on custom tasks with pass rate, cost, time, and consistency metrics. Use when choosing between coding agents, or when a change to an agent setup needs measured pass rate, cost, and time rather than an impression.

agent-harness-construction

Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates. Use when defining or revising an agent

agentic-engineering

Operate as an agentic engineer using eval-first execution, decomposition, and cost-aware model routing. Use when planning or executing engineering work that agents will carry out end to end.

agentic-os

Build persistent multi-agent operating systems on Claude Code. Covers kernel architecture, specialist agents, slash commands, file-based memory, scheduled automation, and state management without external databases. Use when building a persistent multi-agent system on Claude Code with its own memory, commands, and scheduling.

agent-introspection-debugging

Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports. Use when an agent run fails and you need a reproducible diagnosis instead of a retry.

agent-payment-x402

Add x402 payment execution to AI agents with per-task budgets, spending controls, and non-custodial wallets. Supports Base through agentwallet-sdk and X Layer through OKX Payments / OKX Agent Payments Protocol. Use when an agent must pay for something itself and needs per-task budgets, spending controls, and a non-custodial wallet.

Habilidades Relacionadas