Communitygithub.com

Geruyang/agent-skills-library

Use ao dimensionar posições de investimento em ações, encontrar hedges para ações ou construir um plano integrado de posição e hedge a partir de uma tese de ações listadas. Não use para construção de teses, subscrição de eventos isolados, execução de negociações, aconselhamento de investimento pessoal ou risco de instrumentos de crédito.

O que é agent-skills-library?

Esta skill é projetada para transformar uma visão de investimento em ações listadas em uma postura de risco acionável. Ela lida com dimensionamento de posições (long e short), design de hedges (incluindo opções, futuros, índices e pares) e planos integrados de risco que reconciliam tamanho e proteção. A skill suporta modos distintos: `position_sizing` (para determinar quanto comprar ou vender), `hedge_design` (para avaliar e selecionar instrumentos de hedge) e `integrated_risk_plan` (para combinar ambos em uma recomendação coesa). É particularmente útil para gestores de portfólio de ações, fundos long-short, pares market-neutral, estratégias event-driven e gestores de ETFs/índices. A skill enfatiza restrições reais (liquidez, custos de tomada de empréstimo, orçamentos de perda) e fornece um fluxo de trabalho estruturado que inclui mapeamento de exposições, análise de cenários, verificação de viabilidade e regras de monitoramento. Para entregas substanciais, ela gera relatórios HTML independentes e refinados, em vez de dashboards padronizados, a menos que explicitamente solicitado. Ela também define limites claros com mercados de crédito, usando spreads de crédito apenas como sinais de risco para ações, e não para recomendações de hedge de crédito.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Geruyang/agent-skills-library/tree/HEAD/original-skills/x-openai-portfolio-risk-management-e45bdc5

Perguntar na sua IA favorita

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

Documentação

Gerenciamento de Risco de Portfólio

Configuração da Skill

Instruções Comuns da Skill

OBRIGATÓRIO: Antes de pesquisar conectores, recuperar evidências ou elaborar saídas, leia e aplique o contrato de runtime compartilhado em ../public-equity-investing/SKILL.md## Cross-Skill Runtime Contract. Em seguida, verifique o mapa de skills do roteador e ../../shared/plugin-routing-playbook.md para skills adjacentes que devem ser sequenciadas com este fluxo de trabalho. Não execute configuração ou inspeção de contexto do usuário durante o trabalho de fluxo normal; direcione apenas solicitações explícitas de contexto salvo, configuração de fonte, integração ou configuração de automação para ../user-context/SKILL.md.

Resolução de Fontes

Carregue ../../shared/workflow-source-resolution.md. Resolva apenas as categorias necessárias para este fluxo de trabalho: internal_research, portfolio_models_trackers e market_data_estimates. Use o contrato de runtime compartilhado para mapear cada categoria tentada para um aplicativo, conector, arquivo, exportação ou entrada fornecida pelo usuário disponível.

Categorias de Dependência Relevantes

Estas são as categorias de fonte com maior probabilidade de importar para este fluxo de trabalho. Use o contrato do roteador para resolver apenas as categorias que a tarefa realmente precisa, prefira fontes nomeadas pelo usuário primeiro e declare qualquer limitação material de fonte.

  • Modelos e Rastreadores de Portfólio
  • Dados de Mercado e Estimativas
  • Pesquisa Interna

Suporte Interno

Quando este fluxo de trabalho precisar de renderização, preparação de evidências/dados, estilo ou contexto setorial, direcione o suporte através do roteador visível public-equity-investing e seus playbooks internos agrupados. Direcione a QA de planilhas ou modelos através do fluxo de trabalho visível model-audit-tieout.

Intake de Entregáveis

Antes da coleta de fontes ou análise para uma nova entrega principal substantiva, carregue ../../shared/deliverable-intake-policy.md e use seu request_user_input adaptativo para verificação prévia de escolhas de formato, profundidade, público/uso ou foco materialmente não resolvidas. Para um plano integrado substantivo de posição e hedge ou solicitação explícita de plano de risco HTML, o padrão resolve a superfície de apresentação para um relatório de decisão de risco HTML independente e refinado, a menos que o usuário solicite outra superfície, uma resposta rápida/sem arquivo, saída de planilha ou um dashboard padronizado. Reutilize preferências resolvidas nas etapas posteriores; ao atuar apenas como entrada para um fluxo de trabalho proprietário, não re-solicite.

Propósito

Transformar uma visão de investimento em ações listadas em uma postura de risco implementável: o tamanho certo, qualquer hedge apropriado, a exposição intencionalmente retida e as regras para redimensionar ou remover proteção. Esta skill é responsável por posições compradas em ações, posições vendidas em ações, pares de negociação, ETFs/constituintes de índices, opções listadas, hedges de fatores de ações, overlays de futuros/índices e proxies macro quando a decisão permanece uma decisão de ações listadas.

Não trate dimensionamento e hedge como respostas independentes quando um altera o outro. Dimensione a partir da restrição crível mais restrita; faça hedge apenas de riscos que podem ser reduzidos sem destruir o alfa pretendido. Um resultado de redução de tamanho/sem hedge é válido quando o risco de base do hedge, custo, liquidez ou complexidade é pior do que a exposição indesejada.

Para um pacote de risco reutilizável e substantivo, produza um relatório de decisão de risco HTML independente e refinado seguindo ../../shared/html-artifact-standard.md; retenha os pontos fortes da folha de decisão estruturada de tabelas de dimensionamento, comparações de hedge, cenários e gatilhos de monitoramento sem forçar um shell de dashboard padronizado. Use dashboard-builder apenas quando o usuário solicitar explicitamente um dashboard padronizado, dashboard de monitoramento recorrente, modelo validado reutilizável ou renderização orientada por payload estruturado.

Seleção de Modo

Inferir o modo a partir da decisão solicitada e do contexto disponível:

ModoUse quandoSaída principal
position_sizingO usuário pergunta quanto comprar ou vender, limites de adicionar/reduzir/sair, orçamentos de perda, capacidade de liquidez ou impacto na exposição do portfólio.Tamanho recomendado, restrição vinculante, P&L de cenário, saída de liquidez, regras de monitoramento.
hedge_designO usuário pergunta como fazer hedge, neutralizar, proteger, des-beta, classificar candidatos a hedge ou comparar instrumentos de hedge.Objetivo do hedge, conjunto de candidatos, livro-razão de risco de base, método de dimensionamento, verificações de prontidão, regras de saída.
integrated_risk_planO usuário solicita tanto o tamanho da posição quanto o hedge, ou a escolha do hedge pode alterar materialmente o tamanho recomendado.Comparação sem hedge versus com hedge/redução de tamanho, pacote recomendado, exposição retida, regras de ação.

Não peça ao usuário para escolher um modo quando o prompt ou artefato fornecido torna a decisão clara. Faça um esclarecimento direcionado apenas quando selecionar o modo errado alteraria materialmente o entregável, como uma solicitação ambígua para "gerenciar risco" sem uma posição declarada, exposição indesejada ou ação solicitada.

Lente de PM/Risco de Ações Listadas

Carregue ../../shared/pm-judgment-heuristics.md e ../../shared/credit-markets-handoff.md antes de produzir uma recomendação de risco substancial.

Modos de público:

  • long_only_pm: enfatize peso ativo do benchmark, tracking error, liquidez/capacidade, tolerância a drawdown, disciplina de adicionar/reduzir e papel no portfólio.
  • long_short_hf: enfatize impacto bruto/líquido/beta/fator, tomada de empréstimo, risco de short squeeze, caminho do catalisador, adequação do hedge e regras de cobrir/redimensionar.
  • market_neutral_pairs_pm: enfatize dimensionamento das pernas, neutralidade beta/fator/driver, risco de spread residual, tomada de empréstimo e liquidez.
  • event_driven_equity_pm: enfatize gap adverso, atraso de tempo, resultados ponderados por probabilidade, liquidez de opções/tomada de empréstimo e slippage de evento.
  • etf_index_benchmark_pm: enfatize peso do constituinte, peso ativo, exposição a fluxo de ETF/índice, risco de rebalanceamento, liquidez e impacto no tracking error.

Cada saída substantiva deve declarar alfa pretendido, risco indesejado, exposição retida, restrição vinculante, postura de liquidez/saída, trade-off de hedge ou redução de tamanho, gatilhos de monitoramento, prontidão de implementação e evidências ausentes que poderiam mudar a decisão. Inclua risco de base e um cenário de falha de hedge sempre que a proteção for proposta.

Limite com Mercados de Crédito

Esta skill pode usar níveis de CDS, spreads de crédito, ratings, vencimentos de dívida, pressão de refinanciamento, manchetes de covenants ou estresse de liquidez apenas como sinais de queda para ações.

Use CDS/spreads apenas como contexto de risco para ações. Níveis de CDS e spreads de crédito podem aparecer apenas como sinais de risco de ações ou contexto de queda de ações; nunca os trate como uma implementação de hedge de propriedade local.

Use Mercados de Crédito para CDS, títulos, empréstimos, spread DV01/CS01, hedges de spread de crédito, hedges de estrutura de capital, hedges de distressed, waterfalls de recuperação, análise de covenants ou hedges de covenants, dimensionamento de títulos de dívida e valor relativo de títulos de crédito. Não apresente um instrumento de crédito como uma recomendação de hedge local.

Não Use

  • Tese, percepção variante ou construção de pitch: use long-short-pitch ou memo-builder.
  • Subscrição de probabilidade e payoff de eventos datados: use event-driven-analyzer.
  • Mapeamento de transmissão macro/econômica: use economic-impact-report.
  • Calendário de catalisadores ou trabalho apenas de monitoramento: use catalyst-calendar ou thesis-tracker.
  • Aconselhamento de investimento pessoal, execução de negociação ou conclusões legais/de compliance.

Modos de Contexto

ContextoComportamento padrão
Sem contextoSolicite o título/exposição, ação desejada, horizonte, restrições e dados disponíveis; forneça um quadro de intake utilizável sem inventar uma recomendação.
Contexto parcialProduza uma triagem de risco condicional ou plano integrado de nível de triagem com suposições explícitas e verificações de dados ausentes; não recomende início quando as entradas de implementação necessárias estiverem ausentes.
Fonte completaNormalize as entradas, concilie fontes, execute cenários e produza orientação de risco pronta para decisão.
Revisão ou atualizaçãoPreserve o trabalho anterior, identifique entradas desatualizadas e exposições ocultas e mostre o que altera o tamanho ou o hedge.

Fluxo de Trabalho

  1. Definir a decisão. Capture título, direção, tamanho atual/proposto, exposição da tese a reter, risco indesejado, preço/data de referência, horizonte/catalisador, contexto do portfólio, limites de mandato, liquidez e ação solicitada.
  2. Resolver a interpretação do orçamento de perda. Distinga um orçamento de perda de cenário, que restringe a perda sob um movimento adverso declarado, de um limite de perda absoluto, que deve permanecer satisfeito mesmo que a ação se mova além desse cenário. Quando o usuário fornece um limite de perda para uma posição vendida mas não diz qual interpretação se aplica, faça um esclarecimento direcionado em uma execução interativa. Em uma execução não interativa, mostre ambos os ramos e não transforme silenciosamente uma magnitude de squeeze assumida em uma recomendação de início. Para uma posição vendida com um limite absoluto, exija proteção de perda definida precificada ou recomende nenhuma posição.
  3. Mapear exposições. Separe exposições idiossincráticas, de evento e de fator/macro escolhidas intencionalmente de risco indesejado de beta, setor, fator, FX, commodity, liquidez, tomada de empréstimo, financiamento, crowding, gap e concentração de portfólio.
  4. Construir casos de risco. Estime resultados de alta/base/baixa/estresse, retorno ponderado por probabilidade quando suportável, P&L de cenário, implicações de liquidez/saída e qualquer caso de falha de hedge. Rotule magnitudes de estresse assumidas como ilustrativas até serem confirmadas pelo usuário ou por uma política de risco vigente.
  5. Aplicar o modo selecionado.
    • Para position_sizing, triangule restrições de orçamento de perda, volatilidade, liquidez, limite de exposição, benchmark/fator, tomada de empréstimo/squeeze, catalisador e ajuste ao portfólio; recomende o tamanho crível mais restritivo.
    • Para hedge_design, classifique exposições como manter, fazer hedge, reduzir ou monitorar; avalie alternativas de ações diretas, ETF/índice, fator, par, opção listada, futuros/índice, proxy macro causal, overlay de portfólio e sem hedge/redução de tamanho.
    • Para integrated_risk_plan, compare resultados de tamanho sem hedge, tamanho com hedge e redução de tamanho/sem hedge; recomende o pacote com o alfa retido mais claro e custo/risco de base aceitável.
  6. Avaliar viabilidade. Declare atualização dos dados de mercado, ADV/dias de saída, restrições de tomada de empréstimo/recall/squeeze, cadeia de opções/Greeks quando relevante, custo/carry, risco de base, verificações de mandato/compliance e lacunas de prontidão de implementação. Para uma recomendação de venda, cotação executável atual, capacidade ADV/saída, termos de locate/tomada de empréstimo e entradas atuais de squeeze/crowding são necessárias antes de usar initiate ou outra linguagem de prontidão para implementação; termos de opções ao vivo são adicionalmente necessários antes de recomendar um hedge de opções.
  7. Recomendar e monitorar. Se as entradas de implementação estiverem ausentes, rotule o resultado como Triagem de risco condicional ou Não pronto para implementação e declare o tamanho/pacote condicional em vez de instruir o início. Caso contrário, declare o tamanho e/ou hedge recomendado, ação, restrição vinculante, exposição retida, alternativa rejeitada quando material, gatilhos de adicionar/reduzir/sair/cobrir/redimensionar/rolar/remover, confiança e evidências ausentes.
  8. Renderizar e inspecionar quando HTML for entregue. Em um relatório HTML independente, coloque no início uma tabela compacta de interpretação de restrições, ação condicional ou executável, trade-off de hedge e entradas ausentes antes da entrada. Mantenha as citações legíveis: não fragmente tickers, datas, porcentagens, valores em pontos-base, termos de instrumentos como GLP-1 ou rótulos de cenário com links inline. Para um arquivo HTML local, inspecione a viewport inicial e as seções posteriores críticas para a decisão com capturas de tela locais de navegador headless em vez do plugin Browser no aplicativo.

Mapa de Referência

Carregue apenas as referências necessárias para o modo selecionado:

  • Todos os modos substantivos: references/source-and-context-protocol.md, references/exposure-and-factor-risk.md e references/liquidity-drawdown-scenarios.md.
  • position_sizing: references/sizing-framework.md, references/strategy-nuance.md, references/position-sizing-output-templates.md e references/quality-control.md.
  • hedge_design: references/hedge-workflow.md, references/instrument-playbooks.md, references/hedge-output-templates.md e references/hedge-scorecard-schema.md.
  • integrated_risk_plan: as referências de dimensionamento e hedge necessárias para o pacote recomendado; evite carregar playbooks de instrumentos não utilizados.
  • Entregáveis HTML independentes: ../../shared/html-artifact-standard.md e o template de saída do modo selecionado.
  • Entregáveis de dashboard padronizado explícitos: references/DASHBOARD_PACK.md.

Scripts Determinísticos

Use helpers agrupados quando entradas estruturadas são fornecidas ou o usuário solicita templates/arquivos:

python scripts/create_position_sizing_templates.py --out path/to/templates
python scripts/position_sizing_calculator.py --input path/to/input.json --out path/to/outputs
python scripts/score_hedge_candidates.py hedge_candidates.csv --output-dir path/to/outputs

Os helpers de dimensionamento escrevem arquivos de suporte de cálculo/auditoria transparentes, incluindo position_summary.csv, sizing_cases.csv, scenario_pnl.csv, exposure_impact.csv, liquidity_exit.csv, monitoring_rules.csv, support_note.md, run_log.json e manifest.json. O helper de hedge escreve hedge_scorecard_support_note.md, hedge_scorecard.csv, hedge_scorecard.json e basis_risk_ledger.csv.

Esses helpers não buscam dados ao vivo, executam sistemas de risco de portfólio, satisfazem verificações de compliance ou substituem o julgamento do PM. Arquivos CSV, Markdown, JSON, run-log e manifest são artefatos de suporte, a menos que o usuário solicite explicitamente esses formatos. Para pacotes reutilizáveis substanciais, lidere com um relatório de decisão de risco HTML independente e refinado, a menos que o usuário solicite explicitamente um dashboard padronizado.

Handoff de Dashboard

Se o usuário solicitar explicitamente um dashboard padronizado ou recorrente, use references/DASHBOARD_PACK.md. portfolio-risk-management é responsável pelo tamanho, hedge, exposição retida, restrição vinculante, risco de base, cenário, liquidez e julgamento de monitoramento; dashboard-builder é responsável pela renderização e validação. Construa um `public_equity_investing_dashbo...

Individual skills in this repo

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

Geruyang/agent-skills-library

Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.

Geruyang/agent-skills-library

Set up Tailwind CSS v4 in Expo with react-native-css and NativeWind v5 for universal styling

Geruyang/agent-skills-library

Use for new frontend applications, dashboards, games, creative websites, hero sections, and visually driven UI from scratch, or when the user explicitly asks for a redesign/restyle/modernization. Builds from clean, airy, high-taste, readable image-generated concept design with section-specific references, faithful implementation, and browser testing.

Geruyang/agent-skills-library

Use when testing, debugging, or making targeted improvements to rendered frontend apps through the Build Web Apps or web dev plugin: local dev servers, UI regressions, interaction bugs, console errors, responsive layout, and visual QA. Check whether the Browser plugin is available and use it first when it is; otherwise use regular Playwright with the recorded reason.

Geruyang/agent-skills-library

Design UI surfaces for browser games. Use when the user asks for HUDs, menus, overlays, responsive layouts, or visual direction that must protect the playfield.

Geruyang/agent-skills-library

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

Geruyang/agent-skills-library

Guide for building, configuring, and deploying microfrontends on Vercel. Use this skill when the user mentions microfrontends, multi-zones, splitting an app across teams, independent deployments, cross-app routing, incremental migration, composing multiple frontends under one domain, microfrontends.json, @vercel/microfrontends, the microfrontends local proxy, or path-based routing between Vercel projects. Also use when the user asks about shared layouts across projects, navigation between microfrontends, fallback environments, asset prefixes, or feature flag controlled routing.

Geruyang/agent-skills-library

Next.js App Router expert guidance. Use when building, debugging, or architecting Next.js applications — routing, Server Components, Server Actions, Cache Components, layouts, middleware/proxy, data fetching, rendering strategies, and deployment on Vercel.

Geruyang/agent-skills-library

Integrate data visualizations into React and Next.js applications. Use when the user needs chart components, UML-like or architecture diagram components, React integration patterns, Next.js client or server boundaries, hydration-safe rendering, lazy loading, framework-aware performance, scroll-driven visual stories, or export guidance.

Geruyang/agent-skills-library

shadcn/ui expert guidance — CLI, component installation, composition patterns, custom registries, theming, Tailwind CSS integration, and high-quality interface design. Use when initializing shadcn, adding components, composing product UI, building custom registries, configuring themes, or troubleshooting component issues.

Geruyang/agent-skills-library

v0 by Vercel expert guidance. Use when discussing AI code generation, generating UI components from prompts, v0 CLI usage, v0 SDK/API integration, or integrating v0 into development workflows with GitHub and Vercel deployment.

Geruyang/agent-skills-library

Manages shadcn components and projects — adding, searching, fixing, debugging, styling, and composing UI. Provides project context, component docs, and usage examples. Applies when working with shadcn/ui, component registries, presets, --preset codes, or any project with a components.json file. Also triggers for "shadcn init", "create an app with --preset", or "switch to --preset".

Habilidades Relacionadas