Agent skill · Dev tools · mcollina

typescript-magician agent skill by mcollina

Designs complex generic types, refactors any types to strict alternatives, creates type guards and utility types, and resolves TypeScript compiler errors.

View on GitHub Read SKILL.md

At a glance

Publisher	mcollina
Repository	mcollina/skills (11 listed skills)
Category	Developer Tools and Frameworks
License	MIT
Last commit	October 18, 2026 (repository)
SKILL.md	110 lines, 488 words
Bundled files	16 files
Quality score	77/100 · C Passes all seven graded checks
Security scan	Not scanned
README badge	Get the listing badge and raise the score

Before you install

Read from the skill's files at the directory's October 19, 2026 snapshot: what ships with it, what its code reads, and the terms it is published under.

Bundled scripts: none.
License: MIT, an open-source or open-content license.

Install typescript-magician

The skills CLI works with Claude Code, Codex, Cursor and other agents; the other routes copy the folder by hand.

Skills CLI

npx skills add https://github.com/mcollina/skills/tree/main/skills/typescript-magician

Claude Code, project-level copy

tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/mcollina/skills.git "$tmp/repo"
mkdir -p .claude/skills
cp -R "$tmp/repo/"skills/typescript-magician .claude/skills/
rm -rf "$tmp"

Codex installer

python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
    --repo mcollina/skills \
    --path skills/typescript-magician

mcollina/skills is third-party code. Read SKILL.md and any bundled scripts before you install it.

How the author describes it

Designs complex generic types, refactors `any` types to strict alternatives, creates type guards and utility types, and resolves TypeScript compiler errors. Use when the user asks about TypeScript (TS) types, generics, type inference, type guards, removing `any` types, strict typing, type errors, `infer`, `extends`, conditional types, mapped types, template literal types, branded/opaque types, or utility types like `Partial`, `Record`, `ReturnType`, and `Awaited`.

From the description field of SKILL.md. Agents read this line to decide when to load the skill.

Sections in SKILL.md

When to use
Instructions
Quick Examples
Eliminating any with generics
Narrowing an unknown API response
Reference
Core Patterns
Advanced Generics
Type-Level Programming
Type Safety Patterns
Debugging

Files in the skill folder

SKILL.md
rules/array-index-access.md
rules/as-const-typeof.md
rules/builder-pattern.md
rules/conditional-types.md
rules/deep-inference.md
rules/error-diagnosis.md
rules/function-overloads.md
rules/generics-basics.md
rules/infer-keyword.md
rules/mapped-types.md
rules/opaque-types.md
rules/template-literal-types.md
rules/type-narrowing.md
rules/utility-types.md
tile.json

Suede Skill Check: 77/100 · C

Report snapshot · October 19, 2026 · graded-v2

The rubric totals 100 points; published scores are capped at 99. Security scan: not scanned.

Source revision: c75d70dbfbe9. Report version 74ca08164693. Badge URLs follow the latest listing; save the report to keep this version.

Download report · Request a fresh review

What to review next

Boundary clause: 0 of 4 points. 4 when the description says when not to use the skill (“Not for …”, “Do not use …”, “Use … instead”).
Example request: 0 of 3 points. 3 when the description quotes an example request (3–60 characters in quotation marks).
Instruction depth: 4 of 7 points. 7 for a SKILL.md body of 500–3,000 words; 4 for 250–4,500; 1 for 100 or more.

Add declarations and bundled files when they describe the skill’s actual needs. Update the source, then request a fresh review with the changed commit or PR.

typescript-magician passes the required frontmatter check and all seven graded checks, which cover the SKILL.md format, a declared license and a commit in the last year. Those checks earn 56 of the score’s points; the rest come from description quality, instruction depth, bundled files, maintenance and curated-list citations. How the score works.

See the checks and points

Check	Result
Frontmatter parses and declares a name and a description	Pass
Name uses lowercase letters, digits and hyphens, 64 characters or fewer	Pass
Name matches the skill's folder name	Pass
Description is between 50 and 1,024 characters	Pass
Description says when an agent should use the skill	Pass
SKILL.md body is 500 lines or fewer	Pass
A license is declared in the frontmatter or the repository	Pass
Repository has a commit in the last 12 months	Pass

Score component	Points
Structural checks	56 of 56
Description length	5 of 5
Boundary clause	0 of 4
Example request	0 of 3
Instruction depth	4 of 7
Reference files	0 of 3
Bundled scripts	0 of 2
Recent maintenance	9 of 9
Curated-list citations	3 of 7
Tool permissions declared	0 of 2
Compatibility declared	0 of 2

Show the listing and raise the score

typescript-magician is listed with 77/100 · C. This badge links to its Suede listing. Skills scoring 80–99 add a numeric and a letter quality shield; the largest open points for typescript-magician are boundary clause (4), example request (3) and instruction depth (3). Send your repository and the points you want to raise, then request a fresh review after updating the skill.

Markdown

[![Suede Skills Directory: listed](https://skills.suedeai.ai/directory/badge.svg)](https://skills.suedeai.ai/directory/mcollina/skills/typescript-magician/)

HTML

<a href="https://skills.suedeai.ai/directory/mcollina/skills/typescript-magician/"><img src="https://skills.suedeai.ai/directory/badge.svg" alt="Suede Skills Directory: listed" height="20"></a>