LVL LTD Skill Market

Habilidades LVTD

Habilidades de agente reutilizáveis para projetos LVTD, fluxos de trabalho SaaS com Django e desenvolvimento de software centrado em agentes.

Este repositório é intencionalmente simples: cada habilidade vive em skills/<skill-name>/SKILL.md, com pequenos scripts de validação e publicação ao redor desse catálogo. Esse formato funciona bem para agentes que leem pastas de habilidades diretamente, e é fácil para índices externos como skills.sh consumirem.

Fluxos de Trabalho Comuns

Comece com lvtd-skills-router quando você não tiver certeza de qual habilidade se encaixa. Ele roteia por domínio e resultado desejado, depois aponta o agente para o menor conjunto útil de habilidades.

• Trabalho com Django SaaS: use django-htmx para atualizações parciais renderizadas no servidor, alpinejs-django para comportamento local de templates, django-q2 para jobs em segundo plano, fastmcp-django para servidores MCP dentro de aplicativos Django, e as habilidades django-test-* quando as suítes de teste precisarem de profiling, configuração de dados mais rápida, paralelismo ou otimização de CI.
• Trabalho com htmx independente de framework: use htmx-foundations para arquitetura e primeiros fluxos de trabalho, htmx-endpoint-design para contratos de requisição/fragmento, htmx-recipes para padrões comuns de interação, htmx-security para XSS, CSP, CSRF e sanitização, htmx-realtime para polling/SSE/WebSockets, htmx-interactivity para Alpine.js ou coordenação com _hyperscript, e htmx-js-api para integrações htmx imperativas.
• Documentação para desenvolvedores: use developer-docs-technical-research antes de escrever a partir de fatos de produto incompletos, developer-docs-planning e developer-docs-drafting para planos e páginas de documentação, saas-documentation para documentação de serviços hospedados e runbooks, documentation-platform-selection para decisões de ferramentas de documentação, e docs-agile-integration para integração com processos de sprint e release.
• Trabalho com serviços e jogos em Rust: use rust-api-test-harness para testes de integração HTTP black-box, depois recorra às habilidades de serviços Rust quando o trabalho envolver SQLx/Postgres, limites de domínio, observabilidade, segurança, fluxos de trabalho idempotentes ou prontidão para deploy. Para trabalho em Rust no nível de linguagem, use as habilidades de ownership, API de traits, iteradores/coleções, concorrência, async, unsafe e FFI. Para jogos pequenos em Rust, use as habilidades de game-slice, game-loop, tilemap, ECS, turn-intent, procgen/AI, conteúdo orientado a dados e polimento de release.
• SEO e crescimento orgânico: use seo-opportunity-research para encontrar demanda, seo-persona-intent-mapping para esclarecer público e intenção, product-led-seo-strategy para moldar a estratégia, seo-roadmap-prioritization para sequenciar o trabalho, e technical-seo-triage para problemas de indexação ou tráfego.
• Livros de não ficção úteis: use book-toc-lab para moldar a promessa, o escopo, o resultado para o leitor e o sumário focado em takeaways; use book-reader-conversations para validação pré-rascunho, technical-book-lab-design, technical-manuscript-verification e evergreen-technical-book para livros técnicos práticos, e manuscript-engagement-analytics junto com as outras habilidades de não ficção para edições de experiência do leitor, feedback de beta, marketing inicial, otimização de vendas e produção de autopublicação.
• Descoberta de clientes: use customer-discovery-conversations para planejar melhores conversas com clientes, depois use as habilidades relacionadas para segmentação de fatias, acesso a conversas, validação de compromisso e síntese de anotações.
• Tração para startups: use as habilidades de tração para escolher canais, pesquisar caminhos de crescimento comparáveis, projetar testes baratos, revisar resultados e planejar experimentos específicos por canal.
• Polimento de produto e lançamento: use make-product-viral para melhorar clareza, memorabilidade, intenção de compra e compartilhamento em superfícies voltadas ao produto.
• Operações de catálogo e templates: use calibredb para operações de biblioteca Calibre e cookiecutter para criação de templates, hooks e validação de projetos gerados.

Descoberta de Habilidades

Use lvtd-skills-router quando você não tiver certeza de qual habilidade se encaixa. O catálogo completo vive em skills/ e no registro gerado; este README intencionalmente agrupa fluxos de trabalho em vez de espelhar cada arquivo de habilidade.

Áreas de habilidades:

• Django: UI renderizada no servidor, HTMX, Alpine.js, jobs em segundo plano, servidores MCP e otimização de suítes de teste Django.
• htmx: fundamentos, contratos de endpoint, receitas comuns de interação, coordenação de interatividade local, integração com API JavaScript, transportes em tempo real e endurecimento de segurança para aplicativos web dirigidos por servidor.
• Documentação para desenvolvedores: pesquisa de público, pesquisa técnica, planejamento, redação, edição, exemplos de código, visuais, documentação SaaS, integração Agile, seleção de plataforma, triagem de feedback, métricas, arquitetura da informação, release e manutenção.
• Rust: harnesses de teste para APIs HTTP, persistência SQLx/Postgres, limites de domínio, observabilidade, segurança, fluxos de trabalho idempotentes, deploy, ownership/borrowing, design de API com traits, iteradores/coleções, concorrência, tarefas async, limites unsafe, wrappers FFI e fluxos de trabalho de desenvolvimento de jogos 2D para planejamento, loops, tilemaps, ECS, turnos, procgen, conteúdo e release.
• SEO: pesquisa de oportunidades, mapeamento persona-intenção, estratégia orientada por produto, priorização de roadmap e triagem técnica de SEO.
• Escrita de não ficção: design de sumário, edição de experiência do leitor, feedback de beta, marketing inicial, otimização de vendas e produção.
• Descoberta de clientes: planejamento de entrevistas com clientes, segmentação de fatias, acesso a conversas, validação de compromisso e síntese de aprendizado.
• Tração: seleção de canais Bullseye, pesquisa de canais, testes baratos, revisões de experimentos e playbooks específicos por canal.
• Utilitários: desenvolvimento de templates Cookiecutter, operações de biblioteca Calibre e polimento de produto/lançamento.

Estrutura do Repositório

CONTEXT.md
skills/
  <skill-name>/
    SKILL.md
docs/
  installation.md
scripts/
  build-marketplaces.mjs
  build-registry.mjs
  skill-utils.mjs
  validate-marketplaces.mjs
  validate-skills.mjs
src/
  pages/
    index.astro
    catalog.json.js

Site do Catálogo

O site público do catálogo é um site estático Astro gerado a partir dos mesmos dados canônicos do repositório que os registros e manifestos de marketplace:

• skills/<skill-name>/SKILL.md
• scripts/skill-utils.mjs
• scripts/marketplace-utils.mjs
• agrupamentos de plugins de marketplace gerados

Execute o build completo do repositório para validar habilidades, atualizar artefatos de marketplace e gerar o site:

npm run build

A saída do Astro vai para site-dist/. O endpoint JSON gerado está disponível em /catalog.json, e as páginas de habilidades/plugins são geradas no momento do build.

Instalar uma Habilidade Diretamente

Use o CLI skills para instalar a partir deste repositório:

npx skills add LVTD-LLC/skills --skill django-htmx

Alvos comuns:

# Codex global skills
npx skills add LVTD-LLC/skills --skill django-htmx -g -a codex

# Claude Code global skills
npx skills add LVTD-LLC/skills --skill django-htmx -g -a claude-code

# OpenClaw global skills
npx skills add LVTD-LLC/skills --skill django-htmx -g -a openclaw

# Install from a local checkout
npx skills add . --skill django-htmx

Mais detalhes estão em docs/installation.md.

Instalação via Marketplace

Adicione o marketplace no Claude Code:

/plugin marketplace add LVTD-LLC/skills
/plugin install router@lvtd-skills
/plugin install django@lvtd-skills
/reload-plugins

O Claude Code expõe o roteador como /router:lvtd-skills-router. Os plugins de domínio expõem habilidades agrupadas, como /django:django-htmx, /django:django-q2 e as outras habilidades em cada plugin.

Adicione o marketplace no Codex:

codex plugin marketplace add LVTD-LLC/skills
codex plugin add router@lvtd-skills
codex plugin add django@lvtd-skills

O Codex expõe o roteador como $router:lvtd-skills-router. Os plugins de domínio expõem habilidades agrupadas, como $django:django-htmx, $django:django-q2 e as outras habilidades em cada plugin.

Para aplicar uma atualização de marketplace em um plugin Codex já instalado, atualize o snapshot do marketplace e reinstale o plugin:

codex plugin marketplace upgrade lvtd-skills
codex plugin remove django@lvtd-skills
codex plugin add django@lvtd-skills

Este repositório envia os arquivos de marketplace diretamente:

.claude-plugin/marketplace.json
.agents/plugins/marketplace.json
plugins/<plugin-name>/

As pastas de habilidades dos plugins são cópias geradas de skills/<skill-name>/, então instalações de marketplace com suporte a Git têm arquivos SKILL.md reais enquanto a fonte canônica permanece em skills/. Não edite cópias de plugins geradas diretamente.

Atualize os artefatos de marketplace gerados durante o desenvolvimento:

npm run build

IDs de plugins de marketplace gerados:

• b2b-sales
• cookiecutter
• customer-discovery
• developer-docs
• django
• eighty-twenty
• game-design
• game-geometry
• linkedin-writing
• nonfiction-book-writing
• router
• rust-core
• rust-game-development
• seo
• traction
• web-design-math

Os plugins de marketplace agrupam habilidades relacionadas. Instalações diretas pelo CLI skills ainda usam os nomes canônicos das pastas de habilidades.

Estratégia de Marketplace

Veja docs/marketplace-strategy.md para o plano baseado em pesquisa para publicar este catálogo em Codex, Claude Code, OpenClaw e outros clientes compatíveis com Agent Skills.

Atribuição

Este catálogo é construído a partir de orientação transformada e orientada a tarefas, em vez de texto-fonte copiado. Habilidades derivadas de livros parafraseiam ideias operacionais, mantêm rastreabilidade da fonte nos arquivos de habilidade relevantes quando útil, e não são material oficial dos autores, bibliotecas, ferramentas ou plataformas abaixo.

Livros principais e fontes de formato longo:

• Docs for Developers: An Engineer's Field Guide to Technical Writing por Jared Bhatti, Zachary Sarah Corleissen, Jen Lambourne, David Nunez e Heidi Waterhouse: pesquisa de público para documentação de desenvolvedores, planejamento, redação, edição, feedback, medição de qualidade, publicação, manutenção e arquitetura da informação.
• The Product Is Docs: Writing Technical Documentation in a Product Development Group por Christopher Gales e a Equipe de Documentação da Splunk: documentação em equipes de produto, integração Agile, pesquisa técnica, verificação técnica, feedback de clientes, colaboração com suporte e campo, documentação SaaS, ferramentas de documentação, manutenção, métricas de qualidade e seleção de plataforma.
• The Mom Test por Rob Fitzpatrick: conversas de descoberta de clientes, segmentação de fatias, acesso a conversas, validação de compromisso e anotações de aprendizado.
• Write Useful Books por Rob Fitzpatrick: planejamento de livros de não ficção úteis, experiência do leitor, feedback de beta, marketing inicial, otimização de vendas e padrões de produção de autopublicação.
• Traction: How Any Startup Can Achieve Explosive Customer Growth por Gabriel Weinberg e Justin Mares: seleção de canais Bullseye, metas de tração, testes baratos de canais, fluxos de revisão e playbooks específicos por canal.
• 80/20 Sales and Marketing por Perry Marshall: análise de lei de potência, seleção de mercado, estratégia de tráfego, mensagens de conversão, economia de funil, trabalho de USP/garantia, valor do cliente e alavancagem de tempo/equipe.
• Product-Led SEO por Eli Schwartz: estratégia de SEO orientada por produto, pesquisa de oportunidades, mapeamento persona-intenção, priorização de roadmap e triagem técnica de SEO.
• Ultimate Guide to Link Building por Garrett French e Eric Ward: estratégia de construção de links, ativos linkáveis, prospecção, qualificação de prospects, outreach, construção de links quebrados, posts de convidado e construção de links por patrocínio local.
• Growth Hacking LinkedIn por Bjorn Radde: escrita de posts no LinkedIn, ideação de conteúdo, escrita de comentários, escrita de artigos/newsletters e padrões de experimentação de posts.
• Zero to Production in Rust por Luca Palmieri: testes de APIs HTTP em Rust, limites de serviço SQLx/Postgres, padrões de serviços implantáveis, segurança, observabilidade, limites de domínio e fluxos de trabalho idempotentes.
• Programming Rust por Jim Blandy, Jason Orendorff e Leonora F. S. Tindall: ownership/borrowing em Rust, traits, iteradores/coleções, concorrência, design de tarefas async, limites unsafe e wrappers FFI.
• Hands-On Rust por Herbert Wolverson: planejamento de game slices em Rust, loops de jogo bracket-lib, mapas de tiles e câmeras, gameplay com ECS, sistemas de turno/intenção, geração procedural de roguelike e IA, conteúdo orientado a dados e polimento de release.

Fontes de formato curto e posts públicos:

• O post "32 Principles of a Viral Product" de Marc Lou no X inspirou make-product-viral.

Bibliotecas, ferramentas e documentação oficial referenciadas durante a criação das habilidades:

• Documentação e melhores práticas de Agent Skills, documentação de habilidades/plugins e marketplace de plugins do Claude Code, documentação de plugins do OpenAI Codex, documentação de habilidades/plugins do OpenClaw e o CLI skills.

• Django, HTMX, django-htmx, Alpine.js, django-q2, FastMCP, Cookiecutter, Calibre/calibredb, testes Django estilo pytest e ferramentas web Python relacionadas.

• Bibliotecas e ferramentas do ecossistema Rust usadas em orientações e exemplos, incluindo Actix, Axum, Tokio, SQLx, PostgreSQL, Docker, tracing, thiserror, anyhow, wiremock, fluxos de verificação com Cargo, bracket-lib, Legion, Bevy ECS, Serde e RON. Recursos de criação e revisão de skills:

• Skills auxiliares instaladas no projeto: ebook-analysis, skill-from-book, skill-creator, write-a-skill e pdf.

• Fluxos de trabalho do plugin Compound Engineering, incluindo execução de trabalho, histórico de sessão, revisão e orientações de entrega.

• Fluxos de trabalho do plugin Superpowers para planejamento, execução, verificação e disciplina de finalização de branch.

• O feedback de revisão do Greptile e o HOL Plugin Scanner foram usados como entradas de revisão e validação em partes do catálogo.

Desenvolvimento

Novos skills devem seguir docs/adding-skills.md.

Valide apenas os skills de origem:

npm run validate

Construa o registro legível por máquina e atualize os artefatos de marketplace confirmados:

npm run build

O registro é gravado em dist/registry.json. Os artefatos de marketplace são gravados em .claude-plugin/, .agents/plugins/ e plugins/.

Valide os artefatos de marketplace gerados:

npm run validate:marketplaces

Execute a verificação completa local/CI antes de abrir um PR:

npm run check

Publicação

A CI valida todo push e pull request. A publicação é orientada por tags:

1. Atualize a versão do catálogo em package.json.
2. Execute npm run check e confirme os artefatos de marketplace gerados.
3. Crie e envie uma tag v* correspondente, por exemplo v0.1.3.

A versão do catálogo em package.json também é a versão do plugin de marketplace gerado, portanto, as instalações do Codex usam um novo caminho de cache de plugin quando a versão muda. O fluxo de trabalho Publish empacota o registro e os tarballs do marketplace e os publica no release do GitHub para tags v* enviadas.