[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77WRDM1TD9AMN0R6C02KRZ1":3,"skill-same:01M77WRDM1TD9AMN0R6C02KRZ1":46},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":30,"updatedAt":31,"install":32,"resources":45},"01M77WRDM1TD9AMN0R6C02KRZ1","ajustar-detalhe-prototipo",null,"Constrói uma ferramenta interativa com sliders, arrasto e guias visuais para o usuário escolher ele mesmo valores visuais exatos — posição, espaçamento, tamanho — e exporta os valores mapeados às linhas de código. Use quando o usuário pede ajuste fino que não converge por descrição (\"sobe um pouco… demais… menos\"), quando cada tentativa exige rebuild lento, ou quando o controle que você mexe quase não move o resultado. NÃO use quando o valor certo é óbvio, quando ninguém precisa julgar visualmente, ou para mudança de design mais ampla (melhorar-prototipo).","matheus3006\u002Fmy-claude-skills","matheus3006","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F50412351?v=4","01M77WPFK1CBGVJ3195EH69G16","Matheus de Souza","01M77WPFKMHK33H8ZN58CMV1S3",0,"MIT","https:\u002F\u002Fgithub.com\u002Fmatheus3006\u002Fmy-claude-skills\u002Fblob\u002Fmain\u002Frecomendada\u002Fajustar-detalhe-prototipo\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: ajustar-detalhe-prototipo\ndescription: Constrói uma ferramenta interativa com sliders, arrasto e guias visuais para o usuário escolher ele mesmo valores visuais exatos — posição, espaçamento, tamanho — e exporta os valores mapeados às linhas de código. Use quando o usuário pede ajuste fino que não converge por descrição (\"sobe um pouco… demais… menos\"), quando cada tentativa exige rebuild lento, ou quando o controle que você mexe quase não move o resultado. NÃO use quando o valor certo é óbvio, quando ninguém precisa julgar visualmente, ou para mudança de design mais ampla (melhorar-prototipo).\n---\n\n# ajustar-detalhe-prototipo\n\nQuando um humano precisa escolher **valores visuais exatos** e seu loop é\n`edita → rebuild → olha → \"um pouco mais… demais\"`, pare de adivinhar. Construa uma\nferramenta que renderiza o componente fielmente, expõe os valores como controles ao\nvivo com guias objetivas, e exporta os números já mapeados às linhas de código.\n\nO humano ajusta; você porta uma vez. Seu papel muda de *\"adivinhar o número\"* para\n*\"construir o botão e ler o resultado\"*.\n\n**Leia primeiro:** `~\u002F.claude\u002Fskills\u002Fprototipo-html\u002Freferences\u002Fconvencoes.md`.\n\n## O gatilho\n\n**Depois de 1 ou 2 palpites que não acertaram — não depois de cinco.** Reconhecer cedo é\nmetade do valor. Nomeie em voz alta: \"isso é problema de ajuste, não de valor — vou\nconstruir o controle.\"\n\nSinais de que já passou da hora:\n- O pedido é vago por natureza (\"mais pra baixo\", \"respirando melhor\")\n- Cada ciclo custa caro (rebuild nativo, deploy de preview)\n- O controle que você mexe quase não move a coisa\n\n**Quando não usar:** valor único e óbvio, nenhum julgamento humano necessário, ou o loop\njá é instantâneo **e** você sabe nomear o alvo exato.\n\n## Por que o loop não converge\n\nDuas falhas se somam:\n\n1. **Superfície de controle errada.** Controles que distribuem sobra (`flex`, `Spacer`,\n   `justify-content`) só têm o que distribuir se sobrar espaço. Com conteúdo quase\n   preenchendo a tela, mudar a proporção move poucos pixels. O usuário pede \"bem mais\n   pra baixo\" e o botão não entrega. Caso real: mudar de 2:1 para 3:1 moveu 15px.\n\n2. **Você é um tradutor com perda.** O humano descreve uma sensação → você chuta um\n   inteiro → rebuild lento → ele reage a um número que nunca viu. O viés de recência\n   apaga a versão anterior e ninguém consegue segurar um valor.\n\nA solução ataca os dois: muda o meio (browser, tempo real) **e** entrega o controle\ndireto à mão de quem julga.\n\n## Os 5 detalhes que fazem funcionar\n\nSem qualquer um deles, o vaivém volta.\n\n| # | Detalhe | Se faltar |\n|---|---|---|\n| 1 | **Reconhecer o gatilho cedo** — 1 ou 2 palpites, e troca de abordagem | Cinco ciclos de rebuild e frustração |\n| 2 | **Inicializar nos valores reais de hoje**, com botão \"resetar para o atual\" | A ferramenta mente: ele ajusta contra uma ficção |\n| 3 | **Exportar mapeado às linhas de código** (`gap: 36` → `linha 84 de x.dart`) + botão de copiar | Você re-traduz e reintroduz o erro |\n| 4 | **Guias objetivas e aviso de validade** — linha de centro, marcador do alvo, delta ao vivo, aviso de overflow\u002Fcorte | Ele aprova um layout que estoura no aparelho |\n| 5 | **Modelar como o código real dispõe, e escolher controle que alcança o alvo** | Ajusta em `flex` (não chega lá) ou em px absoluto que não sobrevive ao porte |\n\nDebaixo dos cinco: **renderizar fielmente**. Assets e SVG reais, ordem real dos\nelementos, altura real dos campos, moldura de aparelho com safe area, e seletor de\ntamanho de tela — \"o centro\" depende da altura da tela.\n\n## Fluxo\n\n1. **Nomeie o gatilho** e diga que vai construir o controle.\n2. **Trave a granularidade** com `AskUserQuestion`: arrastar o bloco inteiro · ajuste\n   fino leve · controle por gap individual. Granularidade demais também trava a decisão.\n3. **Leia os valores atuais** no código de produção — a ferramenta abre neles (detalhe 2).\n4. **Construa** em `\u003Craiz>\u002F\u003Ctask-id>\u002F`, seguindo o contrato (React 18 + Babel via CDN,\n   tokens em CSS var, light e dark). Cada valor ganha slider **e** campo numérico:\n   slider para explorar, campo para fechar.\n5. **Verifique você mesmo** antes de entregar: suba com `\u002Finiciar-prototipo`, console\n   limpo, exercite um slider e o arrasto, confira nos dois temas. A ferramenta precisa\n   renderizar fiel **antes** do humano tocar nela.\n6. **Entregue a URL.** Ele ajusta até as guias confirmarem e aprova.\n7. **Leia os valores exportados** e porte **de uma vez só** — uma edição, valores 1:1.\n   Sem re-interpretar.\n8. **Verifique o resultado real** e **abra a imagem**. Comparar hash ou tamanho de\n   arquivo não é verificação.\n\n## O painel de export\n\nO que separa a ferramenta útil da ferramenta bonita:\n\n```\ntopo:        88px   →  linha 42: SizedBox(height: 88)\nlogo:       240px   →  linha 51: BrandLogo(width: 240)\nlogo→email:  55px   →  linha 63: SizedBox(height: 55)\n                                              [copiar]\n```\n\nCada valor ao lado do lugar exato que muda. Assim o porte é mecânico, não uma segunda\nrodada de adivinhação.\n\n## Guias que tornam \"quase no meio\" mensurável\n\n- Linha de centro do espaço útil\n- Marcador no elemento que o usuário citou como referência\n- Delta ao vivo (\"38px acima do centro\")\n- **Aviso de overflow ou corte** — o valor mais bonito às vezes empurra conteúdo para\n  fora da tela; sem o aviso ele aprova sem saber\n\nCaso real: o bloco de login (587px) era mais alto que a área útil (711px), então centrar\no e-mail jogava o link de cadastro para fora. O aviso tornou o trade-off visível, e o\nusuário escolheu conscientemente outra composição.\n\n## Anti-padrões\n\n| Erro | Correção |\n|---|---|\n| Continuar mexendo no mesmo controle porque \"mais um pouco resolve\" | Depois de 2 palpites, construa a ferramenta |\n| Ferramenta abre em valores arbitrários | Inicialize nos valores reais + botão de reset |\n| Exportar números soltos | Exporte mapeado às linhas, com botão de copiar |\n| Buscar o centro perfeito ignorando se cabe | Aviso de overflow; deixe o trade-off explícito |\n| Ajustar em `flex` e depois brigar com o porte | Modele como o código real dispõe |\n| Dizer \"ficou bom\" a partir do tamanho do arquivo de imagem | Abra e **olhe** a imagem |\n","# ajustar-detalhe-prototipo\n\nQuando um humano precisa escolher **valores visuais exatos** e seu loop é\n`edita → rebuild → olha → \"um pouco mais… demais\"`, pare de adivinhar. Construa uma\nferramenta que renderiza o componente fielmente, expõe os valores como controles ao\nvivo com guias objetivas, e exporta os números já mapeados às linhas de código.\n\nO humano ajusta; você porta uma vez. Seu papel muda de *\"adivinhar o número\"* para\n*\"construir o botão e ler o resultado\"*.\n\n**Leia primeiro:** `~\u002F.claude\u002Fskills\u002Fprototipo-html\u002Freferences\u002Fconvencoes.md`.\n\n## O gatilho\n\n**Depois de 1 ou 2 palpites que não acertaram — não depois de cinco.** Reconhecer cedo é\nmetade do valor. Nomeie em voz alta: \"isso é problema de ajuste, não de valor — vou\nconstruir o controle.\"\n\nSinais de que já passou da hora:\n- O pedido é vago por natureza (\"mais pra baixo\", \"respirando melhor\")\n- Cada ciclo custa caro (rebuild nativo, deploy de preview)\n- O controle que você mexe quase não move a coisa\n\n**Quando não usar:** valor único e óbvio, nenhum julgamento humano necessário, ou o loop\njá é instantâneo **e** você sabe nomear o alvo exato.\n\n## Por que o loop não converge\n\nDuas falhas se somam:\n\n1. **Superfície de controle errada.** Controles que distribuem sobra (`flex`, `Spacer`,\n   `justify-content`) só têm o que distribuir se sobrar espaço. Com conteúdo quase\n   preenchendo a tela, mudar a proporção move poucos pixels. O usuário pede \"bem mais\n   pra baixo\" e o botão não entrega. Caso real: mudar de 2:1 para 3:1 moveu 15px.\n\n2. **Você é um tradutor com perda.** O humano descreve uma sensação → você chuta um\n   inteiro → rebuild lento → ele reage a um número que nunca viu. O viés de recência\n   apaga a versão anterior e ninguém consegue segurar um valor.\n\nA solução ataca os dois: muda o meio (browser, tempo real) **e** entrega o controle\ndireto à mão de quem julga.\n\n## Os 5 detalhes que fazem funcionar\n\nSem qualquer um deles, o vaivém volta.\n\n| # | Detalhe | Se faltar |\n|---|---|---|\n| 1 | **Reconhecer o gatilho cedo** — 1 ou 2 palpites, e troca de abordagem | Cinco ciclos de rebuild e frustração |\n| 2 | **Inicializar nos valores reais de hoje**, com botão \"resetar para o atual\" | A ferramenta mente: ele ajusta contra uma ficção |\n| 3 | **Exportar mapeado às linhas de código** (`gap: 36` → `linha 84 de x.dart`) + botão de copiar | Você re-traduz e reintroduz o erro |\n| 4 | **Guias objetivas e aviso de validade** — linha de centro, marcador do alvo, delta ao vivo, aviso de overflow\u002Fcorte | Ele aprova um layout que estoura no aparelho |\n| 5 | **Modelar como o código real dispõe, e escolher controle que alcança o alvo** | Ajusta em `flex` (não chega lá) ou em px absoluto que não sobrevive ao porte |\n\nDebaixo dos cinco: **renderizar fielmente**. Assets e SVG reais, ordem real dos\nelementos, altura real dos campos, moldura de aparelho com safe area, e seletor de\ntamanho de tela — \"o centro\" depende da altura da tela.\n\n## Fluxo\n\n1. **Nomeie o gatilho** e diga que vai construir o controle.\n2. **Trave a granularidade** com `AskUserQuestion`: arrastar o bloco inteiro · ajuste\n   fino leve · controle por gap individual. Granularidade demais também trava a decisão.\n3. **Leia os valores atuais** no código de produção — a ferramenta abre neles (detalhe 2).\n4. **Construa** em `\u003Craiz>\u002F\u003Ctask-id>\u002F`, seguindo o contrato (React 18 + Babel via CDN,\n   tokens em CSS var, light e dark). Cada valor ganha slider **e** campo numérico:\n   slider para explorar, campo para fechar.\n5. **Verifique você mesmo** antes de entregar: suba com `\u002Finiciar-prototipo`, console\n   limpo, exercite um slider e o arrasto, confira nos dois temas. A ferramenta precisa\n   renderizar fiel **antes** do humano tocar nela.\n6. **Entregue a URL.** Ele ajusta até as guias confirmarem e aprova.\n7. **Leia os valores exportados** e porte **de uma vez só** — uma edição, valores 1:1.\n   Sem re-interpretar.\n8. **Verifique o resultado real** e **abra a imagem**. Comparar hash ou tamanho de\n   arquivo não é verificação.\n\n## O painel de export\n\nO que separa a ferramenta útil da ferramenta bonita:\n\n```\ntopo:        88px   →  linha 42: SizedBox(height: 88)\nlogo:       240px   →  linha 51: BrandLogo(width: 240)\nlogo→email:  55px   →  linha 63: SizedBox(height: 55)\n                                              [copiar]\n```\n\nCada valor ao lado do lugar exato que muda. Assim o porte é mecânico, não uma segunda\nrodada de adivinhação.\n\n## Guias que tornam \"quase no meio\" mensurável\n\n- Linha de centro do espaço útil\n- Marcador no elemento que o usuário citou como referência\n- Delta ao vivo (\"38px acima do centro\")\n- **Aviso de overflow ou corte** — o valor mais bonito às vezes empurra conteúdo para\n  fora da tela; sem o aviso ele aprova sem saber\n\nCaso real: o bloco de login (587px) era mais alto que a área útil (711px), então centrar\no e-mail jogava o link de cadastro para fora. O aviso tornou o trade-off visível, e o\nusuário escolheu conscientemente outra composição.\n\n## Anti-padrões\n\n| Erro | Correção |\n|---|---|\n| Continuar mexendo no mesmo controle porque \"mais um pouco resolve\" | Depois de 2 palpites, construa a ferramenta |\n| Ferramenta abre em valores arbitrários | Inicialize nos valores reais + botão de reset |\n| Exportar números soltos | Exporte mapeado às linhas, com botão de copiar |\n| Buscar o centro perfeito ignorando se cabe | Aviso de overflow; deixe o trade-off explícito |\n| Ajustar em `flex` e depois brigar com o porte | Modele como o código real dispõe |\n| Dizer \"ficou bom\" a partir do tamanho do arquivo de imagem | Abra e **olhe** a imagem |\n",{"name":5,"description":7},"main","f06c5ff2d4922cfb68d125b55b741eb50004b156","recomendada\u002Fajustar-detalhe-prototipo","https:\u002F\u002Fgithub.com\u002Fmatheus3006\u002Fmy-claude-skills","https:\u002F\u002Fgithub.com\u002Fmatheus3006","https:\u002F\u002Fwww.linkedin.com\u002Fin\u002Fmatheus-de-souza-264783b8\u002F","Senior Software Engineer · Fraud prevention, identity & payments · Java\u002FKotlin · TS\u002FNode · Co-founder & CTO at StackLabs","2026-11-02 00:49:15",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add matheus3006\u002Fmy-claude-skills --skill ajustar-detalhe-prototipo",{"tool":38,"command":39},"bunx","bunx skills add matheus3006\u002Fmy-claude-skills --skill ajustar-detalhe-prototipo",{"tool":41,"command":42},"pnpm","pnpm dlx skills add matheus3006\u002Fmy-claude-skills --skill ajustar-detalhe-prototipo","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmatheus3006\u002Fmy-claude-skills\u002Fblob\u002Fmain\u002Frecomendada\u002Fajustar-detalhe-prototipo\u002FSKILL.md",true,[],[47,54,61,68,75,82],{"skillNo":48,"name":49,"nameZh":6,"description":50,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":51,"categories":52,"keywords":53,"publishedAt":19},"01M77WXZ0KFG8A700E3K6SF467","zoom-out","Tell the agent to zoom out and give broader context or a higher-level perspective. Use when you're unfamiliar with a section of code or need to understand how it fits into the bigger picture.","https:\u002F\u002Fgithub.com\u002Fmatheus3006\u002Fmy-claude-skills\u002Fblob\u002Fmain\u002Fzoom-out\u002FSKILL.md",[],[],{"skillNo":55,"name":56,"nameZh":6,"description":57,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":58,"categories":59,"keywords":60,"publishedAt":19},"01M77WXX3HH8FEB01GNT170TR3","writing-great-skills","Reference for writing and editing skills well — the vocabulary and principles that make a skill predictable.","https:\u002F\u002Fgithub.com\u002Fmatheus3006\u002Fmy-claude-skills\u002Fblob\u002Fmain\u002Fwriting-great-skills\u002FSKILL.md",[],[],{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":19},"01M77WXTC7VFEK0Y2DMPS9XFYM","write-a-skill","Create new agent skills with proper structure, progressive disclosure, and bundled resources. Use when user wants to create, write, or build a new skill.","https:\u002F\u002Fgithub.com\u002Fmatheus3006\u002Fmy-claude-skills\u002Fblob\u002Fmain\u002Fwrite-a-skill\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":19},"01M77WXPMH0JVN4J86J8RXCT29","teach","Teach the user a new skill or concept, within this workspace.","https:\u002F\u002Fgithub.com\u002Fmatheus3006\u002Fmy-claude-skills\u002Fblob\u002Fmain\u002Fteach\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M77WXKEZP05PHBC362EPKK03","resumo-trabalho","Resumo do trabalho de um período, agrupado pelas partes do produto, para quem não lê código. Use quando o usuário pedir um resumo ou status do que foi feito nos últimos dias, para mandar ao cliente, ao sócio ou ao gestor. NÃO use para o relatório ponto a ponto de uma entrega (relatorio-de-entrega) nem para o corpo de PR (pr).","https:\u002F\u002Fgithub.com\u002Fmatheus3006\u002Fmy-claude-skills\u002Fblob\u002Fmain\u002Fresumo-trabalho\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M77WXHNPY7158KF95C5JQAGC","writing-for-agents","Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.","https:\u002F\u002Fgithub.com\u002Fmatheus3006\u002Fmy-claude-skills\u002Fblob\u002Fmain\u002Frecomendada\u002Fwriting-for-agents\u002FSKILL.md",[],[]]