typescript-rules SKILL.md skillA

typescript-rules from shinpr/claude-code-workflows is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add shinpr/claude-code-workflows/typescript-rules@git:20260728.e9e235b

Pins git:20260728.e9e235b in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
shinpr/claude-code-workflows
Path
dev-workflows-frontend/skills/typescript-rules/SKILL.md
Versions recorded
5
Latest version
git:20260728.e9e235b, committed Jul 28, 2026
First version recorded
Jun 13, 2026
Size
7,055 bytes
Repository stars
707
License
MIT

React/TypeScript frontend development rules including type safety, component design, state management, and error handling. Use when implementing React components, TypeScript code, or frontend features.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# TypeScript Development Rules (Frontend)

## Comment Writing Rules

Code first: names and types carry meaning; a comment must add what code cannot, and one comment per decision is enough.

- Explain why a component memoizes, guards, or re-renders, not what the JSX renders.
- Record decisions and rationale; leave chronological history to version control.

## Type Safety

**Default Rule**: Prefer `unknown`, generics, or union types over `any`. Retain `any` only when an existing external, generated, or legacy public signature requires it, or when replacing it prevents the project type check from expressing a safe generic relationship. Record the declaration path or type-check result that proves the constraint. When a local adapter can preserve compatibility and expose a safer type within the user request or current task/design artifact, implement the adapter; otherwise confine `any` to the smallest adapter or public-signature boundary, document the reason, and validate untrusted data before it enters typed application code.

**Frontend Boundaries**

- React Props/State: use the declared application types.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add shinpr/claude-code-workflows/typescript-rules@sha256:132fcc9ed782ceca

The line at the top of this page pins the label git:20260728.e9e235b, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_3sypustgrur2g2wd.svg)](https://markdownregistry.com/a/art_3sypustgrur2g2wd)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Jun 13, 2026 and Jul 28, 2026, about one every 11 days.

versioncommittedcommitsizeaudit
git:20260728.e9e235b latest2026-07-28 e9e235b 7,055 BA view · diff
git:20260719.c411d522026-07-19 c411d52 13,668 BA view · diff
git:20260719.526b0d12026-07-19 526b0d1 13,499 BA view · diff
git:20260620.a5dc20a2026-06-20 a5dc20a 10,681 BA view · diff
git:20260613.a58eaf62026-06-13 a58eaf6 10,544 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (7055 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

shinpr/claude-code-workflows · 707 stars · license MIT · pushed 2026-10-29 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_3sypustgrur2g2wd
GET https://markdownregistry.com/api/v1/resolve?ref=shinpr/claude-code-workflows/typescript-rules
GET https://markdownregistry.com/api/v1/blob/132fcc9ed782ceca72c9898b0c3da9ad89b3a182652ae194097a2c41f3e7cd18

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from shinpr/claude-code-workflows

ai-development-guide SKILL.md skill
shinpr/claude-code-workflows · dev-skills/skills/ai-development-guide/SKILL.md · Applies language-agnostic and backend technical decision criteria, anti-pattern detection, debugging, and quality…
git:20261019.e544b5c · audit A · 707 stars
coding-principles SKILL.md skill
shinpr/claude-code-workflows · dev-skills/skills/coding-principles/SKILL.md · Language-agnostic coding principles for maintainability, readability, and quality. Use when implementing features…
git:20261019.e544b5c · audit A · 707 stars
documentation-criteria SKILL.md skill
shinpr/claude-code-workflows · dev-skills/skills/documentation-criteria/SKILL.md · Determines which of PRD, ADR, UI Spec, Design Doc, and Work Plan a change requires, and where each is stored. Use when…
git:20261029.3d4a3cd · audit A · 707 stars
external-resource-context SKILL.md skill
shinpr/claude-code-workflows · dev-skills/skills/external-resource-context/SKILL.md · Records where resources outside the repository live (design source, design system, API schema, IaC source, secret…
git:20261019.e544b5c · audit A · 707 stars
frontend-ai-guide SKILL.md skill
shinpr/claude-code-workflows · dev-skills/skills/frontend-ai-guide/SKILL.md · Applies React/TypeScript-specific technical decision criteria, anti-pattern detection, debugging, and frontend quality…
git:20261013.5482041 · audit A · 707 stars
implementation-approach SKILL.md skill
shinpr/claude-code-workflows · dev-skills/skills/implementation-approach/SKILL.md · Implementation strategy selection framework. Use when planning implementation strategy, selecting development approach…
git:20261013.5482041 · audit A · 707 stars
integration-e2e-testing SKILL.md skill
shinpr/claude-code-workflows · dev-skills/skills/integration-e2e-testing/SKILL.md · Defines integration/E2E skeleton annotations, lane and file contracts, and route-parity review criteria. Use when…
git:20261019.4d66b0c · audit A · 707 stars
llm-friendly-context SKILL.md skill
shinpr/claude-code-workflows · dev-skills/skills/llm-friendly-context/SKILL.md · Clarifies inputs, outputs, success criteria, decisions, and unresolved conditions so downstream consumers can execute…
git:20261019.de01f9e · audit A · 707 stars
requirement-convergence SKILL.md skill
shinpr/claude-code-workflows · dev-skills/skills/requirement-convergence/SKILL.md · Separates the outcome a change must produce from the requirements proposed to reach it, records what the user excluded…
git:20261029.29a1f7c · audit A · 707 stars
testing-principles SKILL.md skill
shinpr/claude-code-workflows · dev-skills/skills/testing-principles/SKILL.md · Language-agnostic testing principles for choosing which tests a change needs, test quality, and proof ownership, with…
git:20261019.4d66b0c · audit A · 707 stars
typescript-rules SKILL.md skill
shinpr/claude-code-workflows · dev-skills/skills/typescript-rules/SKILL.md · React/TypeScript frontend development rules including type safety, component design, state management, and error…
git:20260728.e9e235b · audit A · 707 stars
ai-development-guide SKILL.md skill
shinpr/claude-code-workflows · dev-workflows-frontend/skills/ai-development-guide/SKILL.md · Applies language-agnostic and backend technical decision criteria, anti-pattern detection, debugging, and quality…
git:20261019.e544b5c · audit A · 707 stars

Every file in shinpr/claude-code-workflows

Other files named typescript-rules

typescript-rules SKILL.md skill
shinpr/claude-code-workflows · dev-workflows-fullstack/skills/typescript-rules/SKILL.md · React/TypeScript frontend development rules including type safety, component design, state management, and error…
git:20260728.e9e235b · audit A · 707 stars
typescript-rules SKILL.md skill
shinpr/claude-code-workflows · skills/typescript-rules/SKILL.md · React/TypeScript frontend development rules including type safety, component design, state management, and error…
git:20260728.e9e235b · audit A · 707 stars
typescript-rules SKILL.md skill
shinpr/claude-code-workflows · dev-skills/skills/typescript-rules/SKILL.md · React/TypeScript frontend development rules including type safety, component design, state management, and error…
git:20260728.e9e235b · audit A · 707 stars
typescript-rules SKILL.md skill
shinpr/ai-coding-project-boilerplate · .claude/skills-en/typescript-rules/SKILL.md · Applies type safety and error handling rules. Enforces no-any policy and type guards. Use when implementing TypeScript…
git:20260719.191ec13 · audit A · 236 stars
typescript-rules SKILL.md skill
shinpr/ai-coding-project-boilerplate · .claude/skills-ja/typescript-rules/SKILL.md · 型安全性とエラーハンドリングルールを適用。any禁止、型ガード必須。TypeScript実装、型定義レビュー時に使用。
git:20260901.dd3607b · audit A · 236 stars
typescript-rules SKILL.md skill
shinpr/ai-coding-project-boilerplate · .claude/skills-zh-CN/typescript-rules/SKILL.md · 应用类型安全与错误处理规则。强制执行禁用 any 策略与类型守卫。在实现 TypeScript 或评审类型时使用。
git:20260831.b183037 · audit A · 236 stars

Browse by kind, by grade A, or by owner.