user-stories-craft

Golden Skills

Marketplace de skills para Claude Code — referências, patterns, arquitetura e boas práticas de engenharia de software.

---

Instalação

# 1. Adicione o marketplace
/plugin marketplace add XamuAvila/golden-skills

# 2. Liste os plugins disponíveis
/plugin search @golden-skills

# 3. Instale o plugin desejado
/plugin install <nome-do-plugin>@golden-skills

Clonando o repositório

Este repo usa git submodules para incluir skills oficiais da LangChain. Para clonar com todo o conteúdo:

git clone --recurse-submodules https://github.com/XamuAvila/golden-skills.git

# Se já clonou sem submodules:
git submodule update --init --recursive

---

Plugins Disponíveis

All-in-One

Plugin	Skills	Descrição
golden-suite	full-review	Orquestrador que combina TODAS as capabilities num único comando. Carrega referências sob demanda.

/plugin install golden-suite@golden-skills
/golden-suite:full-review

Recomendado para a maioria dos usuários. Instale apenas este plugin para ter acesso a Clean Code, Clean Architecture, System Architecture, Design Patterns (C#/TS), Impact Analysis e Prompt Architecture Review — tudo numa só skill.

---

C#/.NET

Plugin	Skills	Descrição
csharp-quality-suite	clean-code-csharp, clean-architecture-csharp, system-architecture	Suite completa de qualidade de software C#/.NET combinando Clean Code, Clean Architecture e System Architecture
design-patterns-csharp	design-patterns-csharp	22 Design Patterns (GoF) com exemplos em C#/.NET e diagramas Mermaid

TypeScript

Plugin	Skills	Descrição
design-patterns-typescript	design-patterns-typescript	22 Design Patterns (GoF) com exemplos em TypeScript e diagramas Mermaid

AI/LLM

Plugin	Skills	Descrição	Origem
langchain-skills	11 skills (LangGraph, LangChain, Deep Agents, RAG)	Skills oficiais para LangChain, LangGraph e Deep Agents	langchain-ai/langchain-skills (submodule)
langsmith-skills	langsmith-trace, langsmith-dataset, langsmith-evaluator	Skills oficiais para observabilidade e avaliação com LangSmith	langchain-ai/langsmith-skills (submodule)
prompt-architect	prompt-architecture-reviewer	Reviewer de arquitetura de prompts para produção OpenAI API (GPT-4o, o1/o3, GPT-4.1, mini, fine-tuned)	Próprio

Engenharia de Software

Plugin	Skills	Descrição
impact-analysis	impact-analysis	Análise de impacto pré-implementação com busca semântica, diagramas Mermaid e checklist de riscos

---

Detalhamento dos Plugins

csharp-quality-suite

Suite unificada com 3 skills complementares para qualidade de software em C#/.NET:

/csharp-quality-suite:clean-code-csharp Advisor de qualidade de código baseado nos princípios de Clean Code de Robert C. Martin. Identifica code smells, sugere refatorações e ensina práticas de código limpo com exemplos concretos em C#.

• Catálogo completo de code smells e heurísticas
• Guia de princípios: naming, funções, classes, comentários, error handling, formatação e testes
• Classificação por severidade: Critical, Major, Minor, Suggestion
• Adaptações específicas para C# (LINQ, async/await, pattern matching, records, nullable)

/csharp-quality-suite:clean-architecture-csharp Advisor de arquitetura baseado nos princípios de Clean Architecture de Robert C. Martin. Orienta sobre estrutura de projetos, direção de dependências, boundaries e design de componentes.

• SOLID no nível arquitetural (SRP como Common Closure Principle, DIP entre camadas)
• Dependency Rule e camadas (Entities, Use Cases, Adapters, Frameworks & Drivers)
• Implementação prática em .NET: project structure, interfaces, dependency injection
• Orientação pragmática — escala a arquitetura para o tamanho do problema

/csharp-quality-suite:system-architecture Guia completo de arquitetura de sistemas com 11 capítulos:

1. System Architecture — fundamentos e princípios
2. API Design Patterns — padrões de design de APIs
3. System Architecture Diagram — diagramas de arquitetura
4. Application Dependency Mapping — mapeamento de dependências
5. Multi-Cloud Architecture — arquitetura multi-cloud
6. Technical Debt Examples — exemplos de dívida técnica
7. Platform Engineering — engenharia de plataforma
8. Application Architecture Diagram — diagramas de aplicação
9. Software Design Document Template — templates de documentação
10. Web Application Architecture — arquitetura web
11. Legacy Application Modernization — modernização de legado