Skill: typescript - Advanced TypeScript Architecture

Purpose

Deliver expert TypeScript guidance focused on expressive types, strict compiler configuration, and safe API design.

File Structure

forge-plugin/skills/typescript/ ├── SKILL.md └── examples.md

Interface References

• Context: Load guidance via ContextProvider Interface

• Memory: Store project knowledge via MemoryStore Interface

• Output: Save reports to /claudedocs/ using OUTPUT_CONVENTIONS.md

Mandatory Workflow

Step 1: Initial Analysis

• Identify TypeScript version, build pipeline, and project scope

• Review tsconfig strictness, module resolution, and emit targets

• Capture API surface areas and typing pain points

Step 2: Load Memory

• Use memoryStore.getSkillMemory("typescript", "{project-name}") to load conventions

• Review cross-skill notes via memoryStore.getByProject("{project-name}")

Step 3: Load Context

• Use contextProvider.getDomainIndex("engineering") to select relevant guidance

• Load only the context files required for the task

Step 4: Perform Analysis

• Evaluate advanced type usage (conditional, mapped, template literal types)

• Assess API boundaries, generics, and inference ergonomics

• Identify unsafe any , type assertion hotspots, and strictness gaps

• Provide migration guidance for incremental typing improvements

Step 5: Generate Output

• Deliver type strategy recommendations and code examples

• Save the report to /claudedocs/typescript_{project}_{YYYY-MM-DD}.md following OUTPUT_CONVENTIONS

Step 6: Update Memory

• Record tsconfig decisions, type patterns, and migration status

• Update memory with memoryStore.update("typescript", "{project-name}", ...)

Compliance Checklist

• Step 1 captured TypeScript version and tsconfig scope

• Step 2 loaded project memory via MemoryStore

• Step 3 loaded relevant context via ContextProvider

• Step 4 analysis covered typing, APIs, and strictness

• Step 5 output saved to /claudedocs/ with correct naming

• Step 6 memory updated with new insights

Version History

Version Date Changes

1.0.0 2026-02-12 Initial release