Communitygithub.com

satnamrsm/https-github.com-sickn33-antigravity-awesome-skills

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

O que é https-github.com-sickn33-antigravity-awesome-skills?

O **Personal Tool Builder** é um guia prático para desenvolvedores que desejam criar ferramentas resolvendo seus próprios problemas reais, seguindo a filosofia "scratch your own itch" (coce a própria coceira). A habilidade ensina desde a identificação de dores autênticas no dia a dia até a evolução de um script simples para uma ferramenta que pode ajudar outras pessoas. Ela cobre padrões essenciais como prototipagem rápida, desenvolvimento de CLIs robustos (Node.js e Python), arquitetura local-first (trabalhe offline, seus dados são seus) e armazenamento local com JSON ou SQLite. Além disso, alerta sobre anti-padrões como construir para usuários imaginários, superengenharia prematura e não usar a própria ferramenta (dogfooding). Ideal para quem usa Claude Code, Cursor, Codex ou qualquer plataforma de agente de IA, este skill incentiva a construir rápido, iterar constantemente e polir apenas o que se prova útil.

Funciona com~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/satnamrsm/https-github.com-sickn33-antigravity-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

Construtor de Ferramentas Pessoais

Papel: Arquiteto de Ferramentas Pessoais

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

Capacidades

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

Padrões

Coce a Própria Coceira

Construindo a partir de pontos de dor pessoais

Quando usar: Ao iniciar qualquer ferramenta pessoal

## O Processo Coceira-para-Ferramenta

### Identificando Coceiras Reais

Boas coceiras:

  • "Eu faço isso manualmente 10x por dia"
  • "Isso leva 30 minutos toda vez que faço"
  • "Eu gostaria que X simplesmente fizesse Y"
  • "Por que isso não existe?"

Coceiras ruins (geralmente):

  • "As pessoas deveriam querer isso"
  • "Isso seria legal"
  • "Existe um mercado para..."
  • "IA poderia provavelmente..."

### O Teste de 10 Minutos
| Pergunta | Resposta |
|----------|----------|
| Você consegue descrever o problema em uma frase? | Obrigatório |
| Você experimenta esse problema semanalmente? | Deve ser sim |
| Você já tentou resolver manualmente? | Deve ter tentado |
| Você usaria isso diariamente? | Deveria ser sim |

### Comece Feio

Dia 1: Script que resolve SEU problema

  • Sem interface, só funciona
  • Caminhos hardcoded, 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 você do futuro)
  • Configuração em vez de hardcoding
  • Considere compartilhar

Arquitetura de Ferramentas CLI

Construindo ferramentas de linha de comando que duram

Quando usar: Ao construir ferramentas baseadas em terminal

## Stack de CLI

### Stack Node.js CLI
```javascript
// 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('faz-coisa')
  .description('Faz a coisa')
  .option('-v, --verbose', 'Saída detalhada')
  .action(async (options) => {
    // Sua lógica aqui
  });

program.parse();

Stack Python CLI

# Usando Click (recomendado)
import click

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

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

if __name__ == '__main__':
    cli()

Distribuição

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

### Aplicativos Local-Primeiro

Apps que funcionam offline e são donos dos seus dados

**Quando usar**: Ao construir aplicativos de produtividade pessoal

```python
## Arquitetura Local-Primeiro

### Por que Local-Primeiro para Ferramentas Pessoais

Benefícios:

  • Funciona offline
  • Seus dados permanecem seus
  • Sem custos de servidor
  • Instantâneo, sem latência
  • Funciona para sempre (sem desligamentos)

Compensações:

  • Sincronização é difícil
  • Sem colaboração (inicialmente)
  • Trabalho específico de plataforma

### Opções de Stack
| Stack | Melhor Para | Complexidade |
|-------|-------------|--------------|
| Electron + SQLite | Apps desktop | Média |
| Tauri + SQLite | Desktop leve | Média |
| Navegador + IndexedDB | Apps web | Baixa |
| PWA + OPFS | Mobile-friendly | Baixa |
| CLI + arquivos JSON | Scripts | Muito Baixa |

### Armazenamento Local Simples
```javascript
// 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);
  writeFileSync(DATA_FILE, JSON.stringify(data, null, 2));
}

SQLite para Ferramentas Mais Complexas

// better-sqlite3 para Node.js
import Database from 'better-sqlite3';
import { join } from 'path';
import { homedir } from 'os';

const db = new Database(join(homedir(), '.mytool', 'data.db'));

// Cria tabelas na primeira execução
db.exec(`
  CREATE TABLE IF NOT EXISTS items (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT NOT NULL,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
  )
`);

// Consultas síncronas rápidas
const items = db.prepare('SELECT * FROM items').all();

## Anti-Padrões

### ❌ Construindo para Usuários Imaginários

**Por que é ruim**: Nenhum ciclo de feedback real.
Construir recursos que ninguém precisa.
Desistir por falta de motivação.
Resolver o problema errado.

**Em vez disso**: Construa para você primeiro.
Problema real = motivação real.
Você é o primeiro testador.
Expanda usuários depois.

### ❌ Superengenharia de Ferramentas Pessoais

**Por que é ruim**: Leva uma eternidade para construir.
Mais difícil de modificar depois.
Complexidade mata a motivação.
Perfeito é inimigo do feito.

**Em vez disso**: Script mínimo viável.
Adicione complexidade quando necessário.
Refatore apenas quando doer.
Feio mas funcionando > bonito mas incompleto.

### ❌ Não Fazer Dogfooding

**Por que é ruim**: Perder problemas óbvios de UX.
Não encontrar bugs reais.
Recursos que não ajudam.
Nenhuma paixão por melhoria.

**Em vez disso**: Use sua ferramenta diariamente.
Sinta a dor de uma UX ruim.
Conserte o que te incomoda.
Suas necessidades = necessidades do usuário.

## ⚠️ Arestas Cortantes

| Problema | Severidade | Solução |
|----------|------------|---------|
| Ferramenta só funciona no seu ambiente específico | média | ## Tornando Ferramentas Portáteis |
| Configuração se torna ingerenciável | média | ## Domando a Configuração |
| Ferramenta pessoal se torna não mantida | baixa | ## Ferramentas Pessoais Sustentáveis |
| Ferramentas pessoais com vulnerabilidades de segurança | alta | ## Segurança em Ferramentas Pessoais |

## Habilidades Relacionadas

Funciona bem com: `micro-saas-launcher`, `browser-extension-builder`, `workflow-automation`, `backend`

## Quando Usar
Esta habilidade é aplicável para executar o workflow ou ações descritas na visão geral.

Individual skills in this repo

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

Habilidades Relacionadas