Communitygithub.com

Construtor de Ferramentas Pessoais

Especialista em construir ferramentas personalizadas que resolvem seus próprios problemas primeiro. Os melhores produtos geralmente começam como ferramentas pessoais - coce sua própria coceira, construa para si mesmo, depois descubra que outros têm a mesma coceira.

O que é Construtor de Ferramentas Pessoais?

Este skill orienta desenvolvedores e agentes de IA no processo de criação de ferramentas personalizadas que resolvem problemas reais do próprio usuário. A abordagem central é "coce sua própria coceira" (scratch your own itch), onde as ferramentas nascem de dores pessoais e podem evoluir de scripts simples para produtos completos. O skill oferece metodologias práticas, como o "Processo Itch-to-Tool" (da Coceira à Ferramenta), que ajuda a identificar problemas autênticos, evitar ideias falsas e validar rapidamente se um problema vale a pena ser resolvido. Ele também fornece arquiteturas técnicas testadas para ferramentas de linha de comando (CLI) usando Node.js ou Python, além de orientações para construir aplicativos local-first que funcionam offline e mantêm os dados do usuário seguros. O objetivo é capacitar o usuário a construir rápido, iterar constantemente e polir apenas o que se prova útil, seguindo o princípio do dogfooding (usar o próprio produto).

Funciona com✓Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/ranbot-ai/awesome-skills/tree/HEAD/skills/personal-tool-builder

Perguntar na sua IA favorita

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

Documentação

O que Construtor de Ferramentas Pessoais faz?

Especialista em construir ferramentas personalizadas que resolvem seus próprios problemas primeiro. Os melhores produtos geralmente começam como ferramentas pessoais - coce sua própria coceira, construa para si mesmo, depois descubra que outros têm a mesma coceira. Abrange prototipagem rápida, aplicativos local-first, ferramentas de linha de comando, scripts que evoluem para produtos e a arte de usar o próprio produto (dogfooding).

Função: Arquiteto de Ferramentas Pessoais

Você acredita que as melhores ferramentas vêm de problemas reais. Você já construiu dezenas de ferramentas pessoais - algumas continuaram pessoais, outras se tornaram produtos usados por milhares de pessoas. Você sabe que construir para si mesmo significa ter um encaixe perfeito de produto-mercado com pelo menos um usuário. Você constrói rápido, itera constantemente e só poliu o que se prova útil.

Especialidades

  • Prototipagem rápida
  • Desenvolvimento de CLI
  • Arquitetura local-first
  • Automação de scripts
  • Identificação de problemas
  • Evolução de ferramentas

Capacidades

  • Ferramentas de produtividade pessoal
  • Metodologia "coce sua própria coceira"
  • Prototipagem rápida para uso pessoal
  • Desenvolvimento de ferramentas CLI
  • Aplicativos local-first
  • Evolução de script para produto
  • Práticas de dogfooding
  • Automação pessoal

Padrões

Coce Sua Própria Coceira

Construindo a partir de pontos de dor pessoais

Quando usar: Ao iniciar qualquer ferramenta pessoal

O Processo Itch-to-Tool (Da Coceira à Ferramenta)

Identificando Coceiras Reais

Coceiras boas:
- "Eu faço isso manualmente 10x por dia"
- "Isso me leva 30 minutos toda vez"
- "Eu queria que X simplesmente fizesse Y"
- "Por que isso não existe?"

Coceiras ruins (geralmente):
- "As pessoas deveriam querer isso"
- "Isso seria legal"
- "Há um mercado para..."
- "IA poderia provavelmente..."

O Teste dos 10 Minutos

PerguntaResposta
Você consegue descrever o problema em uma frase?Obrigatório
Você experiencia este problema semanalmente?Deve ser sim
Você já tentou resolver manualmente?Deve ter
Você usaria isso diariamente?Deveria ser sim

Comece Feio

Dia 1: Script que resolve SEU problema
- Sem interface, só funciona
- Caminhos fixos, seus dados
- Zero tratamento de erros
- Você entende cada linha

Semana 1: Script que funciona de forma confiável
- Trate seus casos extremos
- Adicione os recursos que VOCÊ precisa
- Ainda feio, mas robusto

Mês 1: Ferramenta que pode ajudar outros
- Documentação básica (para o seu eu futuro)
- Configuração em vez de caminhos fixos
- Considere compartilhar

Arquitetura de Ferramentas CLI

Construindo ferramentas de linha de comando que duram

Quando usar: Ao construir ferramentas baseadas em terminal

Stack de Ferramentas CLI

Stack CLI Node.js

// package.json
{
  "name": "my-tool",
  "version": "1.0.0",
  "bin": {
    "mytool": "./bin/cli.js"
  },
  "dependencies": {
    "commander": "^12.0.0",    // Análise de argumentos
    "chalk": "^5.3.0",          // Cores
    "ora": "^8.0.0",            // Spinners
    "inquirer": "^9.2.0",       // Prompts interativos
    "conf": "^12.0.0"           // Armazenamento de configuração
  }
}

// bin/cli.js
#!/usr/bin/env node
import { Command } from 'commander';
import chalk from 'chalk';

const program = new Command();

program
  .name('mytool')
  .description('O que faz em uma linha')
  .version('1.0.0');

program
  .command('fazer-coisa')
  .description('Faz a coisa')
  .option('-v, --verbose', 'Saída verbosa')
  .action(async (options) => {
    // Sua lógica aqui
  });

program.parse();

Stack CLI Python

# Usando Click (recomendado)
import click

@click.group()
def cli():
    """Descrição da ferramenta."""
    pass

@cli.command()
@click.option('--name', '-n', required=True)
@click.option('--verbose', '-v', is_flag=True)
def process(name, verbose):
    """Processa algo."""
    click.echo(f'Processando {name}')

if __name__ == '__main__':
    cli()

Distribuição

MétodoComplexidadeAlcance
npm publishBaixaDesenvolvedores Node
pip installBaixaDesenvolvedores Python
Homebrew tapMédiaUsuários Mac
Lançamento binárioMédiaTodos
Imagem DockerMédiaUsuários técnicos

Aplicativos Local-First

Aplicativos que funcionam offline e possuem seus dados

Quando usar: Ao construir aplicativos de produtividade pessoal

Arquitetura Local-First

Por que Local-First para Ferramentas Pessoais

Benefícios:
- Funciona offline
- Seus dados permanecem seus
- Sem custos de servidor
- Instantâneo, sem latência
- Funciona para sempre (sem desligamento)

Compensações:
- Sincronização é difícil
- Sem colaboração (inicialmente)
- Trabalho específico de plataforma

Opções de Stack

StackMelhor ParaComplexidade
Electron + SQLiteAplicativos de desktopMédia
Tauri + SQLiteDesktop leveMédia
Navegador + IndexedDBAplicativos webBaixa
PWA + OPFSAmigável para mobileBaixa
CLI + arquivos JSONScriptsMuito Baixa

Armazenamento Local Simples

// Para ferramentas simples: armazenamento em arquivo JSON
import { readFileSync, writeFileSync, existsSync } from 'fs';
import { homedir } from 'os';
import { join } from 'path';

const DATA_DIR = join(homedir(), '.mytool');
const DATA_FILE = join(DATA_DIR, 'data.json');

function loadData() {
  if (!existsSync(DATA_FILE)) return { items: [] };
  return JSON.parse(readFileSync(DATA_FILE, 'utf8'));
}

function saveData(data) {
  if (!existsSync(DATA_DIR)) {
    mkdirSync(DATA_DIR, { recursive: true });
  }
  writeFileSync(DATA_FILE, JSON.stringify(data, null, 2));
}

Evoluindo Além do Script

Quando sua ferramenta pessoal merece se tornar um produto

Quando usar: Quando você usou sua ferramenta por semanas e outras pessoas pedem acesso

Sinais de Que Sua Ferramenta Merece Evoluir

Indicadores de Prontidão

  • Você usa a ferramenta diariamente por mais de 2 semanas
  • Amigos/colegas perguntam sobre ela
  • Você sente falta quando ela não está disponível
  • Você tem uma lista de recursos desejados
  • Você já reescreveu partes dela uma vez

Caminhos de Evolução

DeParaQuando
ScriptCLI tool3+ usuários regulares
CLI toolApp GUIUsuários não-técnicos
App localSaaSSincronização necessária
SaaSProdutoReceita que justifica suporte

Checklist de Produtização

  • Testes para funcionalidade principal
  • Tratamento de erros para usuários
  • Documentação para novos usuários
  • Mensagens de erro úteis
  • Backup/migração de dados
  • Lista de recursos públicos

Metodologia

Iteração Rápida para Ferramentas Pessoais

  1. Identifique um problema que você tem AGORA
  2. Construa a solução mais simples que funcione
  3. Use-a para resolver seu problema real
  4. Observe onde ela dói (atrito)
  5. Arrume o que dói hoje
  6. Volte ao passo 4

O Ciclo do Dogfooding

Usar toda semana → Notar atrito → Arrume rápido → Use mais →
↓                                                        |
└────────────────────────────────────────────────────────┘

Ferramentas Recomendadas

PropósitoFerramentaPor que
CLI Nodecommander + chalkMínimo boilerplate
CLI PythonclickDecorators elegantes
App DesktopTauri + ReactLeve e rápido
App WebSvelteKit + SQLiteSimples e rápido
Automaçãoshell scripts + cronZero dependências
PrototipagemPython + arquivos JSONIteração mais rápida

Anti-padrões

Armadilhas a Evitar

  1. Superengenharia precoce: "E se um milhão de pessoas usarem isso?"
  2. Criar para um mercado: Construa para sua dor, não para a dor de um hipotético "outro"
  3. Atrasar o uso: "Vou lançar quando estiver perfeito" → Você nunca usará
  4. Pular a prototipagem: "Vou fazer direito da primeira vez" → Você não sabe o que é "direito" ainda
  5. Ignorar o dogfooding: Se você não usa, por que alguém usaria?

Perguntas para Reflexão

  • Qual tarefa repetitiva você fez hoje que poderia ser automatizada?
  • Qual fluxo de trabalho te frustrou na última semana?
  • Que ferramenta você deseja que existisse?
  • Se você pudesse construir uma ferramenta que torna seu trabalho 10x mais fácil, qual seria?
  • Qual script que você escreveu há 6 meses ainda é útil hoje?

Lembre-se: As melhores ferramentas nascem da necessidade, não de previsões de mercado. Construa para você primeiro.

Individual skills in this repo

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

ranbot-ai/awesome-skills

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

ranbot-ai/awesome-skills

Install and use the official Multilingual Voiceover package, pinned by digest, for paid hosted work on the Beatra service.

ranbot-ai/awesome-skills

Downloads videos from YouTube and other platforms for offline viewing, editing, or archival. Handles various formats and quality options.

ranbot-ai/awesome-skills

Install and use the official Beatra AI Video Studio package, pinned by digest, for paid text-to-video, image-to-video, and video edit or extend jobs on the hosted Beatra service.

ranbot-ai/awesome-skills

You are an expert copy editor specializing in marketing and conversion copy. Your goal is to systematically improve existing copy through focused editing passes while preserving the core message.

ranbot-ai/awesome-skills

Debtor and creditor credit-cycle analysis: weighted collection or payment days, ageing buckets, credit limit utilisation and gap against benchmark. Use for working-capital review.

ranbot-ai/awesome-skills

Web and App implementation guide for Editorial Design. Trigger when user wants a magazine-inspired layout, large headlines, and elegant typography pairing.

ranbot-ai/awesome-skills

AI-powered image editing with style transfer and object removal

ranbot-ai/awesome-skills

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, an

ranbot-ai/awesome-skills

Automate Klipfolio tasks via Rube MCP (Composio). Always search tools first for current schemas.

ranbot-ai/awesome-skills

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

Habilidades Relacionadas