mcpField
S
specsfy-specialist-typescript

specsfy-specialist-typescript

github.com/promovawebDevelopment87312 installsUpdated 1w ago
Repository

About specsfy-specialist-typescript

A TypeScript skill for developers working in existing codebases and libraries. It emphasizes sound type modeling, runtime validation of external data, and checks against the project's actual build targets.

Key features

  1. 01Inspect project configuration and runtime
  2. 02Model valid states with unions
  3. 03Validate untrusted data at runtime
  4. 04Avoid unjustified casts and any
  5. 05Run type, test, lint, and build checks

Use cases

  1. 01Review types at public API boundaries
  2. 02Validate data received from external sources
  3. 03Check compatibility across build targets
  4. 04Investigate type inference regressions

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/promovaweb/specsfy --skill specsfy-specialist-typescript

After installing, type/specsfy-specialist-typescriptin Claude Code to confirm it loaded.

Bundled filesagents/openai.yamlreferences/standards.md

Details

From the project README

TypeScript

Fluxo

  1. Ler tsconfig, package type, bundler, runtime e versões.
  2. Identificar fronteiras não confiáveis e tipos públicos.
  3. Modelar estados válidos com unions, narrowing e invariantes.
  4. Inferir internamente e anotar APIs onde o contrato precisa ser estável.
  5. Eliminar any, assertions e ! injustificados na área alterada.
  6. Validar dados externos em runtime antes de tipá-los.
  7. Rodar typecheck, testes, lint e build nos targets reais.

Padrões

  • Ativar opções strict compatíveis e corrigir erros sem casts cosméticos.
  • Preferir unions discriminadas a combinações inválidas de booleanos.
  • Usar unknown em fronteiras e narrowing explícito.
  • Manter generics mínimos e vinculados a relações reais entre valores.
  • Evitar enums quando objetos literais ou unions preservam interoperabilidade.
  • Separar type-only imports e respeitar ESM/CJS do projeto.
  • Testar tipos públicos quando regressões de inferência forem relevantes.

Validação

  • Typecheck sem emissão e build de todos os targets.
  • Testes runtime das validações e serialização.
  • API declarations quando biblioteca; compatibilidade de consumers.
  • Busca focal por suppressions, casts duplos e tipos duplicados.

Leia references/standards.md para modelagem, configuração, módulos, bibliotecas e validação runtime.

Comments

Markdown supported